Handbook
Product Intersection Map
Platform-critical intersections
| Intersection | Purpose | Primary contract |
|---|---|---|
| Lenses <-> Blueprints | make repo policy visible and navigable | BlueprintContextPack |
| Lenses <-> LCDL | make governed reasoning visible | LCDLTraceSummary |
| Lenses <-> Fleet | make controlled execution visible | FleetJobSummary |
| Blueprints/Versonas <-> LCDL | turn discipline guidance into governed reasoning contracts | VersonaSessionReport |
| All products <-> Lenses | unify work through run/evidence state | ForgeRun, EvidencePacket |
| Local runner (alpha) <-> Lenses | approve-and-run bounded repo checks without Fleet | LocalRunnerAction, LocalRunnerResult, .forge/runs/ |
| Campaign orchestrator <-> Fleet | submit workspace, poll job, collect worker_result | FleetJobSummary, workspace upload meta |
| Campaign orchestrator <-> Lenses | ForgeRun + manifest + integrate/PR status | ForgeRun, EvidencePacket, AgentRun |
| Fleet UX worker <-> Fleet | in-container steps via workspace_worker bridge | worker_progress, worker_result |
| KS UX harness <-> forge-workcells | micro-agent run on fixture (--llm) |
WorkcellRequest, WorkcellResult, AgentRun |
| forge-workcells <-> LCDL | local LLM inference for micro-agent | LLM_* profile; LCDLTraceSummary when traced |
Agent-value intersections
| Intersection | Purpose | Primary contract |
|---|---|---|
| Hermes <-> Lenses | give Hermes perception and accountability | AgentRun, EvidencePacket |
| Hermes <-> Blueprints/Versonas | ground adaptive operator behavior in canonical policy | BlueprintContextPack, VersonaSessionReport |
| Hermes <-> LCDL | prevent important reasoning from staying unstructured | LCDLTraceSummary |
| Hermes <-> Fleet | give Hermes safe execution requests | FleetTemplate, FleetJobSummary |
Workcell expansion intersections
| Intersection | Purpose | Primary contract |
|---|---|---|
| Factory <-> Fleet | run implementation/review work in a controlled lane | WorkcellRequest, WorkcellResult |
| Factory <-> Blueprints/AGENTS.md | give Factory repo-local operating context | BlueprintContextPack |
| Factory <-> LCDL | verify implementation output independently | LCDLTraceSummary |
| OpenClaw <-> Lenses | convert chat/mobile ingress into governed run state | ChatIntent, ForgeRunStatusSummary |
Anti-patterns
- Hermes owns run state.
- Fleet stores process policy.
- Lenses runs LLM reasoning as its own hidden behavior.
- Blueprints become live runtime state.
- Factory approves its own output.
- OpenClaw treats chat text as sufficient approval for dangerous actions.
- Fleet opens pull requests or owns campaign manifest without Lenses ForgeRun.
- Confusing marketing “campaign” with Forge Campaign in operator docs.
- Product repos submodule forge-platform (use handbook URLs and sibling clones; only forge-platform-website submodules platform for build).