Files
FESADev/.codex/skills/fesa-adr-update/SKILL.md
T
2026-05-01 02:29:30 +09:00

1.0 KiB

name, description
name description
fesa-adr-update Draft or revise FESA ADRs when architecture, numerical conventions, dependencies, result schema, or phase scope decisions change.

FESA ADR Update

Use this skill when a design decision should become durable project policy.

Read First

  • /AGENTS.md
  • /PROGRESS.md
  • /PLAN.md
  • /docs/ARCHITECTURE.md
  • /docs/ADR.md
  • The topic-specific design document.

Workflow

  1. Identify whether the change is a new decision, a clarification, or a superseding decision.
  2. Capture context, decision, consequences, alternatives considered, and validation impact.
  3. Update related docs only when needed to avoid drift.
  4. Add follow-up tasks to PLAN.md.
  5. Record completed ADR work in PROGRESS.md.

Decision Quality Bar

  • Decisions should preserve runtime polymorphism, documented state ownership, DofManager ownership, adapter boundaries, step/frame/history outputs, and reference-driven verification.
  • If a decision weakens those policies, document why and what test or reference coverage will protect it.