Start

Start

Initiate a new Forge workflow. Check for existing workflow state in .forge/, create a new workflow if none exists, and hand off to discover-intent to begin collaborative refinement of what to build. User-invoked only: do not auto-trigger this skill.

Usage

/forge:start [description]

The optional [description] is a short phrase describing what the user wants to build. It becomes the initial intent field in forge-state.json and seeds the first discover-intent question.

If an active workflow exists, ask the user whether to resume or archive the existing one. Never decide unilaterally.

Process

1. Check .forge/forge-state.json for existing workflow state.
2. If an active workflow exists, show its current phase and progress, then ask the user whether to resume or archive.
3. If no workflow or user chose archive, create .forge/ directory and write a fresh forge-state.json using the initialization template (current_phase: discovery, phases_completed: [], created_at: <now>).
4. Record the user's [description] argument (if provided) as the initial intent.
5. Invoke the discover-intent skill to begin Phase 1.

Evidence

• .forge/forge-state.json exists with current_phase: discovery after this skill runs.
• discover-intent is the next active skill.

Transitions

• → discover-intent: Workflow state is initialized. Hand off to discovery phase.