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。