Home

Foundry Wiki

Deep technical documentation for the Foundry plugin — an AI-powered task lifecycle tool for GitHub Copilot CLI.

For usage and examples, see the README.

---

Navigation

Core Concepts

• RALPH Loop — The self-correcting iteration engine powering both Crucible and Forge
• Harness Engineering — Multi-model convergence: how 3 AI models negotiate a single plan
• Task Complexity — How Foundry adapts ceremony to task size

Skills

• Crucible — Multi-model planning refinement (Phases 1–7)
• Forge — Autonomous code execution (Phases 1–7)

Internals

• Agent Specifications — All 7 agents: inputs, outputs, dispatch patterns
• Safety and Recovery — Hard caps, resume, rollback, build gates
• File Layout — Where every file lives and why
• Version History — Changelog from v1.0.0 to present

---

Architecture at a Glance

Crucible (planning)  →  Forge (execution)
─────────────────       ─────────────────
Task description        plan.md (always)
Architecture doc   →    design-doc.md (large tasks only)
Codebase context        architecture doc (large tasks only)
                        ↓
                        Committed & pushed code
                        (user creates PR)

Both skills share a single directory per task: ~/.copilot/foundry/<task-slug>/

Compatibility

Copilot CLI only. Foundry requires multi-model orchestration (dispatching parallel agents to Claude, Codex, and Gemini) which is only available in GitHub Copilot CLI. It does not work with Claude Code, Claude Desktop, or other single-model interfaces.