Forge Platform

Handbook

Ecosystem reference

This page is the repo and workcell topology companion to the Product intersection map. The intersection map stays contract-centric (which schema links which products). The ecosystem reference shows which git repos exist…

Purpose

This page is the repo and workcell topology companion to the Product intersection map. The intersection map stays contract-centric (which schema links which products). The ecosystem reference shows which git repos exist, visibility, submodule rules, and where runners and packs live.

Machine-readable source:

Run python3 scripts/check_foundation.py to validate the sample discriminator.

Repo layout (MVP)

id kind visibility Owns
forge-platform product org Schemas, ADRs, glossary; not runner code long-term
forge-platform-website handbook — Published handbook; only repo that submodules platform
forge-workcells repo private local_llm_worker and future workcell runners
forge-lcdl product org Governed LLM transport and contracts
forge-lenses product org Control plane, run spine UI
forgesdlc-kitchensink repo public Design system, UX harness, micro-packs
forge-fleet product private Template execution
blueprints repo public Policy; submodules into platform only

Submodule rules

Rule Detail
Platform never in products Product repos (Lenses, Fleet, KS, …) must not submodule forge-platform. Consume via docs URLs and schema copies in CI.
Handbook exception forge-platform-website/forge-platform/ submodule for build only.
Blueprints into platform forge-platform/blueprints/ → autowww/blueprints.
Workcells in consumers KS and (later) Lenses may submodule private forge-workcells via SSH.
Packs stay in KS Domain prompts under tools/forge-micro-agent/packs/; workcells does not own UX rule text.

Workcell → host repo

workcell id Host repo Notes
local_runner forge-platform Self-Host Alpha script (selfhost_runner.py) until extracted
local_llm_worker forge-workcells Micro-agent MVP; LCDL inference
cursor_cli harness / campaign Cursor CLI when governed under ForgeRun
fleet_ux_worker Fleet job container Playwright + optional agent in workspace
campaign_orchestrator operator host Fleet API + git

Micro-agent data flow (local LLM path)

  1. KS harness serves Before defect fixture (python3 -m http.server).
  2. analyze-website-ux.mjs --site --max-pages 1 produces audit JSON.
  3. ux-audit-slice.mjs + ux-playwright-evidence.mjs → ux-assemble-context.mjs writes context.json.
  4. forge-workcells run loads pack ux-ai-rule-v1, calls LCDL, writes micro-agent.log and raw JSON text.
  5. parse-ai-agent-findings.mjs normalizes findings; expect-ai-rule-detection.sh gates the rule.

Private forge-workcells

  • Remote: git@github.com:autowww/forge-workcells.git (visibility Private).
  • Cloners need autowww org read access.
  • CI that clones KS with --llm needs a deploy key or token with repo scope.
  • No forge-workcells-website in MVP.

Cursor path vs --llm path

Step Cursor path --llm path
Rule prompt design-rules/ai/*.md Same + pack prompt.md
Executor agent -p forge-workcells
Profile Cursor quota LLM_* env file
Output parse parse-ai-agent-findings.mjs Same