extract-adrs

Extract architectural decisions from meta research and plan documents into draft ADRs.

30|1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/atomicinnovation/accelerator --skill extract-adrs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extract-adrs
Source: https://github.com/atomicinnovation/accelerator/tree/main/skills/decisions/extract-adrs
Command: npx skills add https://github.com/atomicinnovation/accelerator --skill extract-adrs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps surface and formalize architectural decisions that are buried or scattered across research and planning documents by converting them into standard Architecture Decision Records (ADRs), reducing manual effort and ensuring decisions are recorded consistently.

Core Features & Use Cases

  • Discovery: Scan research, plan, and decision documents to find explicit and implicit architectural decisions, option comparisons, and rationale.
  • Drafting ADRs: Populate the canonical ADR template with context, decision drivers, considered options, consequences, and references, using placeholder numbers until approved.
  • Batch Creation & Numbering: Coordinate approvals, assign sequential ADR numbers to approved drafts, and write ADR files into the configured decisions directory.
  • Use Case: When an architecture is discussed across multiple research notes and a plan, extract each significant choice into its own ADR for review and long-term documentation.

Quick Start

Scan meta/research and meta/plans to extract architectural decisions and generate proposed ADR drafts for review.

Frequently Asked Questions about extract-adrs

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

FAQPage Schema
How do I extract architectural decisions from research and plan documents?

To extract architectural decisions, agent-based document analysis scans meta research and plan documents to identify implicit choices, context, drivers, and tradeoffs, then converts them into draft Architecture Decision Records for review.

What is the best way to create Architecture Decision Records from scattered notes?

Creating Architecture Decision Records from scattered notes involves scanning research and planning documents to surface option comparisons and rationale, then populating a canonical ADR template with context, considered options, and consequences.

When do I need to formalize implicit architectural decisions into ADRs?

You need to formalize implicit architectural decisions into ADRs when significant choices are buried across multiple research notes and plans, ensuring decisions are recorded consistently for long-term documentation and review.

How to generate and sequentially number ADR drafts for approval?

Generating and numbering ADR drafts requires populating templates with placeholder numbers, coordinating approvals for the proposed drafts, and then assigning sequential ADR numbers to write approved files into the configured decisions directory.

Do I need repository access to extract and write ADR files?

Yes, you need repository access to read meta documents from research, plans, and decisions directories for analysis, and to write the approved Architecture Decision Record files into the configured repository structure.