Forge Platform

Handbook

Agents and workcells

This section is the canonical handbook for Forge Agent sessions, workcells, forge runners, campaigns, workflows, and the private forge-workcells repo. Platform schemas live in schemas/; execution code lives in product…

Reading order

  1. Terminology — names, aliases, anti-patterns
  2. Forge Agent — pattern, AgentRun, governance modes
  3. Workcell model — roles and request/result envelope
  4. Forge runner — executable vs record vs workcell id
  5. Workflows and runs — ForgeRun, Fleet, harness, campaign
  6. Governed workflows and rules — approval gates, DecisionPack, campaign phases
  7. Workcell catalog — maintained id → host matrix
  8. Contracts — schema pointers and samples
  9. Forge micro-agent — local_llm_worker pilot
  10. Forge Campaign — multi-repo automation under one ForgeRun
  11. Self-Host local runner — local_runner alpha
  12. forge-workcells repo — private runners

Terminology (short)

Term What it is
Forge Control-plane envelope (not an agent)
ForgeRun Governed run container (frun_*)
Forge Agent Pattern for a bounded agent session
AgentRun Record of one session (arun_*)
Workcell Bounded role: WorkcellRequest → WorkcellResult
Workcell id Stable string (hermes, local_llm_worker, …)
Forge runner Code that executes a workcell
forge-workcells Private repo for shared runner implementations
Micro-agent Single local-LLM judgment (local_llm_worker)
Forge Campaign Multi-repo effort under one ForgeRun
Fleet job Container execution (not the run SoR)
Harness run KS ruleset test (ForgeRun optional)
Governed workflow LCDL DAG or operators (not platform BPM)
DecisionPack Versioned graph spec in forge-lcdl
Approval gate Human/policy record before execution 
  ForgeRun (frun_*)
       |
       +-- AgentRun (arun_*) + workcell id
       |         |
       |         v
       |    Forge runner (executable)
       |         |
       |    +----+----+----------+
       |    |         |          |
       |  platform  workcells  fleet container
       |  selfhost   local_llm  fleet_ux_worker
       |
       +-- EvidencePacket / Approval (Lenses)

Workcells terminology map

Platform context