{"enrichment":{"faq":[{"a":"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.","q":"How do I draft an ADR with adr-drafting?"},{"a":"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.","q":"Can adr-drafting challenge my reasoning and validate my choices?"},{"a":"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.","q":"What happens if my decision isn't ready for an ADR?"},{"a":"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\u2014ready for your decision log.","q":"Does adr-drafting convert decisions into formatted records?"},{"a":"Absolutely. adr-drafting supports co-thinking ADRs for specific technologies\u2014whether 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.","q":"Can I co-think an ADR for a specific technology choice?"},{"a":"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\u2014turning ADR writing into a thinking tool, not just a filing exercise.","q":"What makes adr-drafting different from a template?"}],"shadow_tags":["decision-documentation","architecture-governance","structured-dialogue","reasoning-validation","design-rationale","decision-graph","critique-workflow","component-relationships","rfc-process","fitness-functions"],"summary_rewrite":"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."},"files":[{"bytes":13083,"path":"plugins/doc-master/skills/adr-drafting/SKILL.md","sha256":"255a3e815fe628df67257c04e8e6fed8a8033242effffb27796130dbca063fe6","url":"https://skillfed.io/files/JosiahSiegel/claude-plugin-marketplace/adr-drafting/5ecd0e78/SKILL.md"}],"id":"JosiahSiegel/claude-plugin-marketplace/adr-drafting","links":{"html":"https://skillfed.io/JosiahSiegel/claude-plugin-marketplace/adr-drafting","md":"https://skillfed.io/JosiahSiegel/claude-plugin-marketplace/adr-drafting.md","repo":"https://github.com/JosiahSiegel/claude-plugin-marketplace"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":10,"language":"Shell","last_updated":"2026-06-18","license":"MIT","name":"adr-drafting","publisher":"JosiahSiegel","stars":49},"relations":{"categories":["architecture","decision-governance","documentation"],"similar":[{"id":"JosiahSiegel/claude-plugin-marketplace/adr-discovery"},{"id":"JosiahSiegel/claude-plugin-marketplace/doc-diagnostic"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-critique"},{"id":"JosiahSiegel/claude-plugin-marketplace/c4-model"},{"id":"microsoft/hve-core/adr-author"},{"id":"tech-leads-club/agent-skills/create-adr"},{"id":"ncklrs/startup-os-skills/adr"},{"id":"ruvnet/ruflo/adr-index"},{"id":"existential-birds/beagle/adr-writing"},{"id":"dirnbauer/webconsulting-skills/architecture-decision-records"}]},"slug":{"owner":"JosiahSiegel","repo":"claude-plugin-marketplace","skill":"adr-drafting"},"version":"5ecd0e78"}