Handbook
Product Boundaries
Each product must have one primary operational responsibility. Cross-product behavior must be expressed through contracts, not fuzzy integration.
Updated
Boundary principle
Each product must have one primary operational responsibility. Cross-product behavior must be expressed through contracts, not fuzzy integration.
| Product | Owns | Does not own |
|---|---|---|
| ForgeSDLC | methodology, vocabulary, operating model | runtime, UI, agent execution |
| Blueprints | canonical policy, recipes, Versonas, evidence expectations | live run state, execution, agent memory |
| Lenses | local control plane, run spine, approvals, evidence review | deep LLM reasoning, Docker execution, canonical policy |
| LCDL | governed LLM reasoning, contracts, verification, repair | UI, job execution, product policy |
| Fleet | controlled execution, templates, logs, telemetry | planning, approval, LLM reasoning |
| Hermes | adaptive operator, memory, skills, MCP orchestration | canonical governance, approval authority, evidence system of record |
| Factory Droid | implementation-heavy coding, review, patch proposal | Forge methodology, final approval, system of record |
| OpenClaw | messaging ingress, channel routing, status relay | approval authority, execution, canonical run state |
| forge-workcells (private repo) | workcell runner code (local_llm_worker, future runners), pack loader, run store helpers |
canonical schemas, product policy, control-plane UI, domain micro-packs |
| forgesdlc-kitchensink (design system + tools) | micro-packs, UX harness glue, shared CSS/JS | workcell runtime, LLM transport, run spine |
| forge-cdp-manager | Edge CDP surface leases, registry, optional HTTP control plane (:18770) |
Harvest orchestration, SQLite, LCDL task bodies |
| Forge Intelligence | problem-class catalog, Human-Life pack bundles, typed artifact envelope bus (cross-node handoff), FI-local LCDL contracts and lmeta libraries, graph orchestration (router/composer), concept + session dual-wiki, v1/v2 attach schemas (route_trace, token_ledger, ambiguity_assessment, task_graph, maturity_axes) |
LCDL FlowExecutor, Fleet jobs, Lenses SoR, agent memory, doc-hydration claim registries |
| Forge STI | governed test strategy, plans, cases, campaigns; lmeta/LCDL test artifacts | Lenses SoR, Fleet execution plane, canonical platform policy |
| Dark Factory (methodology product) | governed sequential local-first coding loop (classify→route→plan→apply→verify→repair); L1–L3 PoC methodology and operator docs | Lenses SoR, platform charter, final merge approval |
| Forge Universe (adjacent product) | physics world model, in-browser renderers, Universe Studio | ForgeRun spine, Lenses, Fleet, LCDL governance |
| Cockpit (+ memory/mobile) | local Outlook/Teams/Plaud harvest, SQLite, read-only analysis UI; Fleet memory client and mobile pulse feed | Lenses SoR, canonical policy, governed ForgeRun decisions |
| Knowledge Assistant | local case-study assistant; SharePoint sync via CDP; SQLite FTS; Granite copilot RAG | Lenses SoR, platform schemas, doc-hydration claim registries |
| Certificators | certificatee quiz agents, bank-health REST API, bank pipeline orchestration | Lenses SoR, platform policy text, final approval authority |
| forge-composer | deploy manifests into sibling repos; taxonomy ETL/refine CLIs | runtime, Lenses SoR, Fleet job plane |
| forge-llm | optional local AI lab — Ollama-compatible gateway, ComfyUI, telemetry | governed task contracts, Lenses SoR, platform policy |
| forge-a11y-checker | accessibility utilities; runs KS website-a11y-auditor (axe + deterministic rules) |
UX design system ownership, Lenses SoR |
A11y Studio (forge-accessibility) |
CDP + axe audits, Electron shell, sealed remediation loops | KS component catalog, Lenses SoR |
Out of platform spine
These repos consume Blueprints and/or Kitchen Sink but are not Forge Platform instruments. Platform docs link to them for adoption examples only — not as control-plane or execution strata.
| Consumer | Role | Platform relation |
|---|---|---|
| Situ8 | Android app — case workflows, BYOK LLMs; blueprints submodule | Blueprint consumer example |
| Situ8-web | Marketing site for situ8.app; KS-based generator | Design-system consumer; separate Firebase deploy |
Capablio (capablio-website) |
Private handbook / forge360 product shell | Adjacent SKU; not in core MVP ecosystem table |
See Blueprint consumers and Ecosystem reference.
Critical rule
Lenses is the system of record for runs, approvals, evidence, and human review.
Agent workcell rule
No agent workcell writes final state directly. Every workcell returns a WorkcellResult linked to a ForgeRun and reviewed through Lenses.
Fleet rule
Agents must not receive raw execution power by default. Fleet should expose approved templates first, raw job submission later if explicitly allowed.
LCDL rule
When a result affects a decision, route it through an LCDL contract or traceable governed reasoning flow.
Blueprints rule
Blueprints define what should be judged. They do not execute jobs or privately remember user preferences.
Forge Campaign rule
| Role | Owns | Does not own |
|---|---|---|
| Forge Campaign (ForgeRun + manifest) | Intent, repo list, branch naming, evidence expectations | Container runtime |
campaign_orchestrator workcell |
Git branch, pack/upload, Fleet API poll, integrate, PR open (when policy allows) | Final merge approval, canonical policy text |
fleet_ux_worker workcell |
In-container audit/remediation, worker_progress / worker_result |
Opening PRs, Lenses decision state |
| Fleet | docker_argv, workspace extract, job telemetry |
Campaign manifest, git integration |
| Lenses | Run visibility, approval UI, decision on frun_* |
Executing remediation inside Docker |
See Agents and workcells, Forge Campaign, and Forge Agent.