devsforge

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:

1. Claim the next task from queue (with exclusive lock)
2. Work iteratively until criteria pass
3. Auto-advance to the next task
4. 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