spae-check

Verifies active task implementation against PLAN.md acceptance criteria and routes gaps to fix.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/mystilleef/spae-framework --skill spae-check-mystilleef
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spae-check
Source: https://github.com/mystilleef/spae-framework/tree/main/skills/spae-check
Command: npx skills add https://github.com/mystilleef/spae-framework --skill spae-check-mystilleef

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-driven development often drifts from the plan: tasks get marked done without evidence, scope creeps, and gaps go unnoticed. This Skill acts as a per-task verification gate in the SPAE workflow, comparing the active task's implementation against its declared Intent, Acceptance, and Verification criteria before allowing progress. ## Core Features & Use Cases - Evidence-based gating: Runs the task's verification steps and project checks, then labels every finding as either a blocking Gap or a non-blocking Observation. - State machine routing: Writes STATE.json transitions—gaps route to /fix with a structured FIX.md, clear tasks advance the cursor to /build, and a clear final task routes to /verify. - Scope discipline: Enforces KISS/YAGNI by flagging speculative abstraction, unrequested complexity, and self-introduced cleanup violations grounded in the task's own git diff. - Use Case: After a build agent implements task T-002 of a workstream, run the check phase to confirm every acceptance criterion with reproducible evidence; if a gap exists, FIX.md is written with file:line, expected vs actual, and the workflow routes to /fix automatically. ## Quick Start Run the check phase to verify the active task in .spae/current/PLAN.md against its acceptance criteria and update STATE.json with the verdict.

Frequently Asked Questions about spae-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a completed task against a plan in an AI agent workflow?▼

Run the check phase after build: it reads STATE.json for the active task, executes the task's Verification steps, and confirms every Acceptance criterion against evidence. Clear tasks advance to the next build; gaps produce a FIX.md and route to fix.

What is the SPAE check phase in a spec-plan-build workflow?▼

The check phase is step 5 of the SPAE seven-step workflow (spec, plan, inspect, build, check, fix, verify). It gates each atomic task by comparing implementation evidence against PLAN.md before the cursor advances.

What is the difference between a Gap and an Observation in task verification?▼

A Gap is an unmet Acceptance criterion, failed Verification, Intent mismatch, or cleanup violation with reproducible evidence; it blocks the task and is written to FIX.md. An Observation is a minor out-of-scope concern reported only in the summary.

Can the check skill modify source code or the plan file?▼

No. It only reads source, tests, config, docs, and logs, and writes only FIX.md and STATE.json. It never edits SPEC.md, PLAN.md, source files, or tests, and never claims workstream completion.

What happens when the check phase finds gaps in a task?▼

It writes a FIX.md following the gap schema with verbatim Intent, file:line, expected vs actual, and reproducible evidence, then sets STATE.json phase to fix while keeping the active task in_progress.