---
name: forge:convert
description: Convert GSD project to FORGE format.
argument-hint: [--dry-run] [--force]
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
  - Bash
  - Task
  - TeamCreate
  - AskUserQuestion
---

Convert existing GSD project to FORGE format, preserving roadmap and phase context.

**GSD → FORGE mapping:** PROJECT.md → CLAUDE.md | ROADMAP.md → preserved | .planning/phases → STATE.json tasks

**Steps:**

1. Detect GSD project (PROJECT.md, ROADMAP.md, .planning/)
2. If `--dry-run`, preview changes and exit
3. Create FORGE structure: state/STATE.json, state/events/, contracts/, .planning/forge.config.json
4. Generate CLAUDE.md from PROJECT.md with FORGE architecture patterns
5. Extract tasks from phase plans into STATE.json
6. If no AgentTeam.md, analyze codebase and generate one. Create team with TeamCreate.
7. Verify with `/forge:status`

Use `--force` to overwrite existing FORGE files.