Skip to content

Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) that document significant technical decisions made during development.

Creating an ADR

/vt-c-adr "description of the decision"

Listing ADRs

/vt-c-adr --list

Superseding a Decision

/vt-c-adr --supersede ADR-NNN

Format

Each ADR follows the standard format: Context, Alternatives Considered, Decision, Consequences, and Implementation Notes. ADRs are linked to their originating spec via spec_id in the YAML frontmatter.

Status Values

  • accepted — decision is in effect
  • proposed — decision is under discussion
  • superseded — replaced by a newer ADR (see superseded_by field)
  • deprecated — no longer relevant