---
description: Draft or update an ADR for a FESA architecture or numerical decision.
---

# /adr

## Preflight

- Read `/AGENTS.md`, `/PROGRESS.md`, `/PLAN.md`, `/docs/ARCHITECTURE.md`, `/docs/ADR.md`, and the topic-specific design docs.
- Use `$fesa-adr-update` when available.
- Identify whether this is a new decision, a revision, or a superseding ADR.

## Task

- Capture context, decision, consequences, alternatives considered, and affected docs.
- Update related docs only when needed to keep decisions consistent.
- Record follow-up tasks in `PLAN.md` and completed ADR work in `PROGRESS.md`.

## Verification

- Check links and decision numbering manually.
- Run `python scripts/validate_workspace.py`.

## Result

- **Action**: drafted or updated ADR content
- **Status**: success | partial | blocked
- **Details**: ADR section changed, affected docs, and validation result