---
name: forge:generate
description: Generate a FORGE artifact from templates.
argument-hint: <artifact-name> [-f]
allowed-tools:
  - Read
  - Write
  - Bash
---

Generate artifact $ARGUMENTS (claude, project, requirements, roadmap, plan, config, rules).

**Read:** state/STATE.json, src/templates/

**Artifact mapping:** claude→CLAUDE.md | requirements→REQUIREMENTS.md | roadmap→ROADMAP.md | plan→PLAN.md | config→.planning/forge.config.json | rules→.claude/rules/*.md

**Steps:**

1. Load context from STATE.json (projectName, version, tasks, milestones). Error if required fields missing.
2. Render template. Check token limits: CLAUDE.md ~2000, REQUIREMENTS.md ~4000, PLAN.md ~6000, rules ~1000 each.
3. Backup existing file (unless `-f` flag), write artifact, verify format.