Appendix B
Quick Reference Card
Printable cheat sheet. Ctrl+P for a clean print.
CLI Commands
| Command | Description |
|---|
pforge init | Bootstrap project with setup wizard |
pforge check | Validate setup files |
pforge smith | Diagnose environment + setup health |
pforge status | Show phase status from roadmap |
pforge new-phase <name> | Create new phase plan + roadmap entry |
pforge branch <plan> | Create git branch from plan |
pforge commit <plan> <slice> | Auto-generate conventional commit |
pforge phase-status <plan> <status> | Update phase status in roadmap |
pforge sweep | Scan for TODO/FIXME markers |
pforge diff <plan> | Compare changes vs scope contract |
pforge analyze <plan> | Consistency scoring (0–100) |
pforge diagnose <file> | Multi-model bug investigation |
pforge run-plan <plan> | Execute plan (auto/assisted/estimate) |
pforge ext search|add|list|remove | Extension management |
pforge update | Update framework files |
pforge help | Show all commands |
pforge tour | Interactive guided walkthrough |
Pipeline Steps
| Step | Name | Session | Agent |
|---|
| 0 | Specify | 1 | specifier |
| 1 | Pre-flight | 1 | — |
| 2 | Harden | 1 | plan-hardener |
| 3 | Execute | 2 | executor |
| 4 | Sweep | 2 | — |
| 5 | Review | 3 | reviewer-gate |
| 6 | Ship | 4 | shipper |
Key Files
| File | Purpose |
|---|
.forge.json | Project config (preset, models, escalation, quorum) |
.github/copilot-instructions.md | Master config — loads every session |
.github/instructions/*.instructions.md | Auto-loading guardrails (15–18 files) |
.github/agents/*.agent.md | Reviewer agents (19 total) |
.github/prompts/step*.prompt.md | Pipeline prompt templates |
.github/skills/*/SKILL.md | Slash command skills (13 total) |
.github/hooks/ | Lifecycle hooks (4 files) |
docs/plans/DEPLOYMENT-ROADMAP.md | Phase tracker |
docs/plans/PROJECT-PRINCIPLES.md | Non-negotiable commitments |
.forge/runs/ | Execution history, traces, logs |
.forge/cost-history.json | Aggregate cost data |
Ports & URLs
| Port | URL | Purpose |
|---|
| 3100 | localhost:3100/dashboard | Dashboard UI + REST API |
| 3100 | localhost:3100/ui | Read-only plan browser |
| 3101 | ws://localhost:3101 | WebSocket real-time events |
Key Flags
| Flag | Command | Effect |
|---|
--estimate | run-plan | Cost prediction only |
--assisted | run-plan | Human codes, orchestrator validates |
--resume-from N | run-plan | Skip completed slices |
--quorum | run-plan | Multi-model consensus |
--dry-run | most commands | Preview without executing |
-Agent all | init/setup | Generate files for all AI tools |