forge-plugin

Forge Plugin

Framework for Organized Requirements & Guided Engineering

A Claude Code plugin that brings structured planning workflows to any engineering team. Forge guides discovery, requirements, design, and implementation — producing markdown artifacts that live alongside your code.

What Forge Provides

• Effort discovery — Explore problem spaces before committing to solutions
• Slice delivery — Break work into focused, shippable slices with requirements and design
• Implementation discipline — TDD, systematic debugging, and verification-before-complete built into every workflow
• Retro-driven improvement — Capture corrections as retro notes; apply them to improve your own guidelines and templates
• Self-contained — All planning artifacts live in .forge-context/ in your project repo, committed with your code

Installation

Add the marketplace and install the plugin:

claude plugin marketplace add flox/forge-plugin
claude plugin install forge

Recommended: Enable Agent Teams

Forge uses parallel agents for design research, code review, and multi-subsystem design. Enable Claude Code's experimental agent teams feature for the best experience:

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Or add to your Claude Code settings (~/.claude/settings.json):

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Without agent teams, Forge falls back to sequential sub-agents — it still works, but design exploration and code review run slower.

Quick Start

Three commands to get going:

/forge:init

Analyzes your project and scaffolds .forge-context/ with starter templates and context. This directory is committed to git — planning artifacts travel with your code so every team member shares the same context.

/forge:explore

Start an effort to explore a problem space and identify what to build.

/forge:work new

Start a delivery slice once you know what to build.

Documentation

• Why Forge — The problems Forge solves and how it's different
• Getting Started — Installation walkthrough and first effort/slice
• Workflow Overview — How efforts and slices work
• Command Reference — All commands with descriptions and arguments

Commands

Command	Purpose
/forge:init	Initialize Forge in your project
/forge:explore	Discover and understand problem spaces
/forge:work	Build and deliver focused slices
/forge:requirements	Run requirements gathering
/forge:design	Run the design phase
/forge:implement	Ad-hoc changes without slice ceremony
/forge:investigate	Investigate bugs and issues
/forge:start-task	Start work on implementation tasks
/forge:retro-note	Capture a process observation
/forge:improve	Apply retro notes as improvements
/forge:phase-complete	Complete a slice phase
/forge:audit	Health checks on work and context
/forge:digest	Activity digest
/forge:reviewable	Restructure commits for review
/forge:process-pr-discussions	Process PR discussions

What's Included

Type	Count	Purpose
Commands	15	Slash commands for the full workflow
Agents	18	Subagents for requirements, design, review, and more
Skills	22	Reusable knowledge modules
Templates	11	Scaffold templates copied to your project

Contributing

See CONTRIBUTING.md for how to add commands, agents, and skills.

License

Apache 2.0. See LICENSE.