What problem does it solve?
This Skill eliminates ungoverned, scattered architectural decision tracking that leads to inconsistent project rules, missed compliance gates, and broken traceability between decisions and binding operational law.
Core Features & Use Cases
- Full ADR/FDR Lifecycle Management: Propose, ratify, and query Architectural Decision Records and Feature Decision Records with strict validation and formal ceremony.
- Automatic Constitution Synchronization: Mechanically copies accepted ADR operational rules into the project constitution as binding [LAW] sections, eliminating manual editing and single-source-of-truth drift.
- CI Gate Enforcement: Integrates with PR checks to ensure constitution and ADR changes are always synced in the same commit.
- Use Case: When a team decides to require JWT validation for all public endpoints, this skill formalizes the decision as an ADR, amends the constitution automatically, and ensures all future builds enforce the new rule.
Quick Start
Use the factory-adr-management skill to formalize the decision to adopt a BaseRepository pattern for all data access as an accepted ADR amending the Code Architecture constitution section.