ADR Generator

•
16
•

Drafts and standardizes Architecture Decision Records (ADRs) and RFCs by automatically detecting repository conventions and capturing design trade-offs.

The ADR Generator skill streamlines the process of capturing critical technical decisions, trade-offs, and architectural shifts directly within your repository. It scans your project to detect existing ADR directory structures and templates (such as MADR or Nygard), identifies sequential file numbering, or establishes a clean standard format if none exists. By extracting essential problem context, evaluated alternatives, decisions, and trade-offs, it writes concise, lasting documentation that preserves engineering rationale without modifying application code.

主要功能

01Extracts decision forces, evaluated options, and architectural consequences
0216 GitHub stars
03Grounds context in existing codebase modules, dependencies, and git history
04Calculates sequential numbering and maintains uniform file naming schemes
05Initializes a standardized decision log when no prior documentation structure exists
06Auto-detects repository ADR paths and formatting conventions (MADR or Nygard)

使用场景

01Drafting RFCs and technical proposals before implementing structural changes
02Recording trade-offs and rationale behind complex refactoring or framework migrations
03Documenting major architectural choices and technology evaluations for future maintainers