spae-spec

Generates SPEC.md and STATE.json files from proposals for the SPAE structured workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning vague proposals or tasks into clear, testable requirements is error-prone, and AI agents often drift, hallucinate scope, or lose state between sessions. This Skill distills a proposal into a concise, testable SPEC.md with stable R-NNN requirement identifiers and persists workflow state in STATE.json so any agent can resume the workstream later. ## Core Features & Use Cases - Spec Generation: Distills user proposals, codebase context, and AGENTS.md constraints into observable, implementation-neutral requirements tagged with unique R-NNN identifiers. - Revision Workflow: Rewrites SPEC.md from scratch after a failed verification, converting every VERIFY.md hard block into an addressed spec item. - State Persistence: Creates and updates .spae/[workstream]/STATE.json, advancing the phase from spec to plan so downstream agents can resume with zero prior context. - Use Case: You have a feature idea like "add rate limiting to the API." Invoke the skill to produce a scoped SPEC.md with requirements, testing strategy, out-of-scope boundaries, and assumptions, ready for the plan phase to decompose into atomic tasks. ## Quick Start Ask the agent to run the spae-spec skill with your proposal, for example: create a spec for adding rate limiting to the API endpoints.

Frequently Asked Questions about spae-spec

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

FAQPage Schema
How do I generate a software specification from a feature proposal?▼

Invoke the skill with your proposal text and it produces a SPEC.md containing a goal, R-NNN tagged requirements, testing strategy, out-of-scope items, and assumptions. It reads relevant codebase sections and AGENTS.md constraints before drafting.

How does the SPAE spec phase handle a failed verification?▼

When STATE.json shows status revision_required and VERIFY.md exists, the skill deletes the old SPEC.md and rewrites it from scratch. Every VERIFY.md hard block converts into an addressed spec item with fresh R-NNN identifiers.

What files does the spae-spec skill write?▼

It writes only the .spae/current symlink, .spae/[workstream]/SPEC.md, and .spae/[workstream]/STATE.json. Source code stays read-only, and the .spae directory is never staged or committed.

Does the spec workflow require human input during execution?▼

No, the skill runs fully autonomously and never asks for clarification mid-execution. Ambiguity resolves from codebase evidence first, falling back to documented conservative assumptions recorded in SPEC.md.

What happens after the spec phase completes?▼

STATE.json advances to phase plan with status active, empty cursor, and empty tasks. The plan phase then decomposes SPEC.md into atomic, independently verifiable tasks.