+
-## Overview
+**A spec-driven workflow for AI coding agents. Send the plan β the build follows.**
-```
- π€ π β‘ π§Ή
-βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
-β Step 1 β β Step 2 β β Step 3 β β Step 4 β
-β PLAN β --> β DOCUMENT β --> β IMPLEMENT β --> β FINALIZE β
-βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
- New Chat New Chat New Chat (per phase) New Chat
-```
+An AI agent is a fine builder and a terrible client. Plan2Code stops making it both: you approve a
+plan, the plan becomes a set of phase documents in your repo, and the agent builds to 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.
-| Command | When to Use |
-|----------------------------------|----------------------------------------------------------|
-| `/plan2code-init` | Generate AGENTS.md file for new/existing projects |
-| `/plan2code-init-update` | Update AGENTS.md with new learnings from coding sessions |
-| `/plan2code-quick-task` | Small, quick tasks that don't need full workflow |
-| `/plan2code-review` | Post-phase code review (after key features or milestones)|
-| `/plan2code-1-plan` | Starting a new feature (full planning) |
-| `/plan2code-1b-revise-plan` | Requirements change mid-implementation |
-| `/plan2code-2-document` | After planning, create implementation specs |
-| `/plan2code-3-implement` | Execute implementation (one phase per conversation) |
-| `/plan2code-4-finalize` | All phases complete, ready to archive |
-| `/plan2code-handoff` | Compact the conversation into a handoff doc for a fresh session |
+Six commands, each posted separately. Two of them are optional.
-**Key Rules:**
-- Start NEW conversation for each step (and each implementation phase)
-- ONE phase per conversation
-- Reply "approved" to complete phases
-- 90% confidence required before planning completes
-
-See [QUICK-REFERENCE.md](QUICK-REFERENCE.md) for full reference card.
+Version 2.0.0 Β· MIT Β· π [plan2code.jparkerweb.com](https://plan2code.jparkerweb.com)
---
-## Installation
+## Install
-Plan2Code includes an interactive installer that generates and installs workflow files for all major AI coding assistants.
-
-
-
-### Prerequisites
-
-The install script requires **Node.js** (v14 or later). If you don't have Node.js installed:
-
-1. Download from [nodejs.org](https://nodejs.org/) (recommended)
-2. Or use a package manager:
- - **macOS:** `brew install node`
- - **Windows:** `winget install OpenJS.NodeJS` or `choco install nodejs`
- - **Linux:** `sudo apt install nodejs` (Debian/Ubuntu) or `sudo dnf install nodejs` (Fedora)
-
-### Supported Platforms
-
-- Claude Code
-- Cursor
-- Windsurf
-- Continue
-- Codeium (IntelliJ)
-- GitHub Copilot CLI
-- VS Code GitHub Copilot
-- Gemini CLI
-- Crush
-- Pi (pi.dev)
-- Amp
-- OpenCode
-- Devin
-- Zed
-
-### Install via npx (Recommended β No Clone Required)
-
-Run the interactive installer directly using `npx` with your preferred GitHub authentication method:
+Requires [Node.js](https://nodejs.org/) 14 or later. Re-run any time to update.
```bash
-npx git+https://code.jparkerweb.com/jparkerweb/plan2code.git
+npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git
```
-This downloads the installer to a temporary location, runs it, installs the workflow files to your machine, and cleans up automatically. The installed workflows remain on your system and work independently. To update or reinstall, simply run the command again.
+This fetches the installer to a temp directory, runs it, writes the slash commands for whichever
+tools you pick, and cleans up after itself. The installed commands work independently from then on.
-### Standard Installation (Clone Method)
+Either route lands you on the same menu:
-#### No Clone Required
-
-Run the interactive installer directly using `npx` with your preferred GitHub authentication method:
-
-```bash
-npx git+https://code.jparkerweb.com/jparkerweb/plan2code.git
+```
+βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
+β INSTALL PLAN2CODE β
+β ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
+β I. INSTALL Install Plan2Code for all platforms β
+β A. ALL Install Plan2Code + dev tools β
+β U. UNINSTALL Remove Plan2Code files β
+β C. CUSTOM Advanced options β
+β Q. QUIT Exit β
+βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
```
-This downloads the installer to a temporary location, runs it, installs the workflow files to your machine, and cleans up automatically. The installed workflows remain on your system and work independently. To update or reinstall, simply run the command again.
+**Supported tools:** Claude Code Β· Cursor Β· Windsurf Β· Continue Β· Codeium (IntelliJ) Β·
+GitHub Copilot CLI Β· VS Code Copilot Β· Crush Β· Pi Β· Amp Β· OpenCode Β· Devin Β· Zed
-#### Standard Installation (Clone Method)
+The AI workflow that puts planning first
- - - Get the Code - + + + + + + +Spec-driven workflow for AI coding agents
+Addressed to
+Anyone who has watched an AI agent confidently build the wrong thing. You approve a plan, it becomes phase documents in your repo, and the agent works to those documents one phase at a time.
- Have natural back and forth conversations with AI to analyze your requirements and design the solution. Iterate until you reach a minimum of 90% confidence in your agreed upon plan. -
-- Transform your plan into structured, actionable implementation specs. Break work into phases with clear tasks any developer could follow. -
-- Execute the implementation following specs exactly. By following one phase per conversation, context is kept clean, focused, and efficient. -
-/plan2code-0-pathfinder
+ For an idea that arrives too foggy to plan. It charts the idea as a map of decision questions and clears exactly one per session until nothing is left to decide.
+it never answers its own questions β that's the point
+- Optional post-implementation code review. An independent senior-engineer second opinion that questions assumptions and surfaces defects with fresh eyes — recommended after key features or milestones. -
-/plan2code-1-plan
+ A real back-and-forth about what gets built. Requirements pulled apart, your codebase actually read, the stack confirmed rather than assumed.
+- Validate the implementation, create summaries, and archive documentation. Ensure nothing was missed and the project is properly closed out. -
-/plan2code-2-document
+ The plan stops being a conversation and becomes files β an overview plus one self-contained phase document per phase, cut into one-story-point tasks.
+/plan2code-3-implement
+ Build to the drawing, one phase per conversation. Planning context bleeding into implementation is where most agent drift starts.
+reply βapprovedβ β nothing advances on a guess
+/plan2code-review
+ An independent senior engineer with fresh eyes and no attachment to the code that just shipped. It reads every changed file completely and reports only what it can prove β file, line, and a concrete fix.
+Run the install script to copy the Plan2Code prompts to your AI assistant workflow directories. Works with Claude Code, Cursor, GitHub Copilot, Windsurf, and more.
-# Clone the repository -git clone https://code.jparkerweb.com/jparkerweb/plan2code.git ++ Req -# Navigate to the directory -cd plan2code +
04 +Finalize
+/plan2code-4-finalize+Close it out. Every task audited against the spec it came from, a summary of what was built, docs checked for drift, and the folder filed away.
++
+- Audit for tasks quietly left open
+- Summary of what was built and changed
+- README and other docs reconciled
+- Specs archived to specs--completed/
+
- Describe your feature or project. The AI will work through planning phases until reaching 90% confidence in the solution.
-New conversation for each step:
-Clean context, maximum clarity!
-Transform your AI development workflow today
-A fresh conversation for each step, and each implementation phase.
No code until the plan hits 90% confidence. The gate does not negotiate.
Checkboxes are the state, not the chat. Any session resumes cold.
Reply approved to close a phase. Nothing advances on a guess.