to-adr

Extract Architecture Decision Records from implementation plans or design documents.

2|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/Integralist/agent-skills --skill to-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-adr
Source: https://github.com/Integralist/agent-skills/tree/main/.agents/skills/to-adr
Command: npx skills add https://github.com/Integralist/agent-skills --skill to-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps users extract and formalize Architecture Decision Records (ADR) from plans or design documents, ensuring each decision is documented with alternatives and consequences.

Core Features & Use Cases

  • ADR Extraction: Automatically generate ADRs from implementation plans or design documents.
  • Decision Formalization: Record decisions with alternatives rejected and the consequences considered.
  • Use Case: When a user wants to document a decision made during project planning, or when another skill needs to formalize a plan's decisions.

Quick Start

Run the to-adr skill on your latest plan file: to-adr path/to/your-plan.md

Frequently Asked Questions about to-adr

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

FAQPage Schema
How do I generate Architecture Decision Records from a design document?

Architecture Decision Records are formalized by extracting decisions directly from your implementation plan or design document. This process automatically captures the specific decision, alternatives considered, and their consequences.

What is the best way to document architectural decisions and their consequences?

Documenting architectural decisions is best achieved by formalizing them into structured records. This ensures every design choice explicitly documents its alternatives considered and the consequences of implementation.

Can I extract ADRs automatically from an existing project plan?

Yes, you can extract ADRs automatically from an existing implementation plan. By running an extraction script on your plan file, the tool parses the document to formalize decisions without manual entry.

What do I need to formalize architecture decisions from a markdown plan?

To formalize architecture decisions, you need access to the source plan file and standard tools for date and file manipulation. The extraction script parses this document to output structured records.

Does formalizing design documentation capture alternatives that were rejected?

Yes, formalizing design documentation explicitly captures rejected alternatives. The formalization process ensures that alongside the primary decision, alternative options and their consequences are recorded.