Claude Code workflow orchestration engine. Composes existing plugins into a unified development workflow.

Stack Forge discovers your installed Claude Code plugins (Superpowers, feature-dev, code-review, etc.) and generates an orchestration workflow that chains them together automatically. It includes health checks to ensure providers are working correctly before starting a workflow.

# Install
npm install -g cforge

# Initialize (zero-config)
cforge init

# Start a workflow
cforge                    # default: feature
cforge feature "add auth" # explicit
cforge bugfix "fix login" # explicit

1. cforge init scans your system for installed plugins
2. Auto-installs missing required providers
3. Runs health checks to verify providers are working
4. Generates an orchestration skill + stage skills
5. cforge triggers the orchestration skill
6. The skill forks subagents for each stage automatically
7. Stages: Brainstorm → Spec → Plan → Build → Review → Release
8. Implementation stage uses parallel execution for independent tasks

The Implementation stage automatically detects independent tasks and executes them in parallel:

# tasks.md example
- [ ] Task 1: Modify src/discovery/scanner.ts
- [ ] Task 2: Modify src/generator/templates.ts
- [ ] Task 3: Modify src/cli/generate.ts
- [ ] Task 4: Modify src/discovery/scanner.ts (depends on Task 1)

Automatic batching:

• Tasks 1, 2, 3 → Batch 1 (parallel, no file conflicts)
• Task 4 → Batch 2 (serial, depends on Task 1)

Benefits:

• 3x faster for independent tasks
• Automatic conflict detection
• Each task follows TDD workflow
• Full test suite validation at end

Set environment variable for verbose logging:

CFORGE_LOG_LEVEL=debug cforge <command>

cforge CLI
  ├── Provider Discovery (scan plugins)
  ├── Health Check (verify providers)
  ├── Config Generator (skills, commands, CLAUDE.md)
  ├── Schema Validation (Zod)
  └── State Management (state.json with backup)

Claude Code Runtime
  ├── Orchestration Skill (state machine + fork)
  │   └── Stage Skills (context: fork isolation)
  └── Provider Delegation
      ├── Superpowers (brainstorm, planning)
      ├── feature-dev (specification)
      ├── code-review (review)
      └── gstack (release)

MIT