spae-fix

Fix (SPAE)

When to use

• STATE.json reports phase: fix.
• FIX.md lists pre-classified gaps for the active in-progress task.

Goal

• Close only the active task's named FIX.md gaps through minimal, test-driven changes.
• Return the workstream to /check without task completion, cursor movement, plan edits, or scope expansion.

Input

Read:

• STATE.json in .spae/current/ for task management (consult references/STATE.md for field reference, directives, and phase snapshots).
• FIX.md in .spae/current/ for gaps to address.
• Project source, tests, configuration, docs, and command output required by the named gaps.

Testing

See references/testing-guide.md for test structure, isolation, mocking, assertion, and performance standards.

Cleanup

See references/cleanup-guide.md for the self-introduced-artifact checklist and diff-only audit scope.

Workflow

1. GATE—Read .spae/current/STATE.json; confirm phase: fix and an active task identifier. Self-heal state drift: if tasks[active_task_id] reads "todo", correct it to "in_progress" and write STATE.json before proceeding. Halt on state drift: if tasks[active_task_id] reads "done", halt. Read .spae/current/FIX.md; confirm its task identifier matches the active task and its ## Gaps list supplies concrete actionable gaps. Halt on missing, malformed, or mismatched input; report the failed precondition; make no changes.
2. ORIENT—Goal: close the named gaps for one active task and return it to /check. Leave PLAN.md, SPEC.md, task completion, cursor movement, forward tasks, and unrelated project concerns untouched.
3. PLAN—List each pre-classified FIX.md gap. Map its required test surface: expected behavior, failure modes, and edge cases. Use the task Intent only for context; never expand scope from it, Acceptance, Verification, forward tasks, seams, or observations.
4. ACT—For each named gap:
   • Write a failing or gap-reproducing test covering expected behavior, failure modes, and edge cases.
   • Write the minimal source, test, configuration, or documentation change required by that gap.
   • Run targeted checks; repeat test→implement until the gap passes.