workspine
v0.35.1
Published
Workspine is a harness for AI coding agents: it runs a spec-driven plan, execute, verify loop and keeps plans, decisions, and proof as files in your repo. Published as workspine.
Maintainers
Readme
Workspine
A coding agent can move fast while quietly guessing what you meant. The next session may guess again. Tests can pass while the result is still wrong.
An AI development harness for coding agents.
It brings decisions to you and keeps development consistent across agents and sessions.

npx -y workspine setupSetup adds Workspine to the current repository. Then choose one route:
work-quickfor one bounded change.work-planfor a change that needs a plan, implementation, and verification.work-new-projectfor a new project or a new roadmap milestone.
What you keep
Workspine records the plan, the decisions you approve, what changed, and what was verified in .work/
in your repo.
The chat can end. The decisions stay with the work.
If you already have a legacy .planning/ workspace, setup offers a byte-preserving move to .work/
and explains why. It never migrates silently, and declining leaves the old files untouched.
Use Workspine
Quickstart
Ask your coding agent to run one of the three routes above. Use its slash command or skill reference
when it discovers the installed skills. If discovery is unavailable, open
.agents/skills/work-<workflow>/SKILL.md and follow it directly.
Use npx -y workspine health to check the installation and npx -y workspine update to repair
generated files. Both are network-free.
Install it, try one real change, and report any friction.
Details
- User Guide for every workflow and command.
- Runtime Support for tool-specific installation and invocation.
- Verification Discipline for what the checks do and do not establish.
- Changelog for migration and compatibility notes.
Workspine requires Node >=22. The compatibility command workspine init remains available in
0.35.0. The gsdd binary alias is removed in the next minor release.
MIT. See LICENSE.
