ForgeBuild the engineering control plane by building the engineering control plane.

A hand-held, learn-by-building course and the canonical engineering handbook for Forge.

Learn by building

36 ordered lessons. Every lesson advances the real Forge codebase instead of sending you through unrelated toy exercises.

Current truth stays small

Product, architecture, status, and design docs describe the system as it is now. ADRs preserve the deeper why.

Lessons from shipped tools

Architecture rules incorporate scar tissue from T3 Code, Sculptor, Emdash, Vibe Kanban, OpenHands, Mux, and related systems.

Agent-friendly by design

Humans get a navigable book; coding agents get clean Markdown, explicit boundaries, completion gates, and source references.

How to use this site

Start with Start Here, then follow the course one lesson at a time. Keep the current project state in the Status section. When a lesson links an architecture page, read that page at the moment you need it rather than trying to memorize the entire handbook up front.