FIRST BUILD

Step 2 of 3

Before you build, you need a plan. The PRD is your plan. It tells the agents what to build, what stack to use, and how to deploy. A good PRD is the difference between a successful mission and chaos. Let me show you.

Picard

WRITE YOUR PRD

Create a file at docs/PRD.md in your project. Every PRD starts with a YAML frontmatter block that tells VoidForge your project's shape:

---
name: "my-app"
type: "full-stack"
framework: "next.js"
database: "postgres"
auth: yes
payments: stripe
deploy: "vercel"
---

## 1. Product Vision
- **Name:** My App
- **One-liner:** What your app does in one sentence.
...

The frontmatter determines which of the 13 phases apply. Set auth: no and Phase 3 is skipped. Set payments: none and the payment integration section is skipped.

RUN /BUILD

Open your terminal, navigate to your project directory, and launch Claude Code:

# In your terminal:

cd my-project

claude

This launches Claude Code. It automatically reads the CLAUDE.md file in your project, which loads the entire VoidForge methodology. Inside Claude Code, type:

# Inside Claude Code:

/build

Picard reads your PRD. Stark and Kusanagi scaffold the project. The agents work through each phase, writing code, running tests, and verifying gates. Every decision is logged to /logs/.

Tip: /build runs a single build pass. For full PRD-to-production workflows, use /campaign — it breaks the PRD into missions, runs /assemble for each, and finishes with a Victory Gauntlet.

How slash commands work: Every VoidForge command starting with / is a slash command inside Claude Code. You type them at the Claude Code prompt, not your system terminal. Launch Claude Code with claude in your terminal first, then type /build, /campaign, /gauntlet, etc.

Agent dispatch: The Silver Surfer pre-scans your code and selects the optimal agent team automatically. Use --focus "security" to bias toward a specific domain, or --solo for lead agent only.

THE BUILD JOURNAL

Every phase produces a log file. When context gets heavy or you start a new session, agents read the journal to recover state. Check /logs/build-state.md to see where you are.