adr-lifecycle

What problem does it solve?

This Skill streamlines the Architectural Decision Record (ADR) lifecycle, from proposing to accepting or backfilling changes to existing ADRs, ensuring a consistent, immutable process.

Core Features & Use Cases

• Lifecycle Management: Track ADR status changes from proposed to accepted, superseded, or deprecated.
• Immutable Bodies: Record the decision rationale in a body that cannot be altered after creation.
• Superseding ADRs: Automatically backfill superseded_by upon promoting new ADRs.
• Frontmatter Spec: Standardize ADR creation with required and optional YAML frontmatter fields.
• Use Case: When planning a new feature in your project, create an ADR that outlines the architectural decisions, its rationale, and its lifecycle changes.

Quick Start

Run the adr-lifecycle skill and follow the three-test gate to propose a new ADR or manage existing ones.