adr-writer
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—ensuring future readers understand not just what was decided, but why.
ADR Writer generates structured architecture decision records that capture context, rationale, alternatives, and consequences in numbered format.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-21
ADR Writer generates structured architecture decision records that capture context, rationale, alternatives, and consequences in numbered format. 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—ensuring future readers understand not just what was decided, but why.
Use it when
- adr-writer walks you through a structured process: identify the decision and its context, list constraints and assumptions.
- Yes.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Install
Mathews-Tom/armory/adr-writer · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is adr-writer and what does it help me do?
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—ensuring future readers understand not just what was decided, but why.
How do I document design decisions using adr-writer?
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.
Can adr-writer capture architecture decision with context and alternatives?
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.
What format does adr-writer use for decision records?
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.
Why should my team use adr-writer to document architectural choices?
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.
Does adr-writer support metadata and links between decisions?
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.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
ADR Writer
Captures architecture decisions in a lightweight, structured format that preserves context, rationale, alternatives, and consequences. Produces numbered ADR documents with proper status lifecycle — preventing the "why did we do it this way?" problem when revisiting decisions months later.
Reference Files
| File | Contents | Load When |
|---|---|---|
references/adr-template.md |
Standard ADR template with field explanations and examples | Always |
(truncated - see the full file via the links below)
File tree — 6 files
skills/adr-writer/SKILL.md
skills/adr-writer/evals/cases.yaml
skills/adr-writer/references/adr-template.md
skills/adr-writer/references/alternatives-analysis.md
skills/adr-writer/references/context-capture.md
skills/adr-writer/references/status-lifecycle.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Generate a structured architecture decision record with context, alternatives, and consequences”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
ADR Writer guides you through building comprehensive Architecture Decision Records that capture the reasoning behind key technical choices. It provides a structured template covering context, decision rationale, alternatives evaluated, tradeoffs made, and consequences—helping teams document and communicate architecture decisions clearly.
Create and maintain architecture decision records (ADRs) using established conventions, templates, and a built-in validator. The skill guides you through prospective and retrospective record creation, enforces quality standards like one decision per record and credible alternatives, and helps manage decision lifecycles with status tracking and supersession links. Use it to build a durable, reviewable record of why architecturally significant choices were made.
ADR Writer creates formatted architecture decision records that capture the problem, alternatives weighed, and chosen solution. It automatically numbers files, slugifies titles, and populates a standard template to ensure design decisions survive team turnover.
This skill captures architectural decisions made during coding sessions as structured ADR documents that live alongside your codebase. It detects decision moments, gathers context and alternatives, and maintains a searchable log so future developers understand the reasoning behind your architecture.
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.
Capture significant technical choices in a structured format that explains the problem, alternatives weighed, and reasoning behind your decision. Use the provided template to create numbered records in your docs folder, then reference them from code comments when relevant. This ensures your team understands not just what was decided, but why—making it easier to revisit or build on those choices later.
More skills architecture-decision-records (MIT) · Create Adr (NOASSERTION) · adr (MIT) · architecture-decision-record (MIT) · Create Adr Spike (unlicensed) · documentation-and-adrs (MIT) · doc-adr (MIT) · write-adr (Apache-2.0)