Handbook
Workcell contracts
Platform JSON schemas under schemas/ define the run spine and workcell I/O. Samples under samples/ validate in scripts/check_foundation.py.
Core run spine
| Schema | Identifier | Sample |
|---|---|---|
forge_run.v1.schema.json |
forge.run.v1 |
samples/forge_run.sample.json |
evidence_packet.v1.schema.json |
forge.evidence_packet.v1 |
samples/evidence_packet.sample.json |
approval_request.v1.schema.json |
forge.approval_request.v1 |
samples/approval_request.sample.json |
Agent and workcell
| Schema | Identifier | Sample |
|---|---|---|
agent_run.v1.schema.json |
forge.agent_run.v1 |
sprints/selfhost-alpha/samples/agent_run.json |
workcell_request.v1.schema.json |
forge.workcell_request.v1 |
samples/workcell_request.hermes.sample.json |
workcell_result.v1.schema.json |
forge.workcell_result.v1 |
samples/workcell_result.factory.sample.json |
Summaries and context
| Schema | Identifier | Sample |
|---|---|---|
lcdl_trace_summary.v1.schema.json |
forge.lcdl_trace_summary.v1 |
samples/lcdl_trace_summary.sample.json |
fleet_job_summary.v1.schema.json |
forge.fleet_job_summary.v1 |
samples/fleet_job_summary.sample.json |
blueprint_context_pack.v1.schema.json |
forge.blueprint_context_pack.v1 |
(see sprint fixtures) |
chat_intent.v1.schema.json |
forge.chat_intent.v1 |
samples/chat_intent.sample.json |
LCDLTraceSummary links governed LCDL graph runs to the EvidencePacket path. Roadmap R3 may add ForgeRun metadata references for DecisionPack ids (product roadmap R3.M3) — doc-only until schemas change.
Self-Host local runner
| Schema | Identifier | Sample |
|---|---|---|
local_runner_action.v1.schema.json |
forge.local_runner_action.v1 |
samples/local_runner_action.sample.json |
local_runner_result.v1.schema.json |
forge.local_runner_result.v1 |
samples/local_runner_result.sample.json |
Ecosystem topology
| Schema | Identifier | Sample |
|---|---|---|
ecosystem_reference.v1.schema.json |
forge.ecosystem_reference.v1 |
samples/ecosystem_reference.v1.json |
Campaign (informal v0)
Campaign manifest shape is documented in Forge Campaign. Formal forge.campaign.v1 schema is post-research.
Validation
python3 scripts/check_foundation.py