architecture-decision-records

Quick Review

Excellent comprehensive skill for ADR documentation. The description clearly conveys when to use the skill, and the single SKILL.md file is well-structured with multiple templates, decision tables, lifecycle diagrams, directory structures, automation commands, review checklists, and best practices. Provides substantial task knowledge including 5 different ADR templates (MADR, lightweight, Y-statement, deprecation, RFC), management workflows, and tooling integration. Structure is logical with clear sections, though at this length it could benefit from splitting into separate template files. Novelty is good - while ADRs are a known practice, the comprehensive guidance, multiple formats, and process integration would save significant tokens and provide structure a CLI agent would struggle to synthesize consistently. Minor improvement areas: could reference external template files for the 5 formats to reduce main file length, and add more automation examples.