Commit Graph

1 Commits

Author SHA1 Message Date
saravanakumardb1
e72323b8db docs(roadmap): v3.2 — showcase-first tracker + auto-counter script
Adds §11 to the v3 cross-repo UX roadmap: a 202-item, machine-parsable
checklist that coding agents flip as they ship work, with the
`learning_ai_uxui_web` showcase as the canonical visual-iteration
surface ahead of any product adoption.

──────────────────────────────────────────────────────────────────
§11 — Showcase-first workflow & live progress tracker
──────────────────────────────────────────────────────────────────
\u00a711.0  The showcase-first rule (non-negotiable 7-step recipe)
       1. Scaffold in common_plat/packages/<name>/
       2. Vendor snapshot to learning_ai_uxui_web/src/lib/<name>-preview/
       3. Showcase route at src/app/showcase/<group>/<slug>/page.tsx
          + catalog entry in src/catalog/routes.ts
       4. MSW mock any backend dependency
       5. Smoke test (axe + visual-regression baseline)
       6. Publish to Gitea registry; delete preview; swap imports
       7. Adopt in ≥ 1 product — that PR closes the checklist row

\u00a711.1  Agent update protocol — flip `- [ ]` → `- [x]` inline with
       the commit; trail the short-SHA in parentheses; multi-step
       rows tracked sub-bullet by sub-bullet.

\u00a711.2  Live "Progress at a glance" block (auto-rewritten by the
       counter script below).

\u00a711.3  Wave 8 Rollout       — 18 items
\u00a711.4  Wave 9 Data          — 42 items
\u00a711.5  Wave 10 Shells       — 35 items
\u00a711.6  Wave 11 Adaptive     — 26 items
\u00a711.7  Wave 12 Mobile       — 26 items
\u00a711.8  Wave 13 Futurism     — 39 items
\u00a711.9  Cross-cutting        —  8 items
\u00a711.10 Customer-magnet demos —  8 items
       ───────────────────────────────
       TOTAL                   — 202 items

Every package row carries a paired "**Showcase:**` /showcase/...`"
route entry so agents know exactly where the demo lives. Cross-
referenced with the per-product upgrade matrix in §5.

Renumbered hygiene §11 → §12. Header bumped v3.1 → v3.2.

──────────────────────────────────────────────────────────────────
scripts/count-roadmap-progress.ts
──────────────────────────────────────────────────────────────────
TypeScript node script (tsx) that:
  - Parses the v3 doc, counts `- [ ]` and `- [x]` per §11.x section
  - Rewrites the §11.2 fenced block in place with live counts +
    bar charts + percentages
  - Updates the `· \`N / M\`` suffix on every `### 11.x Wave …`
    heading so per-wave totals stay accurate
  - Idempotent: re-runs are no-ops when nothing changed
  - Verified: emits `0 / 202 done` on initial run; "up to date"
    on second run

Wired as Wave 8.A.7 (also tracked at CC.8 — should land in pre-commit
hook so the §11.2 block can never drift from reality).

Mirror in copilot/learning_ai_uxui_web follows in a paired commit.
2026-05-27 15:24:46 -07:00