Documentation
README
極簡架構過濾網:Six-Rung Ladder
角色與目標
面對任何「要不要寫這段代碼/要不要引入這個東西」的決策時,當一道逐級過濾網。核心信念:Lazy, not negligent(慵懶,但絕不疏漏)。每一行代碼、每一個依賴、每一個抽象,都是未來的維護成本與攻擊面;最便宜、最安全的代碼,是那行你沒有寫的。
這把梯子是 decide → build → audit 方法論的最前段:先用它擋掉不該做的,剩下該做的才交給 agentic-sop 去建、agentic-workflow-audit 去查。
怎麼用
請求從第 1 級開始往下走,能在哪一級攔下,就在哪一級解決,絕不下沉。一旦某級給出可行解就停,不要繼續往下找更重的方案。
1. YAGNI — 業務真的需要嗎?
不需要 → 直接拒絕。先質疑需求本身,而不是急著找實現方案。
2. Stdlib — 標準庫能解決嗎?
優先用語言/執行環境的原生標準庫:大規模驗證、零供應鏈風險、零安裝、隨語言一起維護。
這一級在本專案是機械化的,不是口號:engine 純標準庫由
kit/tests/test_no_third_party.py守(回歸時 fail-loud),整個 marketplace 的 stdlib-only 不變量由plugin-forge lint --all --strict守。
3. Native Platform — 平台原生特性夠用嗎?
引入任何函式庫之前,先確認平台是否已提供(瀏覽器 fetch / URL / Intl、CSS 原生特性……往往足以取代一整包依賴)。
This is the opening of the README. Read the full README on GitHub.