Skills 2026-02-13 18:29 UTC
adr-skill
Committed by joelhooks. Update Category: Routine Updates & Maintenance. Commit details: ADRs as executable specifications for coding agents. This update performs routine maintenance and minor adjustments.
CommitRaw commit message
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