adr-drafting
Guides you through seven-phase ADR drafting via focused dialogue, asking one question per turn and pressure-testing your reasoning before self-critique. Enforces specificity on components, deciders, and architectural characteristics, then routes to discovery if foundations are shallow.
adr-drafting co-drafts architecture decisions through structured dialogue with built-in self-critique and failure-mode testing.
AI-generated summary based on this skill's SKILL.md
Install
JosiahSiegel/claude-plugin-marketplace/adr-drafting · repository language: Shell
git clone https://github.com/JosiahSiegel/claude-plugin-marketplace
cp -r claude-plugin-marketplace/plugins/doc-master/skills/adr-drafting ~/.claude/skills/adr-draftingnpx skillfed install JosiahSiegel/claude-plugin-marketplace/adr-draftingFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I draft an ADR with adr-drafting?
adr-drafting guides you through seven phases of structured dialogue, asking one focused question per turn. You describe your decision, and the skill pressure-tests your reasoning through targeted challenges before moving to self-critique. Each phase builds specificity on components, deciders, and architectural characteristics, ensuring your ADR captures not just what you decided but why it matters and what trade-offs you accepted.
Can adr-drafting challenge my reasoning and validate my choices?
Yes. adr-drafting is built to challenge your reasoning and pressure-test decisions before recording them. The skill asks probing questions about failure modes, tensions, and alternatives, then applies self-critique to surface weak spots in your logic. This validation happens during drafting, not after, so you can strengthen your decision record before it's finalized.
What happens if my decision isn't ready for an ADR?
adr-drafting routes decisions to RFC (Request for Comments) status when confidence or scope is unclear. If your foundations feel shallow during the seven-phase dialogue, the skill will recommend discovery and structured thinking before committing to a formal ADR. This prevents premature documentation and keeps your decision log honest.
Does adr-drafting convert decisions into formatted records?
Yes. adr-drafting converts your decision into a properly formatted ADR with relationships mapped between decisions. After the dialogue and critique phases, the skill produces a structured record that includes components, deciders, architectural characteristics, and links to related decisions—ready for your decision log.
Can I co-think an ADR for a specific technology choice?
Absolutely. adr-drafting supports co-thinking ADRs for specific technologies—whether postgres, kubernetes, microservices, or others. The skill applies the same seven-phase dialogue and pressure-testing process to any architectural decision, asking you to justify the choice, explore alternatives, and articulate trade-offs before finalizing the record.
What makes adr-drafting different from a template?
adr-drafting is dialogue-driven, not template-driven. Rather than handing you a blank form, the skill asks one question at a time, listens to your answer, and adapts the next question based on what you said. It pressure-tests your logic, applies self-critique, and validates your choices against failure modes—turning ADR writing into a thinking tool, not just a filing exercise.
SKILL.md
rendered from the published skill — quoted content, verbatim
adr-drafting
Co-drafts an ADR through structured dialogue. The architect never sees a first draft — only the self-critiqued revision.
Inputs
- Required:
docs/architecture/discovery-brief.mdwith all five MUSTsCONFIRMED. If missing or shallow, this skill refuses and routes toadr-discovery. - Optional:
docs/architecture/open-questions.md.PARKEDMUSTs must be cited in the resulting ADR's Consequences.
Core operating rule
Never emit more than one question or one step per message. If a turn contains two ?, two numbered actions, or runs more than a short paragraph, shorten and ask the most important question
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 4 files
plugins/doc-master/skills/adr-drafting/SKILL.md
plugins/doc-master/skills/adr-drafting/references/pushback-patterns.md
plugins/doc-master/skills/adr-drafting/references/rfc-routing.md
plugins/doc-master/skills/adr-drafting/references/template-fields.md