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.v1 with phase: analysis
  • Handoff schema: forge.studio_ux_implement_job.v1 (schemas/studio_ux_implement_job.v1.schema.json)
  • Request: forge.workcell_request.v1 with workcell: ux_improver_worker, role: ux_improver, mode: proposal
  • Result: forge.workcell_result.v1 with needs_approval (interactive) or succeeded + 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.

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