Studio UX PDCA worker

Dual-wiki: operator · system.

Updated

Deprecated. Use ux_improver_worker (analysis) and implementation_worker (implementation). The monolith studio_ux_pdca_worker remains available only when FORGE_STUDIO_UX_MONOLITH=1.

Definition

Workcell id: studio_ux_pdca_worker (deprecated)

A governed, page-by-page Studio UX rewrite loop: capture screenshot and context → ChatGPT assessment → Cursor PDCA implementation → build/redeploy → gate → Matrix notify → advance page queue.

Orchestration is expressed in lmeta (studio-ux-campaign.lmeta); product repos supply consumer hooks only.

Runtime homes

Mode Host Entry
Dev bootstrap forgesdlc-kitchensink tools/studio-ux-pdca/run-studio-ux-pdca-loop.sh
Governed local forge-workcells forge-workcells run --workcell studio_ux_pdca_worker --request …
CDP (ChatGPT steps) forge-cdp-manager POST /v1/flows/run with flow_id: studio-ux-campaign
Fleet (future) Fleet job container Same lmeta + hooks inside workspace

Envelopes

  • Cycle artifact schema: forge.studio_ux_cycle.v1 (schemas/studio_ux_cycle.v1.schema.json)
  • Request: forge.workcell_request.v1 with workcell: studio_ux_pdca_worker and launch_pack containing flow inputs (see below)
  • Result: forge.workcell_result.v1 with artifacts pointing at workbench cycle paths

Flow inputs (launch_pack)

Field Required Description
consumer_id yes e.g. forge-market
repo_root yes Absolute path to product repo
manifest_path yes Relative path to pages.manifest.yaml
campaign_id yes Stable campaign folder name
studio_base_url yes e.g. http://127.0.0.1:9792
mode no auto (default) or interactive — Matrix approval before Cursor
chatgpt_project no ChatGPT sidebar project name
matrix_room_id no Matrix room for cycle summaries (prefer #studio-ux; Element-rich PASS/FAIL + progress)
score_thresholds no { overall, improvement_delta, absolute_pass }
page_slugs no Limit to specific manifest slugs (repeatable in request)
max_iterations_per_page no Cap per-page PDCA iterations (default 5)

Sample interactive request (also under workbench/studio-ux-pdca/forge-market/fm-ux-interactive-sample/):

{
  "schema": "forge.workcell_request.v1",
  "workcell": "studio_ux_pdca_worker",
  "mode": "execute",
  "launch_pack": {
    "consumer_id": "forge-market",
    "repo_root": "/home/lzvyahin/Code/forge-market",
    "manifest_path": "scripts/fm-studio-ux-pdca/pages.manifest.yaml",
    "campaign_id": "fm-ux-interactive-sample",
    "studio_base_url": "http://127.0.0.1:9792",
    "mode": "interactive",
    "chatgpt_project": "Forge Market",
    "max_iterations_per_page": 1,
    "page_slugs": ["graph-default"]
  }
}

Set FM_STUDIO_UX_APPROVAL_PRESET=1,2 to bypass Matrix wait in CI.

Consumer hook contract

Product repos implement consumer_hooks.py with:

Hook Purpose
bootstrap_fixtures Seed demo data before capture
wiki_context Dual-wiki feature map excerpt
persist_cycle_bundle Write workbench archive + cycle.zip
write_cursor_plan Drop .cursor/plans/studio-ux-pdca/<slug>.plan.md
build_and_restart UI build + studio restart
run_gates pytest + Playwright + product PDCA gates
advance_page_queue Update campaign-summary.json

Persistence and git side effects live only in consumer hooks — lmeta orchestrates.

Workcell Role in loop
cursor_cli Single Cursor agent implementation step
local_llm_worker Optional micro-pack on one finding cluster
fleet_ux_worker Static-site UX; complementary, not a substitute

Docs

  • CDP flows: forge-cdp-manager docs/STUDIO-UX-PDCA-FLOWS.md
  • KS harness: forgesdlc-kitchensink tools/studio-ux-pdca/README.md
  • First consumer: forge-market docs/handbook/operator/studio-ux-pdca.md