
create-architectural-decision-record
Structured Architectural Decision Record generator
by githubFree
Description
create-architectural-decision-record is an agent skill from the github/awesome-copilot collection that writes an Architectural Decision Record (ADR), a short document that records a significant technical decision, why it was made, and what follows from it. The ADR is formatted for both AI and human readers and is managed as a sequentially numbered file, so the history of decisions stays in order. The skill needs four inputs: the context that made the decision necessary, the decision itself, the alternatives that were considered, and the stakeholders involved. If any of these cannot be found in the conversation, the agent asks the user for them before it writes anything. The document uses front matter and sections for the context, the decision rationale and the consequences, with the consequences divided into positive and negative outcomes so that the trade-offs are visible. Recording the rejected alternatives and the downsides is what makes an ADR useful later, when someone asks why a choice was made. The skill is useful for architects and teams that want decisions written down at the time they are made. An ADR records a decision, and it should be reviewed by the stakeholders named in it before it is accepted. The skill is installed with the skills CLI from the github/awesome-copilot repository. Its skills.sh page showed about 10.1K installs and passing results from three security audits at the time of the scan.…
Highlights
- Architectural Decision Record in a standard format
- Context, decision rationale and consequences
- Positive and negative outcomes listed
- Sequentially numbered files
- Asks for missing inputs before writing
- Installs with the skills CLI
Ratings & Reviews
No ratings yet
Be the first to rate create-architectural-decision-record.
People also visit

acquire-codebase-knowledge
The user explicitly asks to map, document, or onboard into an existing codebase

architecture-blueprint-generator
Analyzes codebases to generate comprehensive architectural documentation

project-workflow-analysis-blueprint-generator
Generates detailed implementation blueprints by analyzing project architecture
create-architectural-decision-record FAQ
What is an ADR?
An Architectural Decision Record that documents a significant technical decision, its reasons and its consequences.
What inputs does it need?
The context, the decision, the alternatives considered and the stakeholders.
What if an input is missing?
The agent asks you for it before it writes the record.
Why record alternatives and downsides?
So that later readers can see why a choice was made and what it cost.
How do I install it?
Run npx skills add https://github.com/github/awesome-copilot --skill create-architectural-decision-record.
What security audits does it have?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best create-architectural-decision-record alternatives?
Popular alternatives to create-architectural-decision-record include documentation-and-adrs, acquire-codebase-knowledge and architecture-blueprint-generator. See all create-architectural-decision-record alternatives





