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.v1 on disk ({cycle_dir}/implement-job.json) or launch_pack.job_path
  • Output: forge.studio_ux_implement_result.v1 at {cycle_dir}/implement-result.json
  • Request: forge.workcell_request.v1 with workcell: implementation_worker, role: implementation_worker, mode: sandboxed_implementation
  • Result: forge.workcell_result.v1 with 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.

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