Staged, multi-model PRD execution for OpenClaw. Write a PRD with phased sections, model routing, and validation gates — OpenForge executes it across local and cloud models with automatic escalation, scope verification, quality checks, and learning accumulation. Route simple tasks to cheap models, hard tasks to powerful ones, and reviews to premium reasoning.
OpenForge turns structured PRD documents into staged, multi-model execution runs. Each phase routes to the right AI model — local models for simple coding, cloud models for complex work, premium models for review — with automatic escalation, per-task quality checks, and accumulated learning across tasks.
uv (astral.sh package manager)gitopenclaw# 1. Install (one-time)
bash <skill_dir>/scripts/install.sh
# 2. Validate a PRD
<skill_dir>/scripts/openforge validate path/to/prd.md
# 3. Preview execution plan
<skill_dir>/scripts/openforge plan path/to/prd.md --cwd /path/to/project
# 4. Execute
<skill_dir>/scripts/openforge run path/to/prd.md --cwd /path/to/project
validateCheck PRD syntax, routing, and path overlaps.
<skill_dir>/scripts/openforge validate path/to/prd.md
<skill_dir>/scripts/openforge validate path/to/prd.md --json
<skill_dir>/scripts/openforge validate path/to/prd.md --lenient
planShow execution plan without dispatching.
<skill_dir>/scripts/openforge plan path/to/prd.md
<skill_dir>/scripts/openforge plan path/to/prd.md --cwd /path/to/project --json
runExecute the PRD.
<skill_dir>/scripts/openforge run path/to/prd.md --cwd /path/to/project
<skill_dir>/scripts/openforge run path/to/prd.md --cwd . --max-escalation 3
<skill_dir>/scripts/openforge run path/to/prd.md --cwd . --allow-dirty
<skill_dir>/scripts/openforge run path/to/prd.md --cwd . --phase scaffold
<skill_dir>/scripts/openforge run path/to/prd.md --cwd . --force-executor cloud
resumeResume an interrupted run.
<skill_dir>/scripts/openforge resume <run-id>
<skill_dir>/scripts/openforge resume <run-id> --force
status / listInspect runs.
<skill_dir>/scripts/openforge status <run-id>
<skill_dir>/scripts/openforge status <run-id> --json
<skill_dir>/scripts/openforge list
<skill_dir>/scripts/openforge list --json
PRDs are markdown documents with labeled YAML blocks for machine-readable config.
Required sections: # PRD: <title>, ## Objective, ## Scope (with ### In Scope),
## Routing, and one or more ## Phase: <id> sections with task blocks.
Each task can declare:
reads: — files the agent should examineproduces: — files the agent may modify (enforced at runtime)checks: — quality commands that must pass after the agent completescheck: — shorthand for a single check commandSee templates/ for examples:
prd-simple.md — single stage, minimalprd-full.md — multi-stage with all featuresprd-review-only.md — review existing codeSee references/prd-format.md for the complete format specification.
The routing table maps executor aliases to OpenClaw agents: