adr-skill

ADRs created with this skill are executable specifications for coding agents. A human approves the decision; an agent implements it. The ADR must contain everything the agent needs to write correct code without asking follow-up questions.

When in doubt: if a future agent working in this codebase would benefit from knowing why this choice was made, write the ADR.

If you are an agent coding in a repo and you encounter any of these situations, stop and propose an ADR before continuing:

建立和維護針對代理程式編碼工作流程最佳化的架構決策記錄 (ADR)。當您需要提議、撰寫、更新、接受/拒絕、棄用或取代 ADR 時使用；引導 adr 資料夾和索引；在實施變更之前諮詢現有的 ADR；或強制執行 ADR 約定。該技能在起草之前使用蘇格拉底式提問來捕獲意圖，並根據代理準備清單驗證輸出。 來源：joelhooks/joelclaw。