plan2code

A spec-driven workflow for AI coding agents. Send the plan — the build follows.

Plan2Code turns an approved plan into a set of phase documents in your repository, then has the coding agent build against those documents one phase at a time. Progress lives in files instead of chat history, so the next session, the next agent, and the next engineer all start from the same specs. The workflow is six commands, each posted separately, two of which are optional. It installs as Agent Skills through the skills CLI and works with every agent that CLI supports, including Claude Code, Cursor, GitHub Copilot, Windsurf, Codex, and Gemini CLI. It is written in TypeScript, released under MIT, and requires Node.js 18 or later.

Install

Requires Node.js 18 or later and network access — installation runs through the skills CLI. Re-run any time to update.

npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git

This fetches the installer to a temp directory, builds the workflow as Agent Skills, delegates installation to skills add, and cleans up after itself. The installed skills work independently from then on.

Either route lands you on the same menu:

╔═════════════════════════════════════════════════════════╗
║ INSTALL PLAN2CODE                                       ║
╠═════════════════════════════════════════════════════════╣
║  I.  INSTALL    Install Plan2Code skills everywhere     ║
║  A.  ALL        Install Plan2Code + dev tools           ║
║  U.  UNINSTALL  Remove Plan2Code skills and dev tools   ║
║  C.  CUSTOM     Advanced options                        ║
║  Q.  QUIT       Exit                                    ║
╚═════════════════════════════════════════════════════════╝

Supported tools: every agent supported by the skills CLI, including Claude Code · Cursor · GitHub Copilot · Windsurf · Codex · Continue · Codeium · Zed · Amp · OpenCode · Devin · Crush · Pi · Gemini CLI · Cline · Roo · Kilo · Goose · Trae · Qwen Code.

The installer keeps one canonical copy of each skill under ~/.agents/skills/ and links it into agents that maintain their own directory. Update later with npx skills update -g.

Use the installer rather than calling skills add against the repository root: recursive discovery would also find maintainer-only skills under .claude/skills/. The installer targets skills/ explicitly.

Prefer to clone? 
git clone https://github.com/jparkerweb/plan2code.git
cd plan2code
node install.js

# Only if you plan to modify or contribute to Plan2Code itself
npm install && npx husky