Theme
Architecture
This section is the current architectural truth for Forge. Start with the overview, then open deeper pages when a course lesson points you there.
The most important rule is that boundaries carry meaning: a Task is not an Agent Run, an Agent Adapter is not an Execution Environment, durable intent is recorded before external side effects, and live streaming data is not historical read state.
Recommended order
- Overview
- Domain model
- State machines
- Data model
- Operations and recovery
- Agent system
- Execution environments
- Git and worktrees
- Non-negotiables
The remaining pages cover RPC, realtime sync, security, testing, performance, paths, and observability.