Handbook
UX improver worker
Dual-wiki: operator · system.
Updated
Definition
Workcell id: ux_improver_worker
Role: ux_improver
Governed analysis-only Studio UX loop: capture screenshot and context → ChatGPT assessment → validate and emit ranked PDCA prompts → Matrix/Element notify → post IMPLEMENT? jobs for the implementation worker.
Does not invoke Cursor or run product gates. Implementation is delegated to implementation_worker.
Deprecated alias: studio_ux_worker (CLI still accepts it).
Runtime homes
| Mode | Host | Entry |
|---|---|---|
| Dev bootstrap | forgesdlc-kitchensink | tools/studio-ux-pdca/run-studio-ux-analysis.sh |
| Governed local | forge-workcells | forge-workcells run --workcell ux_improver_worker --request … |
Envelopes
- Cycle artifact schema:
forge.studio_ux_cycle.v1withphase: analysis - Handoff schema:
forge.studio_ux_implement_job.v1(schemas/studio_ux_implement_job.v1.schema.json) - Request:
forge.workcell_request.v1withworkcell: ux_improver_worker,role: ux_improver,mode: proposal - Result:
forge.workcell_result.v1withneeds_approval(interactive) orsucceeded+ job artifacts (auto)
Flow inputs (launch_pack)
Same fields as the legacy Studio UX PDCA worker (consumer_id, repo_root, manifest_path, campaign_id, studio_base_url, mode, chatgpt_project, matrix_room_id, page_slugs, caps). Additional:
| Field | Description |
|---|---|
split_mode |
When true, analysis posts implement jobs; implementation worker runs separately. |
dispatch_implement |
When true with split_mode, spawn implement phase per job in-loop (paper uses skip-cursor). |
Sample request: workbench/studio-ux-pdca/forge-market/fm-ux-split-sample/workcell_request.analysis.json
Element protocol
Room: !XpWhlVkoxnjDQHvYlX:matrix.forgedc.net (#studio-ux). Operator: @forgeadmin:matrix.forgedc.net.
Persona: [ux_improver · forge-market] on all analysis-phase posts.
| Event | When |
|---|---|
CAMPAIGN START / CAMPAIGN ANALYSIS DONE |
Campaign boundaries |
START / LIVE / ASSESSMENT BRIEF / ANALYSIS DONE |
Cycle status (analysis phase) |
HANDOFF |
After jobs queued — lists absolute paths to implement-job-r*.json, plans, PDCA prompts |
PICKUP? |
Prior unimplemented suggestions |
APPROVE? |
Interactive mode before posting jobs |
Handoff posts absolute disk paths (open in editor):
{cycle_dir}/implement-jobs.json— manifest{cycle_dir}/implement-job-r01.json—forge.studio_ux_implement_job.v1{repo_root}/.cursor/plans/studio-ux-pdca/{page}-{prompt}.plan.md— Cursor plan copy{cycle_dir}/pdca-prompts/01-*.md— ranked PDCA source
Full grammar: Studio UX Element protocol.
Related workcells
| Workcell | Role |
|---|---|
implementation_worker |
Consumes implement-job.json; Cursor + gates |
studio_ux_pdca_worker |
Deprecated monolith — use split pair instead |
Docs
- Element grammar: forge-platform
docs/workcells/studio-ux-element-protocol.md - KS harness: forgesdlc-kitchensink
tools/studio-ux-pdca/README.md