What problem does it solve? Architectural decisions in software projects are often made informally and forgotten, leading AI agents and developers to propose changes that silently conflict with past choices. This Skill enforces a disciplined ADR workflow so every significant technical decision is documented, numbered, and consulted before new changes are proposed. ## Core Features & Use Cases - ADR Creation from Template: Generates sequentially numbered ADR files (e.g., docs/adr/0001-titulo.md) with the five mandatory blocks: Status, Context, Decision, Consequences, and Code Compliance Directive. - Conflict Detection: Requires reading all active ADRs in docs/adr/ before proposing functional changes, and stops to report any conflict with an Accepted ADR instead of silently bypassing it. - Immutability & Superseding: Enforces that accepted ADRs are never edited; reversals are handled by creating a new ADR that marks the old one as Superseded by ADR-NNNN. - Use Case: When deciding to adopt a new library or solver, the Skill checks existing ADRs, drafts a new numbered ADR with explicit prohibited/required code rules, and updates the docs/adr/README.md index. ## Quick Start Ask the agent to register the decision to adopt library X as an ADR in docs/adr following the project template.
