Manages and documents architectural decisions using standardized ADR or Y-statement formats.
This skill transforms Claude into an expert architecture consultant, enabling the systematic documentation of critical design choices through Architecture Decision Records (ADRs). It supports both comprehensive traditional ADR formats and lightweight Y-statements, featuring automatic format detection, template management, and specialized workflows for superseding old decisions. It is ideal for maintaining a 'living' history of technical trade-offs, ensuring that long-term architectural rationale is preserved, standardized, and easily searchable for current and future team members.
Key Features
01Smart logic for linking and superseding outdated decisions
02Advanced search capabilities across single-file logs or multi-file directories
03Expert guidance on choosing between tactical Y-statements and comprehensive ADRs
040 GitHub stars
05Automatic detection of existing repository ADR formats and conventions
06Template-driven creation of architectural records for consistency
Use Cases
01Maintaining a searchable history of architectural changes for developer onboarding
02Documenting technology stack selections with explicit trade-offs and rationale
03Formalizing tactical design choices during rapid development cycles using Y-statements
