Handbook
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.v1withworkcell: studio_ux_pdca_workerandlaunch_packcontaining flow inputs (see below) - Result:
forge.workcell_result.v1withartifactspointing 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.
Related workcells
| 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