{"enrichment":{"faq":[{"a":"adr-writer helps teams document architectural decisions in a structured, numbered format that captures context, alternatives considered, and consequences. It guides you through identifying decision-worthy choices, articulating constraints, evaluating options, and projecting impacts\u2014ensuring future readers understand not just what was decided, but why.","q":"What is adr-writer and what does it help me do?"},{"a":"adr-writer walks you through a structured process: identify the decision and its context, list constraints and assumptions, enumerate alternatives with tradeoffs, state your chosen option, and document consequences. The tool generates a numbered record with metadata and optional links to superseded prior decisions, creating an audit trail of your reasoning.","q":"How do I document design decisions using adr-writer?"},{"a":"Yes. adr-writer is designed to capture architecture decisions with full context, enumerate alternatives you considered, and document the tradeoffs between them. It structures this information so the decision rationale is preserved for future reference, helping teams understand constraints and rejected options alongside the final choice.","q":"Can adr-writer capture architecture decision with context and alternatives?"},{"a":"adr-writer generates numbered, status-tracked architecture decision records with proper metadata. Each record includes sections for context, alternatives, consequences, and decision rationale. The tool supports supersession links to existing decisions, establishing a governance and audit trail for your system design choices.","q":"What format does adr-writer use for decision records?"},{"a":"adr-writer ensures your architectural reasoning is preserved for future reference and team onboarding. By capturing context, tradeoffs, and rejected alternatives in a structured format, it prevents knowledge loss, enables informed re-evaluation of past decisions, and establishes accountability and governance around critical design choices.","q":"Why should my team use adr-writer to document architectural choices?"},{"a":"Yes. adr-writer creates ADRs with proper metadata and supersession links to existing decisions. This allows you to track how architectural choices evolve over time, understand which prior decisions a new one replaces, and maintain a connected, auditable history of your system's design evolution.","q":"Does adr-writer support metadata and links between decisions?"}],"shadow_tags":["decision-documentation","architecture-governance","tradeoff-analysis","design-rationale","tech-decision-tracking","decision-history","architecture-audit-trail","decision-lifecycle","context-preservation","alternatives-evaluation"],"summary_rewrite":"ADR Writer helps teams document architectural decisions in a structured, numbered format that captures context, alternatives considered, and consequences. It guides you through identifying decision-worthy choices, articulating constraints, evaluating options, and projecting impacts\u2014ensuring future readers understand not just what was decided, but why."},"files":[{"bytes":8155,"path":"skills/adr-writer/SKILL.md","sha256":"e249a79b167283a4a838b348cb29aa9b46305cf39cf1da9f8f8303bff8ab9636","url":"https://skillfed.io/files/Mathews-Tom/armory/adr-writer/7f33146b/SKILL.md"}],"id":"Mathews-Tom/armory/adr-writer","links":{"html":"https://skillfed.io/Mathews-Tom/armory/adr-writer","md":"https://skillfed.io/Mathews-Tom/armory/adr-writer.md","repo":"https://github.com/Mathews-Tom/armory"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":42,"language":"Python","last_updated":"2026-07-21","license":"MIT","name":"adr-writer","publisher":"Mathews-Tom","stars":274},"relations":{"categories":["architecture","documentation","operations"],"similar":[{"id":"patricio0312rev/skills/adr-writer"},{"id":"govctl-org/govctl/adr-writer"},{"id":"spencerpauly/awesome-cursor-skills/architecture-decision-records"},{"id":"affaan-m/ECC/architecture-decision-records"},{"id":"wshobson/agents/architecture-decision-records"},{"id":"yonatangross/orchestkit/architecture-decision-record"},{"id":"dawiddutoit/custom-claude/create-adr-spike"},{"id":"shashankswe2020-ux/whoop-mcp/documentation-and-adrs"},{"id":"vladm3105/aidoc-flow-framework/doc-adr"},{"id":"addyosmani/agent-skills/documentation-and-adrs"}]},"slug":{"owner":"Mathews-Tom","repo":"armory","skill":"adr-writer"},"version":"7f33146b"}