Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) for the V025-claude-toolkit.

What is an ADR?

An ADR records a significant architectural decision along with its context and consequences. ADRs capture the "why" behind decisions so future contributors understand the reasoning.

Format

Each ADR is a markdown file with this structure:

# ADR-NNNN: Short Title

**Date**: YYYY-MM-DD
**Status**: proposed | accepted | deprecated | superseded
**Superseded by**: ADR-NNNN (if applicable)

## Context

What is the issue that we're seeing that is motivating this decision?

## Decision

What is the change that we're proposing and/or doing?

## Consequences

What becomes easier or more difficult to do because of this change?

Naming convention

YYYY-MM-DD-short-title.md

Example: 2026-03-05-two-workflow-model.md

Process

Per the constitution (.specify/memory/constitution.md), amendments to toolkit principles follow the ADR process:

1. Author the ADR with context, alternatives considered, and migration plan
2. Identify all affected skills, agents, orchestrators, and templates
3. Submit for review by the toolkit maintainer
4. Upon approval, update the constitution and propagate changes
5. Increment the constitution version per semantic versioning rules

Current ADRs

No ADRs have been recorded yet. This directory was created as part of SPEC-048 to fulfill the constitutional requirement for an ADR process.