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 setup

Setup adds Workspine to the current repository. Start with one small planned change:

1. Run work-plan so the agent turns the request into a checked plan.
2. Review the plan. Nothing executes until your explicit owner approval.
3. Run work-execute to implement the approved plan.
4. Run work-verify to check the result against it.

Use work-quick when the change is already understood and needs less ceremony. Use work-new-project when the project or milestone itself still needs shaping.

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 work-plan. 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. After you approve the plan, run work-execute, then work-verify.

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 throughout the 0.35.x release line. The gsdd binary alias is removed in the next minor release.

MIT. See LICENSE.