extract-adrs

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.