SkillPedia Skills Encyclopedia
中文 EN

技能 2026-02-13 18:29 UTC

adr-skill

由提交人 joelhooks 提交,主要更新类型为:常规更新与维护。提交说明:ADRs as executable specifications for coding agents。对项目做了常规维护与小幅调整。

joelhooks 2fc2269 skillrecordings/adr-skill

Commit提交信息原文

ADRs as executable specifications for coding agents

The core shift: ADRs are now work orders, not just decision records.
An agent should be able to read an ADR and start implementing immediately.

Templates:
- Add Implementation Plan section to both templates (affected paths,
  dependencies, patterns to follow/avoid, config changes, migration steps)
- Replace prose Confirmation with structured Verification checkboxes
  that an agent can programmatically validate

Skill workflow:
- Add proactive ADR triggers: agents recognize mid-coding when they're
  making an ADR-worthy decision and stop to propose one
- Add Code ↔ ADR bidirectional linking convention (ADRs name files they
  govern, code comments reference ADRs back with // ADR-NNNN)
- Phase 0 now checks for ADR references in code comments
- Phase 1 question 8 now explicitly asks about implementation details
- Intent summary gate includes affected files and verification criteria

Review checklist:
- Add Implementation Plan checks (are paths specific? are patterns
  referenced to real code? are dependencies versioned?)
- Add Verification checks (are criteria checkboxes? are they testable?)
- Add failure modes for vague implementation plans

Examples:
- Both short and long examples now include full Implementation Plan
  with specific file paths, grep-able verification commands, and
  migration steps
- Long example shows code reference convention

README:
- Reframed around 'executable specs' rather than 'decision records'
- Documents bidirectional linking and proactive triggers