spec-superflow plugin
A plugin that takes coding tasks from agreed scope to verified results and saves workflow state for later resumption.
- 879 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The plugin can change code, run checks and perform approved Git operations in a working repository.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/spec-superflowDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The plugin can change code, run checks and perform approved Git operations in a working repository.
This is third-party code. Review the repository files before installing.
What it does
spec-superflow helps an agent choose a development path. A small fix with a clear check can proceed directly; a change spanning modules starts with a short plan for the user to approve. Nine skills help clarify the task, write code and check the result. The CLI retains the verification command, its result and the changes reviewed. The plan and execution mode stay in the task directory so the agent can resume under the same conditions after a break.
Who it is for. For developers who resume unfinished tasks or hand them to another agent with a plan and verification history.
Good fit when
- Set boundaries before a change spanning several modules.
- Resume a task after a break using recorded state.
- Retain the verification command, exit code and result before handing over a fix.
- Synchronize changed behavior with the project’s main specification.
Not a fit when
- You need an autonomous process that authorizes its own scope expansion.
- Your team expects a separate worktree to be created automatically for every change.
- You need every skill to run automatically on every task.
Example request
Draft a short spec-superflow plan for the authentication change, state boundaries and verification, then wait for approval.Limitations
The CLI requires Node.js 20 or later; without it, plugin commands cannot start or resume a task. A new planned change needs `proposal.md` and `tasks.md` so the user can inspect its scope before approving it. By default the agent works in the current conversation with one final review and one final verification. Delegated agents, intermediate reviews and separate working directories must be enabled explicitly; installing the plugin does not create them automatically.
How to disable. Disable the plugin in your agent’s extension manager. Preserve change directories before removal because unfinished tasks use them for resumption.
FAQ
Do I need separate OpenSpec and Superpowers installs?
No. The plugin borrows their approaches but ships its own CLI and does not depend on them at runtime.
How do I check installation?
Run `ssf doctor` to check installation, version and resource consistency.
When does the plugin activate in Codex?
When explicitly invoked or when resuming an existing change. It does not enable automatic session-start injection in Codex.
Can a small fix start without a plan?
Yes. The direct path is for a well-scoped task with reproducible verification. Scope growth can move it to an approved plan.
What happens when verification fails?
The task remains unfinished. The agent fixes the problem and runs verification again; a failed check cannot be recorded as success.
Discussion
No questions or reviews yet.
Related
PluginsA plugin with three skills for large development work: project analysis, phased tasks tracked as GitHub Issues, parallel agents and code review
A CLI that wires a research-to-delivery pipeline with documents and quality gates into Claude Code, Cursor, Codex and other agents
A skill that runs a long task as a package with verifiable steps and on-disk state, so work resumes in a new session.
A workflow layer for a coding agent: from a task to a pull request with evidence, reviewed by a different model at every handover
A CLI for spec-driven development: the agent carries a task through files in the repository from plan to verification and archive
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| spec-superflow (this card) | no | 879 | |
| Superpowers | no | 313,096 | offers development skills with automatic selection according to the situation |
| Birdview | no | 675 | A skill maps project architecture, rules and proposed edit scope in an HTML page so users can approve a plan before code changes. |
| Bkit | no | 605 | A Claude Code plugin links planning, implementation and task checks, retains progress and controls how independently agents work. |
README in short
Version 2.1.0 reduces mandatory documents for a new task. Skills update together with their matching CLI, avoiding an unrelated old `ssf` installation on the system.