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.