promote-adr-draft

What problem does it solve?

Promoting an approved ADR draft into the official docs archive can be error-prone and inconsistent when numbering, slugs, and provenance tracking must be done reliably.

Core Features & Use Cases

• Deterministic ADR promotion: Promotes exactly one approved Tier 1 proposal draft into docs/adr/ as the next sequential ADR file.
• Idempotent safety checks: Detects whether the proposal was already promoted by searching existing ADR frontmatter sourced_from to prevent duplicates.
• Robust slug and naming rules: Derives a sanitized slug from proposal_title or the draft’s first H1, then writes {NNNN}-{slug}.md while refusing filename collisions.
• Provenance-first frontmatter: Writes new ADR frontmatter capturing adr_number, sourced_from, promoted_at, and source_path, while preserving draft body verbatim.

Quick Start

Call promote-adr-draft with proposal_id and adr_draft_path to create the next numbered ADR in docs/adr/ without duplicating an existing one.