Handbook
forge-workcells repository
forge-workcells (autowww/forge-workcells) is a private git repository for shared Forge runner implementations. Platform owns names and schemas; forge-workcells owns execution code.
forge-platform does not submodule forge-workcells. Consumers install via pip, path, or optional KS submodule when credentials allow.
Access
- Visibility: Private (org
autowww) - Clone:
git@github.com:autowww/forge-workcells.git - CI and developers need read access (deploy key or org token)
MVP workcell: local_llm_worker
pip install -e .
pip install -e ../forge-lcdl
forge-workcells run --workcell local_llm_worker \
--pack ../forgesdlc-kitchensink/tools/forge-micro-agent/packs/ux-ai-rule-v1 \
--context /path/to/context.json \
--out-dir /path/to/out \
--llm-env /path/to/lcdl.env
Writes logs and model output for KS parse-ai-agent-findings.mjs.
Layout
| Path | Purpose |
|---|---|
src/forge_workcells/ |
Runners, pack loader, run store helpers |
packs/_base/ |
Shared fragments (no domain rules) |
| Domain packs | forgesdlc-kitchensink tools/forge-micro-agent/packs/ |
Taxonomy
Do not duplicate workcell naming in forge-workcells README — this handbook section and Workcell catalog are canonical.