adr-writer

Draft standardized Architectural Decision Records as markdown files in a git repository.

Updated Apr 12, 2026

Search Tags:#workflow #architecture #documentation #adr #engineering #decision-making

Ready to run

npx skills add https://github.com/olivermorgan2/workflow-generator --skill adr-writer-olivermorgan2

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adr-writer
Source: https://github.com/olivermorgan2/workflow-generator/tree/main/skills/adr-writer
Command: npx skills add https://github.com/olivermorgan2/workflow-generator --skill adr-writer-olivermorgan2

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of inconsistent or undocumented architectural decision-making by providing a structured, repeatable process for drafting Architectural Decision Records (ADRs).

Core Features & Use Cases

Automated Drafting: Generates standardized ADR files from decision topics using a predefined template.
Validation Gate: Integrates with a programmatic check-plan surface to ensure ADRs meet quality and content criteria before they are written to disk.
Use Case: After scoping an MVP, use this skill to batch-generate ADRs for key technical choices like database selection or API design, ensuring all trade-offs are documented and reviewed.

Quick Start

Use the adr-writer skill to draft ADRs for the list of architectural decisions identified in the current project planning document.

Frequently Asked Questions about adr-writer

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

FAQPage Schema

How do I generate Architectural Decision Records automatically?▼

To generate Architectural Decision Records automatically, you provide a decision topic and the skill drafts a standardized markdown file. It uses a predefined template to ensure consistent documentation of technical choices and trade-offs.

What is the best way to document architectural decisions in a git repository?▼

Documenting architectural decisions in a git repository is best handled by generating markdown files in a designated design directory. This maintains project history and rationale directly within your version control system.

How do I validate architectural documentation before committing it?▼

You validate architectural documentation before committing by running it through a validation gate. The skill checks content against deterministic criteria to ensure architectural rigor and completeness before writing to disk.

Can I batch-generate ADRs for multiple technical choices?▼

Yes, you can batch-generate ADRs for multiple technical choices. After scoping an MVP, you can process a list of architectural decisions like database selection or API design to document all trade-offs efficiently.

Do I need a specific repository structure to draft ADRs?▼

You need a git-based repository structure to draft ADRs. The skill operates within this environment to generate markdown files in a designated design directory and commit the finalized records.