modify documents

plugins/fesa-commands/commands/adr.md

@@ -0,0 +1,28 @@
+---
+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