Create Architecture Decision Records with rationale, alternatives, and consequences.
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-adr
Please help me install this Agent Skill. Skill: doc-adr Source: https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-adr Command: npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-adr
This Skill creates Architecture Decision Records (ADR) that document architectural decisions with rationale, alternatives, and consequences to guide future work.
Create an ADR that captures a decision, its rationale, and the consequences for system evolution.
High-intent search queries and answers about installing and using this skill.
Architecture Decision Records (ADRs) document architectural decisions by capturing the decision context, alternatives considered, and consequences. ADRs create a traceable history of why specific architectural choices were made, guiding future development and preventing revisiting settled decisions.
An ADR captures decision context, the chosen option, rationale for the choice, alternatives that were rejected, and long-term consequences for system evolution. The four-part template ensures consistency and links decisions to upstream artifacts like BRD, PRD, EARS, and BDD documents.
ADRs include traceability tags and references to upstream BRD, PRD, EARS, and BDD artifacts, establishing a chain from business requirements through architectural choices to implementation. This creates accountability and enables impact analysis when requirements change.
Yes, ADRs support Mermaid diagrams to visualize architectural options and their consequences, making decision context clearer and more accessible to team members reviewing the record.
Create ADRs for significant architectural decisions during Layer 5 system design workflow, particularly when evaluating alternatives with long-term impact. ADRs ensure decisions are documented before implementation and capture the reasoning while it's fresh.
ADRs contribute to SYS-Ready scoring by providing documented rationale, alternatives analysis, and consequence evaluation for architectural choices, demonstrating that decisions were made systematically and defensibly.
vladm3105Create Layer 1 BRD artifacts defining business needs and strategic objectives.
openyakDocument architecture decisions and system designs in standardized ADR templates.
vladm3105Generate Layer-4 BDD test scenarios in Gherkin Given-When-Then format.
zardusai-cyberDocument architectural decisions as structured ADRs with context and alternatives.
