spae-verify

Verifies implemented code against SPEC.md requirements and issues pass, fail, or blocked verdicts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It closes the final gap in a spec-driven development workflow by objectively comparing the implemented repository state against the original SPEC.md requirements, preventing unverified or drifting code from being marked complete. ## Core Features & Use Cases - Spec-to-Code Verification: Compares every SPEC.md requirement item against the actual implementation, using project checks and direct code inspection as evidence. - Verdict-Based State Management: Writes pass, no-pass, or blocked verdicts into STATE.json, completing the workstream on pass or routing actionable gaps back to the spec phase. - Structured Findings: Records hard blocks, soft findings, and observations in VERIFY.md following a strict schema, with enough detail for the spec phase to rewrite requirements. - Use Case: After all planned tasks in a workstream are marked done, run this skill to confirm the implementation satisfies every requirement before closing the workstream. ## Quick Start Run the verify phase on the current workstream to check the implementation against SPEC.md and report whether it passes.

Frequently Asked Questions about spae-verify

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

FAQPage Schema
How do I verify code against a specification document?▼

Run the verify phase after all PLAN.md tasks report done. The skill reads SPEC.md, runs relevant project checks, compares each requirement item against the implementation, and records a pass, no-pass, or blocked verdict in STATE.json.

What happens when spec verification fails?▼

On a no-pass verdict, the skill writes hard blocks to VERIFY.md mapped to SPEC.md requirement IDs, resets STATE.json to phase spec with status revision_required, and routes the workstream back to the spec phase for rework.

Can verification run without human interaction?▼

Yes, the skill enforces full autonomy. Any requirement that cannot be verified without human execution or an interactive terminal is classified as a spec defect and recorded as a hard block rather than delegated to the user.

What is the difference between a hard block and a soft finding?▼

A hard block is a regression, contract break, or failed check tied to a SPEC.md item and forces a no-pass verdict. A soft finding, such as missing test coverage or ungrounded complexity, is noted in VERIFY.md but does not affect the verdict.

When should the verify phase not run?▼

Do not run it unless STATE.json reports phase verify and every PLAN.md task is marked done. The skill halts immediately on a failed gate check without making any changes.