architecture-decision-recorder

Quick Review

This skill provides a solid ADR template and best practices for documenting architectural decisions. The template is comprehensive and well-structured with clear sections for context, rationale, consequences, and alternatives. However, the description lacks specificity about HOW a CLI agent should invoke the skill—what parameters are needed, what files to create/read, naming conventions, or directory structure. The 'Related Commands' section mentions '/adr-create' but provides no implementation details or guidance on how the agent should execute this. While the template itself is valuable, the novelty is limited since creating markdown files from templates is straightforward for a CLI agent. The skill would benefit from clearer invocation instructions, automated numbering logic, ADR lifecycle management (superseding/deprecating), and utilities for indexing or searching existing ADRs.