Network of 7 AI tool nodes connected to a central amber anvil
Chapter 12

Multi-Agent Setup

One setup, all agents. Configure Plan Forge for 7 AI tools.

One Setup, All Agents

Terminal
# Add all agent adapters at once
.\setup.ps1 -Preset dotnet -Agent all

# Or pick specific agents
.\setup.ps1 -Preset dotnet -Agent claude,cursor

Copilot files are always installed. The -Agent flag adds native files for other tools — each with all 16 guardrail files embedded, prompts as native skills/commands, and 19 reviewer agents as invocable procedures.

Feature Parity Matrix

FeatureCopilotClaudeCursorCodexGeminiWindsurfGeneric
Auto-loading instructions✅ Native✅ Emulated✅ Emulated⚠️ Manual✅ Emulated✅ Emulated
Pipeline agents✅ 6✅ Skills✅ Commands✅ Skills✅ Commands✅ Workflows
Reviewer agents✅ 19✅ 19✅ 19✅ 19✅ 19✅ 19
MCP tools✅ 18✅ 18✅ 18⚠️ Partial⚠️ Partial⚠️ Partial
Full Auto execution⚠️
Lifecycle hooks✅ Emulated
Memory bridge✅ OpenBrain✅ Native⚠️⚠️⚠️⚠️

GitHub Copilot (Default)

Native integration. Instruction files auto-load via applyTo. Agents appear in the agent picker. Skills invoke via /slash-command. Hooks run automatically. This is the reference implementation — all other agents emulate this behavior.

Key file: .github/copilot-instructions.md

Claude Code

All guardrails embedded in a single CLAUDE.md file. Claude Code reads this automatically at project root. Includes 33+ skills as slash commands, full auto mode, and memory hooks.

Key file: CLAUDE.md

Setup
.\setup.ps1 -Preset dotnet -Agent claude

Cursor

Rules written to .cursorrules and .cursor/rules/*.mdc. Cascade integration loads rules automatically based on file patterns.

Key files: .cursorrules, .cursor/rules/

Codex CLI

Skills as executable scripts in .agents/skills/. Terminal-based execution with all pipeline steps available.

Key file: AGENTS.md

Gemini CLI

Guardrails embedded in GEMINI.md. Commands as .gemini/commands/*.toml files for /planforge-* invocations.

Key files: GEMINI.md, .gemini/commands/

Windsurf

Rules in .windsurfrules and .windsurf/rules/*.md with trigger frontmatter. Workflows mapped to Cascade integration.

Key files: .windsurfrules, .windsurf/rules/

Generic (Any AI Tool)

A single AI-ASSISTANT.md file with copy-paste guardrails. Works with ChatGPT, Ollama, or any tool that accepts text prompts.

Key file: AI-ASSISTANT.md

Cloud Agent

GitHub's Copilot cloud agent uses the same copilot flag — no separate adapter needed. Add copilot-setup-steps.yml to provision the agent's environment:

Terminal
cp templates/copilot-setup-steps.yml .github/copilot-setup-steps.yml

The cloud agent gets all guardrails, MCP tools, and pforge run-plan automatically.

Spec Kit Interop

If you use Spec Kit for specifications, Plan Forge picks up where your specs end. The setup wizard auto-detects existing Spec Kit files and imports them as context. Extensions marked speckit_compatible work in both frameworks.

📄 Full reference: AGENT-SETUP.md