Handbook
Forge Intelligence Studio UX remediation PDCA — master sequence
Composer 2.5 implements repo phases U00–U11 for all 28 Studio UX backlog items (FIS-UX-001…028) from the Playwright crawl and fi-studio-ux-backlog-roadmap canvas.
Updated
Prerequisite: fi-studio-sprint-pdca S00–S08 complete (Studio shell on :9791, hash Fis).
Executor model: Composer 2.5 (standard variant, not -fast).
| Phase | Prompt | FIS-UX IDs | Scope |
|---|---|---|---|
| U00 | U00-scaffold.md | — | SEQUENCE, gate scripts, master sequence (all 28 IDs listed below) |
| U01 | U01-heatmap-errors.md | 001, 019 | Heatmap chart mounts + loading/error design system |
| U02 | U02-human-language.md | 002, 003, 009, 016 | Human labels, titles, status chips, Advanced toggle |
| U03 | U03-library-workbench.md | 006, 007, 008, 014, 018 | Rich fields, search/filter, detail route, home overview |
| U04 | U04-coverage-health.md | 004, 010, 021 | Coverage health narrative + provenance |
| U05 | U05-cases-scenarios.md | 005, 011, 027 | Case scenarios, run feedback, capability chips |
| U06 | U06-sessions-human.md | 012 | Human report first; machine JSON in Advanced |
| U07 | U07-creativity-wizard.md | 013 | Creativity Lab guided wizard + portfolio |
| U08 | U08-enterprise-shell.md | 015, 017, 020, 022, 026 | Rail IA, heatmap drill-down, export, a11y, visual polish |
| U09 | U09-decision-support.md | 023, 024, 025, 028 | Compare, recommender, onboarding tour, label oracle |
| U10 | U10-dual-wiki.md | — | FI-STUDIO-001 operator/system dual-wiki + Fis contract |
| U11 | U11-closeout.md | — | Playwright crawl v2, backlog v2 canvas, CI closeout |
Full backlog registry (FIS-UX-001…028)
| ID | Phase | Title |
|---|---|---|
| FIS-UX-001 | U01 | Fix Heatmap chart mounts (kpi_multi / matrix_heatmap) |
| FIS-UX-002 | U02 | Human label layer for maturity & next-step codes |
| FIS-UX-003 | U02 | Plain-language intelligence titles + short blurbs |
| FIS-UX-004 | U04 | Coverage metrics → outcome language + good/bad framing |
| FIS-UX-005 | U05 | Case cards with scenario story, not case.cross.* IDs |
| FIS-UX-006 | U03 | Surface rich audit fields already in API |
| FIS-UX-007 | U03 | Search + arena/depth filters on Library |
| FIS-UX-008 | U03 | Intelligence detail drawer / page |
| FIS-UX-009 | U02 | Status chips with color + legend (not raw codes) |
| FIS-UX-010 | U04 | Coverage health summary strip (all green / needs attention) |
| FIS-UX-011 | U05 | Case run UX: progress, confirm, result toast → session |
| FIS-UX-012 | U06 | Session browser: human report first, machine JSON second |
| FIS-UX-013 | U07 | Creativity Lab guided wizard (brief templates + scored portfolio) |
| FIS-UX-014 | U03 | Home overview / command center |
| FIS-UX-015 | U08 | Rail IA rename + icons + section purpose lines |
| FIS-UX-016 | U02 | Glossary / “Explain this” panel (toggle advanced IDs) |
| FIS-UX-017 | U08 | Heatmap interaction: click cell → intelligence detail |
| FIS-UX-018 | U03 | Risk & autonomy framing for operators |
| FIS-UX-019 | U01 | Empty / loading / error design system |
| FIS-UX-020 | U08 | Export & share (CSV / PDF snapshot / copy link) |
| FIS-UX-021 | U04 | Last-updated + data provenance footer |
| FIS-UX-022 | U08 | Keyboard navigation + a11y labels on rail/tables |
| FIS-UX-023 | U09 | Compare intelligences / cases side-by-side |
| FIS-UX-024 | U09 | Guided “what should I do next?” recommender |
| FIS-UX-025 | U09 | Onboarding tour + sample journey (browse → case → session) |
| FIS-UX-026 | U08 | Visual density / typography / spacing refresh for Fis contract |
| FIS-UX-027 | U05 | Capability map inside a case (who fans in) |
| FIS-UX-028 | U09 | Playwright oracle for human-mode copy (not only hash) |
Gate runner: scripts/fi-studio-ux-pdca/check-phase-gate.sh <U00|…|U11|all>
Do not open U0N+1 until ./scripts/fi-studio-ux-pdca/check-phase-gate.sh U0N is green.