{"enrichment":{"faq":[{"a":"adr-writer guides you through documenting architectural decisions by establishing the problem context, weighing real alternatives, explaining why one direction won, and recording both benefits and costs. It enforces boundaries between decision rationale and product obligations, keeping ADRs focused on justification rather than execution or RFC-level commitments.","q":"How do I write architecture decision records with adr-writer?"},{"a":"adr-writer structures ADRs around context (the problem you faced), alternatives (real options you considered), and consequences (benefits and costs of your choice). This template ensures you document not just what you decided, but why that decision beat the alternatives and what trade-offs you accepted.","q":"What should an ADR template for design decisions include?"},{"a":"adr-writer emphasizes recording your decision rationale\u2014the reasoning that led you to select one approach over others. By capturing context and alternatives alongside consequences, it creates a clear record of why a design choice was selected, making it easier for future teams to understand the original thinking.","q":"How does adr-writer help document why we chose this architecture?"},{"a":"adr-writer supports governance and quality standards by helping you record architectural decisions with proper structure and depth. It audits content to ensure context, alternatives, and consequences are all present, enforcing completeness so your decision records remain useful for future reference and governance.","q":"Can adr-writer audit and review ADR content for completeness?"},{"a":"adr-writer helps you maintain a decision log that records both current and superseded architectural choices. By documenting the full history of why decisions were made and later changed, it lets you trace the evolution of your architecture and understand what trade-offs led to each transition.","q":"How does adr-writer maintain decision history and trace superseded choices?"},{"a":"adr-writer enforces best practices by keeping ADRs focused on justification rather than execution or RFC-level commitments. Document real alternatives you weighed, explain the context that made your choice right, and record both benefits and costs. This keeps decision records clear, traceable, and useful for governance.","q":"What are best practices for writing ADRs with adr-writer?"}],"shadow_tags":["decision-documentation","architectural-governance","design-rationale","consequence-tracking","alternatives-analysis","technical-record-keeping","choice-justification"],"summary_rewrite":"ADR Writer guides you through documenting architectural decisions by establishing the problem context, weighing real alternatives, explaining why one direction won, and recording both benefits and costs. It enforces boundaries between decision rationale and product obligations, keeping ADRs focused on justification rather than execution or RFC-level commitments."},"files":[{"bytes":4814,"path":".claude/skills/adr-writer/SKILL.md","sha256":"da8362924421cd54ea26a6bc53ff80561831003dcd3d2551c89904d5cfad2cb8","url":"https://skillfed.io/files/govctl-org/govctl/adr-writer/4eb10a6c/SKILL.md"}],"id":"govctl-org/govctl/adr-writer","links":{"html":"https://skillfed.io/govctl-org/govctl/adr-writer","md":"https://skillfed.io/govctl-org/govctl/adr-writer.md","repo":"https://github.com/govctl-org/govctl"},"meta":{"agents_supported":["claude-code"],"first_seen":"2026-07-28","forks":12,"language":"Rust","last_updated":"2026-07-27","license":"MIT","name":"adr-writer","publisher":"govctl-org","stars":239},"relations":{"categories":["architecture","governance","documentation"],"similar":[{"id":"govctl-org/govctl/decision-analysis"},{"id":"govctl-org/govctl/discuss"},{"id":"govctl-org/govctl/gov"},{"id":"govctl-org/govctl/spec"},{"id":"govctl-org/govctl/rfc-writer"},{"id":"govctl-org/govctl/migrate"},{"id":"Mathews-Tom/armory/adr-writer"},{"id":"govctl-org/govctl/wi-writer"},{"id":"govctl-org/govctl/detach"},{"id":"govctl-org/govctl/commit"}]},"slug":{"owner":"govctl-org","repo":"govctl","skill":"adr-writer"},"version":"4eb10a6c"}