Handbook
Implementation worker
Dual-wiki: operator · system.
Updated
Definition
Workcell id: implementation_worker
Role: implementation_worker
Governed implementation-only step for Studio UX handoffs: consume forge.studio_ux_implement_job.v1 → write Cursor plan → run agent -p with composer-2.5 → build/redeploy → capture after → score → product gates → post IMPLEMENT DONE in Element.
Does not run ChatGPT assessment or emit new PDCA prompts.
Deprecated alias: studio_ux_implement_worker (CLI still accepts it).
Runtime homes
| Mode | Host | Entry |
|---|---|---|
| Dev bootstrap | forgesdlc-kitchensink | tools/studio-ux-pdca/run-studio-ux-implement.sh |
| Governed local | forge-workcells | forge-workcells run --workcell implementation_worker --request … |
Envelopes
- Input:
forge.studio_ux_implement_job.v1on disk ({cycle_dir}/implement-job.json) orlaunch_pack.job_path - Output:
forge.studio_ux_implement_result.v1at{cycle_dir}/implement-result.json - Request:
forge.workcell_request.v1withworkcell: implementation_worker,role: implementation_worker,mode: sandboxed_implementation - Result:
forge.workcell_result.v1with gate outcome
Flow inputs (launch_pack)
| Field | Required | Description |
|---|---|---|
job_path |
yes* | Absolute path to implement-job.json |
cycle_dir |
yes* | Cycle dir containing implement-job.json |
repo_root |
no | Override from job envelope |
mode |
no | paper (default) or live Matrix notify |
* One of job_path or cycle_dir is required.
Element protocol
Posts in the same #studio-ux thread as the UX improver worker.
Persona: [implementation_worker · forge-market] on implement-phase posts.
| Event | When |
|---|---|
ACK HANDOFF |
Picked up job — absolute paths to implement-job-r*.json, plan, cycle dir |
IMPLEMENT START |
Before Cursor |
LIVE |
Gating progress (implementation_worker persona) |
IMPLEMENT DONE |
PASS/FAIL with scores + artifact paths (result JSON, before/after PNG, compare image) |
After each rank, Element receives a Before / After composite (matrix-compare-rNN.png) with red tint on changed pixels (before) and green (after). Paths are echoed in IMPLEMENT DONE under Artifacts:.
@mention forgeadmin only on gate FAIL, worker error, or when operator must choose retry / hold / abort.
Full grammar: Studio UX Element protocol.
Cursor model
Default composer-2.5 via FORGE_STUDIO_UX_CURSOR_MODEL. Override only for local experiments.
Related workcells
| Workcell | Role |
|---|---|
ux_improver_worker |
Posts IMPLEMENT? jobs |
cursor_cli |
Single-step Cursor primitive (not job-aware) |
Docs
- Element grammar: forge-platform
docs/workcells/studio-ux-element-protocol.md - KS harness: forgesdlc-kitchensink
tools/studio-ux-pdca/README.md