What problem does it solve?
Manage-ADR streamlines the repetitive and error-prone process of creating, indexing, and validating Architecture Decision Records (ADRs) so teams maintain consistent, AI-friendly decision documentation without manual formatting or numbering work.
Core Features & Use Cases
- Create ADRs with TL;DR format: Auto-assigns sequential numbers, injects pillar-specific sections, and produces a compact TL;DR plus full documentation structure for efficient AI and human consumption.
- Validate and enforce standards: Checks TL;DR fields, required full-document sections, YAML frontmatter, and pillar-specific requirements before acceptance.
- Indexing and lifecycle management: Updates ADR indexes and checklists, supports listing and showing ADR summaries, and preserves atomic file operations to avoid partial writes.
- Use case: A developer records a state-management decision and automatically gets ADR-023 generated with Type Safety and Error Handling sections derived from the project profile.
Quick Start
Use the manage-adr skill to create a new ADR by instructing the assistant: /manage-adr create "Use Zustand Vanilla Stores"