Control-plane ADRs

Purpose

This directory holds control-plane ADR examples and workflow notes for AI orchestration decisions.

Accepted architecture ADRs still live in docs/platform/architecture/decisions/. Use this directory for AI workflow decisions unless they become core platform architecture.

When To Write An ADR

Write an ADR when a decision has been made and will affect future work:

• Technical selection.
• Architecture boundary.
• Repo or package split.
• App runtime contract.
• Testing strategy.
• Agent workflow rule.
• Release process.

Naming

YYYY-MM-DD-short-kebab-title.md

ADR Sections

• Status
• Date
• Context
• Decision
• Consequences
• Alternatives considered
• Follow-up tasks