spae-verify

Verify SPAE

When to use

• STATE.json reports phase: verify.
• Every PLAN.md task reports done.

Goal

• Compare implemented repository state against SPEC.md, identify gaps, and close or reopen the work stream as the final SPAE arbiter.
• Pass: complete the work stream.
• No pass: route actionable gaps back to /spec.

Input

Read:

• .spae/current/STATE.json (consult references/STATE.md for field reference, directives, and phase snapshots)
• .spae/current/SPEC.md
• .spae/current/PLAN.md
• All source files modified by this workstream (scoped from .spae/current/PLAN.md tasks)
• .spae/current/VERIFY.md, when present

Workflow

1. GATE—Read .spae/current/STATE.json; self-heal metadata: inject missing version ("1.0"), workstream (from symlink or directory path), and status ("active"). Confirm phase: verify. Confirm every .spae/current/PLAN.md task reports done in the tasks registry. Halt immediately on unparseable JSON, unrecognized phase, or incomplete tasks; report which check failed; make no changes.
2. ORIENT—Goal: compare implemented repository state against each .spae/current/SPEC.md spec item; determine pass, no-pass, or blocked verdict.
3. PLAN—List SPEC.md spec item IDs and source files modified by this workstream (scoped from PLAN.md tasks).
4. ACT—Execute:
   • Run all relevant project checks. When no automated checks exist, inspect observable behavior directly—reading code and logs or running scripted probes—never delegating execution or evidence capture to a human, an attended terminal, or an interactive session. Record all results; any check failure mapping to a SPEC.md item classifies as a hard block.
   • When a SPEC.md item resists verification without human execution, an attended or interactive terminal, or human presence: classify it as a hard block and record it in VERIFY.md as a spec defect for /spec to resolve; never instruct the user to perform a verification step.
   • Compare implementation against each SPEC.md item using check results as evidence. Reference each finding by spec item ID.
   • When .spae/current/VERIFY.md exists: treat each prior finding as an explicit re-check item; confirm each addressed before proceeding.
   • Classify each finding:
     • Hard block: regression, contract break, missing or incorrect required behavior, check failure mapping to a SPEC.md item; drives verdict to no-pass.
     • Soft finding: absent test coverage of explicit required behavior; unsafe optimization; complexity ungrounded in an explicit SPEC.md spec item (for example, a validation library pulled in for a single basic check); note only; no verdict impact.
     • Observation: thin edge-case test coverage, ambiguous or untestable spec item, minor deviation outside SPEC scope, unrequested guardrail, theoretical risk; note only; no verdict impact.
   • Draft findings against the references/VERIFY.md schema; consult references/prose-protocol.md for phrasing.
5. VERIFY—Confirm any drafted VERIFY.md content matches references/VERIFY.md structure.
6. PERSIST—Apply verdict:
   • Pass: set STATE.json to status: completed, phase: done; remove .spae/current/VERIFY.md when present; remove .spae/current symlink.
   • No pass: create or overwrite .spae/current/VERIFY.md using the references/VERIFY.md schema with hard blocks from the current run only, followed by soft findings and observations as informational notes; set STATE.json to status: revision_required, phase: spec, cursor: {}, tasks: {}.
   • Blocked: write blocker details only to .spae/current/VERIFY.md (omit observations); set STATE.json to status: revision_required, phase: spec, cursor: {}, tasks: {}.
   • All verdicts: re-read STATE.json after writing; on a field mismatch, rewrite and re-read. On Pass, confirm the re-read before removing .spae/current.
7. REPORT—Emit the result following the result directives and using the result template. On pass, surface observations under Findings. On blocked, emit the Blocked result block.