Draft Architecture Decision Records through a one-question-per-message workflow.
npx skills add https://github.com/janmohammadi/deep-adr --skill draft-adr-janmohammadi
Please help me install this Agent Skill. Skill: draft-adr Source: https://github.com/janmohammadi/deep-adr/tree/main/skills/draft-adr Command: npx skills add https://github.com/janmohammadi/deep-adr --skill draft-adr-janmohammadi
Drafts Architecture Decision Records (ADRs) through a disciplined one-question-per-message back-and-forth, ensuring reasoning is explicit and verifiable.
Start the ADR drafting session by providing the system context and your initial decision focus.
High-intent search queries and answers about installing and using this skill.
You draft an Architecture Decision Record through a one-question-per-message workflow, co-thinking with an architect to ensure explicit reasoning before saving.
Documenting architectural decisions through an ADL-based Architecture Contract improves traceability, accountability, and governance when choices create enforceable assertions.
The workflow guides you through a Phase 1-7 process, asking one question per message to make reasoning verifiable and avoid re-asking confirmed facts from discovery briefs.
You need an Architecture Contract when an architectural decision creates enforceable assertions, whereas ADRs are saved for general review and future refactorings.
Yes, the drafting process reads discovery briefs to avoid re-asking already confirmed facts, streamlining the ADR creation session.
Yes, the system self-critiques decisions before saving to improve decision quality and ensure explicit, verifiable reasoning.
ucirelloDefine STPA analysis purpose by identifying losses, hazards, and constraints.
cmd-llmCreate Architecture Decision Records using the MADR template with auto-numbered filenames.
nanorepublicaValidate code against centralized global tech stack standards.
prestariusWrite one ADR per decision into docs/adr/NNNN-title.md with a standard structure.
