write-adr

Create ADR-NNNN.md files from solution.md with a provided template.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/daddia/space --skill write-adr-daddia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-adr
Source: https://github.com/daddia/space/tree/main/.agents/skills/write-adr
Command: npx skills add https://github.com/daddia/space --skill write-adr-daddia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill documents a consequential architecture decision as an ADR-NNNN.md file to ensure traceability, governance, and repeatable decision records across projects.

Core Features & Use Cases

  • ADR scaffolding: provides a blank scaffold and a template for architecture decisions.
  • Decision-driven documentation: captures context, decision drivers, options, consequences, and related ADRs.
  • Lifecycle integration: consumes solution.md and produces ADR-NNNN.md under architecture/decisions with the correct frontmatter.

Quick Start

Provide the decision context and run this skill to scaffold ADR-NNNN.md.

Frequently Asked Questions about write-adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document an architecture decision using an ADR template?

To document an architecture decision, provide the decision context and run this skill to scaffold an ADR-NNNN.md file. The generated record enforces structure by capturing context, options considered, and consequences with frontmatter-driven metadata.

What is the best way to scaffold an Architecture Decision Record for traceability?

Scaffolding an Architecture Decision Record is best done by using a provided template to generate ADR-NNNN.md under the architecture/decisions directory. This ensures governance and repeatable decision records across projects.

When do I need to write an ADR for a consequential architecture decision?

You need to write an ADR when a consequential architecture decision requires context, options considered, and defined consequences. This skill reads solution.md to produce a structured ADR-NNNN.md file for traceability.

Can I use a scaffold to capture context and consequences in a decision record?

Yes, you can use a scaffold to capture context, decision drivers, options, consequences, and related ADRs. The skill applies a template to enforce structure and injects a frontmatter-driven metadata block into the output file.

Does the ADR scaffolding process integrate with solution.md for context?

Yes, ADR scaffolding integrates with solution.md by reading it for context. It then produces a formatted ADR-NNNN.md file under architecture/decisions, applying a template to ensure lifecycle integration and proper metadata.