Disclaimer: FORGE is an independent, community-developed open-source project. It is not affiliated with, endorsed by, or officially associated with Anthropic, PBC or any of its products (including Claude, Claude Code, or the Claude API). "Claude" and "Anthropic" are trademarks of Anthropic, PBC. This project is a third-party plugin built by the community to extend Claude Code functionality.
FORGE
Specification-Driven AI Development Engine for Claude Code
FORGE transforms Claude Code into a powerful iterative development system that autonomously works on complex tasks through formal specifications, structured planning, and completion criteria verification.
Features
- Specification-Driven Development - Formal specs with requirements, criteria, and clarification
- Structured Planning - Break down specs into tasks with dependencies
- Multi-Criteria Completion - Tests, coverage, lint, file checks, custom scripts
- Intelligent Stuck Detection - Automatic recovery with multiple strategies
- Checkpoints & Rollback - Git-based snapshots, never lose progress
- Control Center - Web dashboard for real-time monitoring
- Dark/Light Theme - System preference detection with manual toggle
- Task Queue - Schedule, prioritize, and auto-advance through tasks
- Sync v2 Protocol - Conflict-free sync with optimistic locking
- Task Locking - Exclusive execution with heartbeat renewal
- Intervention System - Pause, abort, retry tasks from Control Center
- Batch Mode - Process entire queue autonomously
Quick Start
1. Clone and Build
git clone https://github.com/devsforge/Forge.git
cd Forge
pnpm install
pnpm build
2. Install Plugin in Claude Code
# Add the marketplace
/plugin marketplace add devsforge/forge
# Install the plugin
/plugin install forge@devsforge
Or for local development, add to ~/.claude/settings.json:
{
"plugins": [
"/path/to/Forge/packages/plugin"
]
}
The plugin provides:
- Stop Hook - Intercepts exit to check completion criteria
- Commands - All
/forge:* slash commands (21 total)
3. Start Control Center
cd /path/to/Forge
pnpm dev:server
# Opens at http://127.0.0.1:3344
Or run directly:
node packages/server/dist/index.js
4. Register Project
/forge:forge-register
This creates .forge.json and registers your project with Control Center.
5. Create a Specification
/forge:forge-spec "Add user authentication with JWT tokens"
This creates a formal specification with:
- Requirements analysis
- Acceptance criteria
- Technical considerations
- Clarifying questions
6. Create Implementation Plan
/forge:forge-plan spec-001
Generates a detailed plan with:
- Architecture decisions
- Task breakdown with dependencies
- Success criteria per task
7. Queue Tasks
/forge:forge-queue --plan plan-001
8. Execute
# Single task mode (interactive)
/forge:forge
# Batch mode (process entire queue autonomously)
/forge:forge-batch
FORGE will:
- Claim the next task from queue (with exclusive lock)
- Work iteratively until criteria pass
- Auto-advance to the next task
- Repeat until queue is empty
Commands
Workflow
| Command | Description |
|---|
/forge:forge-spec "desc" | Create specification from description |
/forge:forge-plan SPEC_ID | Create implementation plan |
/forge:forge-queue --plan PLAN_ID | Queue tasks for execution |
/forge:forge | Start single task execution |
/forge:forge-batch | Process entire queue autonomously |
/forge:forge-adopt TASK_ID | Formalize WebUI tasks into spec workflow |
/forge:forge-request | Process pending WebUI requests |
/forge:forge-done | Mark current task as manually completed |
Control
| Command | Description |
|---|
/forge:forge-pause | Pause the current loop |
/forge:forge-resume | Resume a paused loop |
/forge:forge-abort | Abort and exit |
Checkpoints
| Command | Description |
|---|
/forge:forge-checkpoint | Create manual checkpoint |
/forge:forge-rollback | Rollback to checkpoint |
Sync
| Command | Description |
|---|
/forge:forge-register | Register with Control Center |
/forge:forge-link PROJECT_ID | Link to existing project |
/forge:forge-sync | Full bidirectional sync |
Info
| Command | Description |
|---|
/forge:forge-status | Check current status |
/forge:forge-history | View iteration history |
/forge:forge-tasks | List tasks |
/forge:forge-help | Show help |
Control Center
Access the web dashboard at http://127.0.0.1:3344
Pages
