Repository navigation
Home
Context-engineered development workflow for Claude Code, Cursor IDE, GitHub Copilot CLI, OpenAI Codex, and Google Jules.
Plan-Build-Run (PBR) keeps your main orchestrator under ~15% context usage by delegating heavy work to fresh subagent contexts, each getting a clean 200k token window. All state lives on disk in .planning/. Sessions are killable without data loss.
Works in Claude Code, Cursor IDE, GitHub Copilot CLI, OpenAI Codex, and Google Jules with shared .planning/ state -- start a project in one, continue in another. Four derivative plugins (cursor-pbr, copilot-pbr, codex-pbr, pbr) keep platform-specific formats in sync automatically.
| Component | Count |
|---|---|
| Slash commands | 41 (/pbr:*) |
| Specialized agents | 14 (each with terminal color coding) |
| Hook scripts | 49 across 16 event types |
| Skills | 28 |
| Shared skill fragments | 12 |
| Derivative plugins | 4 |
Additional capabilities in v2.0.0:
-
Dashboard -- Vite + React 18 web UI with Express backend and live WebSocket updates for browsing
.planning/state - Status line -- Real-time project state in Claude Code's status bar (phase, plan, context budget)
- Hook server -- Persistent HTTP server with circuit breaker for high-throughput hook execution
- Local LLM offloading -- Route mechanical hook inference to Ollama, keeping API costs near zero
- Agent colors -- Each of the 14 agents has a branded terminal color for visual identification
-
Branded statusMessages -- Every hook displays a
"* PBR: ..."status message in the Claude Code UI
| Platform | Plugin | Status |
|---|---|---|
| Claude Code |
plan-build-run (native) |
Full support |
| Cursor IDE | cursor-pbr |
Full support |
| GitHub Copilot CLI | copilot-pbr |
Full support |
| OpenAI Codex | codex-pbr |
Full support |
| Google Jules | Shared .planning/ state |
Interoperable |
All platforms share the same .planning/ directory and can hand off work mid-session.
| Page | What's in it |
|---|---|
| Commands | All 41 slash commands with flags and descriptions |
| Architecture | How the orchestrator/agent/hook system works |
| Agents | 14 specialized agents with colors and model rationale |
| Configuration | 19+ config sections, depth/model profiles, local LLM, dashboard, hook server |
| Hooks | 49 hook scripts across 16 event types that enforce discipline at zero token cost |
| Project Structure | The .planning/ directory layout |
| Dashboard | Web UI for browsing project state |
| Cursor IDE | Installation, setup, and cross-plugin compatibility |
| Copilot CLI | GitHub Copilot CLI plugin: installation, hooks, and differences |
| Philosophy | Design principles and platform alignment strategy |
| What Sets It Apart | Feature comparison and key differentiators |