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 Claude Code in your project directory and type:

/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/.

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.