🚀 Getting Started
The Manual — Start Here
The complete Plan Forge book. 14 chapters + 5 appendices — from zero to advanced execution. If you read one thing, read this. For the system-wide overview of the inner loop see The Self-Deterministic Agent Loop.
README
Project overview, quick start, feature tour, the 4-layer system explained.
Quickstart Walkthrough
Step-by-step guide to your first feature build using the full pipeline.
Agent Setup
Entry point for AI agents. Auto-detect stack, non-interactive setup, greenfield & brownfield paths.
Customization Guide
Project profile, principles workshop, layer conflict resolution, org-rules template.
📖 Guides
VS Code + Copilot Guide
Agent Mode, instruction auto-loading, context budget management, memory bridging, troubleshooting.
Setup Guide
Clone the repo and run the setup wizard. Installs guardrails, agents, prompts, skills, and MCP tools into your project.
CLI Guide
All pforge commands — init, check, smith, status, new-phase, branch, commit, sweep, diff, audit-loop, ext install.
GitHub Action
Automate plan validation in CI. Add uses: srnichols/plan-forge-validate@v1 to your PR workflow.
Extensions Guide
Create, distribute, and install reusable guardrail packages for your team.
Unified System Architecture
How Plan Forge + OpenBrain + OpenClaw integrate into a complete AI development system.
Spec Kit + Plan Forge
Combined workflow, shared extension model, artifact auto-import. Write specs with Spec Kit, enforce them with Plan Forge.
MCP Server
17 forge tools as native MCP functions. Auto-configured. Includes forge_run_plan (autonomous execution), forge_analyze + forge_diagnose (multi-model analysis), forge_cost_report (cost tracking), forge_capabilities (agent discovery), dashboard at localhost:3100/dashboard, and OTLP-compatible trace viewer.
Dashboard Guide
Visual tour of all 37 dashboard tabs across 4 groups (Forge, LiveGuard, Forge-Master, Settings) — progress tracking, cost charts, session replay, OTLP traces, actions, config, skills, extensions, watcher live feed, and the LiveGuard section.
🔨 Pipeline Reference
Plan Hardening Runbook
The complete runbook — how each step works, what it checks, when to skip or run full.
Runbook Instructions (Copy-Paste)
Ready-to-copy prompts for every pipeline step. Works in any AI tool, not just VS Code.
Deployment Roadmap Template
Phase tracker template for managing multiple features across the pipeline.
Stack Examples
Real plan files for .NET, TypeScript, Python, Java, Go — with slices, gates, and code output.