create-issflow 1.9.0 → 1.9.2

package/README.md

@@ -32,7 +32,7 @@ The portable kit (every tool) in `<project>/.issflow/`:
 
 - `agents/` — planner · researcher · implementer · test-author · debugger · e2e-runner · synthesizer
 - `commands/` — `/overview` `/feature` `/goal` `/propose` `/phase` `/sprint` `/ui-audit` `/qa-audit` `/security-audit` `/release` `/uat` `/change-request` `/replan` `/quick` `/synthesize` `/runbook` `/store-wisdom` `/log-issue` `/log-decision` `/unstuck`
-- `skills/` — caveman · grill-me · karpathy-guidelines · ux-design · security · code-standards
+- `skills/` — caveman · grill-me · karpathy-guidelines · ux-design · ui-ux-pro-max · security · code-standards
 - `hooks/` — session-start · context-guard · plan-gate (rule-13 enforcement) · pre-compact · subagent-stop · feature-gate (Stop gate for `/feature`, artifact-verified)
 - `istartsoft-flow/METHODOLOGY.md` — the full methodology (single source of truth)
 

package/bin/cli.js

@@ -227,8 +227,8 @@ function agentsMd() {
     '`/change-request` · `/replan` · `/synthesize` · `/runbook` · `/store-wisdom` ·',
     '`/log-issue` · `/log-decision` · `/unstuck`', '',
     '## Skills — `.issflow/skills/` (loaded on demand)', '',
-    'caveman · grill-me · karpathy-guidelines · ux-design · security · code-standards ·',
-    'support-triage', '',
+    'caveman · grill-me · karpathy-guidelines · ux-design · ui-ux-pro-max · security ·',
+    'code-standards · support-triage', '',
     '## Autonomy', '',
     'Planning (`/overview` grill + plan approval) always asks — that input is cheap.',
     '**AUTO (default)** governs the DEV loop: follow the plan, decide + log + continue,',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-issflow",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "Scaffold the iStartSoftFlow AI-coding workflow into a project. Stack-agnostic, tool-agnostic (Claude Code, Codex, Cursor, Gemini, Aider), non-destructive.",
   "bin": {
     "create-issflow": "bin/cli.js"

package/template/.issflow/README.md

@@ -14,7 +14,7 @@ This directory is the **portable workflow kit** (tool-agnostic). Every
 |------|------|
 | `agents/` | Fresh-context workers (planner, researcher, implementer, …) |
 | `commands/` | Procedures — Default: `/overview` `/feature` `/quick`; Advanced: `/propose` `/design` `/support` … |
-| `skills/` | On-demand cookbooks (ux-design, security, support-triage, …) |
+| `skills/` | On-demand cookbooks (ux-design, ui-ux-pro-max, security, support-triage, …) |
 | `hooks/` | Lifecycle enforcement scripts |
 | `istartsoft-flow/` | METHODOLOGY.md — every hard rule lives here once |
 | `templates/` | Proposal / UX pack / architecture / CR / FEATURE / automation |

package/template/.issflow/commands/change-request.md

@@ -77,7 +77,8 @@ Show me CR-<n> (impact + price delta + new total — no rate). **STOP for approv
 (commercial gate — always interactive).
 - **Approved** -> set CR status `approved`; bump PROPOSAL.md to a new version (vN+1)
   with the delta folded in (**totals only**); re-render `docs/proposal.html` from it
-  (same template + language; no contingency note / rate); then dispatch `/replan` to
+  (same `/propose` package rows + screen appendix — do not dump every PLAN phase
+  onto the sign table; same template + language; no contingency note / rate); then dispatch `/replan` to
   apply the phase changes to PLAN.md (done phases stay frozen). Update STATE.md.
   NOTE: `/replan` reverts PLAN.md to `> Approval: PENDING` and re-runs the
   PLAN-APPROVAL gate (hard rule 13) — the commercial CR sign-off is SEPARATE from

package/template/.issflow/commands/design.md

@@ -24,13 +24,19 @@ and STOP. Write nothing.
 Target: `$ARGUMENTS` → `ux` | `arch` | `both` (default **both**).
 
 ## STEP 1 — UX PACK (if ux|both)
-1. Apply `ux-design` skill (authoring mode): wireframe baseline + cookbook direction.
-2. Scaffold or update `docs/UX-PACK.md` from `.issflow/templates/UX-PACK-template.md`.
-3. Fill flows, screen inventory, tokens/frame, a11y notes from OVERVIEW + PLAN.
-4. SHOW me UX-PACK.md. **STOP for approval.**
-5. On approve: stamp `> Approval: approved <date> v<n>`; set `design: approved <date>`
+1. Apply `ui-ux-pro-max` (visual direction): run the kit engine
+   `.issflow/skills/ui-ux-pro-max/scripts/search.py --design-system` from
+   OVERVIEW product + industry. Fold into UX-PACK tokens — do not create a
+   parallel `design-system/` SoT. If Python 3 is missing, ask me to install it
+   (do not install tools yourself).
+2. Apply `ux-design` skill (authoring mode): wireframe baseline + cookbook direction.
+   Catalogue output must still pass the cookbook (tokens, a11y, no emoji icons).
+3. Scaffold or update `docs/UX-PACK.md` from `.issflow/templates/UX-PACK-template.md`.
+4. Fill flows, screen inventory, tokens/frame, a11y notes from OVERVIEW + PLAN.
+5. SHOW me UX-PACK.md. **STOP for approval.**
+6. On approve: stamp `> Approval: approved <date> v<n>`; set `design: approved <date>`
    in STATE.md; HISTORY line `design v<n> approved`.
-6. On change request: revise and re-show; header stays PENDING.
+7. On change request: revise and re-show; header stays PENDING.
 
 ## STEP 2 — ARCHITECTURE (if arch|both)
 1. Dispatch `researcher` (DESIGN) only if open unknowns remain; else use OVERVIEW.

package/template/.issflow/commands/phase.md

@@ -119,6 +119,8 @@ for the slice using the declared E2E runner (it brings the test stack up/down
 itself). Then run the `ux-design` cookbook + wireframe check on the new UI
 (hard rule 9): the UI must match the wireframe frame and pass the cookbook
 (tokens, a11y/WCAG AA, states, breakpoints). A `ux-design` BLOCK is a GATE FAIL.
+Do not re-run `ui-ux-pro-max` `--design-system` here — the look is locked in the
+approved UX pack.
 Non-frontend phase -> skip §3c.
 
 PHASE GATE (rule 5) -> go to §4/§5/§6 (see GATE below).

package/template/.issflow/commands/propose.md

@@ -1,17 +1,18 @@
 ---
-description: Turn approved requirements + tech stack into a client proposal — scope, phase breakdown, effort + cost estimate, timeline, assumptions, and a sign-off gate. Run after /overview, before building.
+description: Turn approved requirements + tech stack into a client proposal — scope, packages, effort + cost estimate, timeline, assumptions, screen appendix, and a sign-off gate. Run after /overview, before building.
 argument-hint: [optional: rate / budget / constraints · "dry-run" to preview]
 ---
 
 Caveman ULTRA mode. You are the ORCHESTRATOR.
 
-Purpose: produce `docs/PROPOSAL.md` — WHAT we build, in what phases, how long, how
+Purpose: produce `docs/PROPOSAL.md` — WHAT we build, in what packages, how long, how
 much, and on what assumptions — for the client to approve BEFORE any build starts.
 A proposal is a commercial gate: always interactive (both AUTO and GUIDED).
 
 DRY-RUN: if `$ARGUMENTS` contains `dry-run`/`--dry-run`, do the full analysis but
-EXECUTE NOTHING — print the ACTION PLAN (scope, phase breakdown, rough estimate)
-and STOP. No PROPOSAL.md / proposal.html is written. (METHODOLOGY → Dry-run.)
+EXECUTE NOTHING — print the ACTION PLAN (scope, phase breakdown, package collapse,
+rough estimate) and STOP. No PROPOSAL.md / proposal.html is written.
+(METHODOLOGY → Dry-run.)
 
 ## PRE-FLIGHT
 Read `docs/OVERVIEW.md` (scope, stack, success criteria) and `docs/PRD.md` if
@@ -28,12 +29,15 @@ List the deliverables (features / epics) from OVERVIEW / PRD. Mark each
 **in-scope** or **out-of-scope** explicitly — naming out-of-scope items now is what
 prevents silent scope creep (and grounds change-order re-pricing later).
 
-## STEP 2 — PHASE BREAKDOWN
+## STEP 2 — PHASE BREAKDOWN (internal)
 Derive the vertical-slice phases (or read `docs/PLAN.md` if it exists). Size each:
 - complexity: **S | M | L | XL**
 - effort: an ideal-days RANGE (e.g. 2–3d), + story points if your team uses them
 - risk / unknowns: what could move the estimate
 
+Keep this sizing for the **chat math**. Do **not** dump every PLAN phase onto the
+client table — collapse into packages in STEP 5.
+
 ## STEP 3 — ESTIMATE (ask rate · never invent a kit default)
 Estimation config is **project-private**. The public kit ships **no** default rate
 card and **no** sample salary/rate numbers — rates are confidential.
@@ -46,22 +50,35 @@ card and **no** sample salary/rate numbers — rates are confidential.
 3. Optional: store the answered rate/contingency in a **project-local** file the
    team keeps private (e.g. `docs/ESTIMATE.local.md` gitignored, or OVERVIEW fields
    that never get published). Never commit personal rate/salary into a public kit
-   or template.
+   or template. If you create `docs/ESTIMATE.local.md`, add it to the project's
+   `.gitignore` when it is not already listed.
 4. Configurable fields (ask or read — no invented kit defaults for money):
    - **unit:** ideal-days | hours | story-points | both
    - **rate card:** blended OR per-role (senior / mid / junior…)
    - **currency:** as declared (ask if unset; THB is common for Thai clients)
    - **contingency:** % buffer for unknowns (ask if unset)
-   - **payment milestones:** by-phase, split (e.g. 30/40/30), or none
+   - **payment split:** e.g. 30/40/30 — **ASK once; do not guess** a ratio
    - **language:** rendered doc language (default = project language)
 
+Ask these **once each** if unset (commercial input — do not invent kit defaults):
+
+- **Hours columns:** does the client table show estimated hours next to billed
+  hours? If yes → columns ประเมิน / คิดเงิน / ยอด. If no / unset → ชุดงาน + ยอด
+  only. Hours are effort, not a rate — still never print the rate.
+- **Managed hosting / database:** is platform hosting+database **in** the quoted
+  total? If **not included**, write clearly on page 1 (out of scope + exclusions)
+  that the client pays the provider directly. A one-line exclusion is enough —
+  do **not** paste vendor SKU/price tables into the kit or invent list prices.
+- **Bank:** include a bank block **only if the human provides** account details
+  in this project. No kit default. If none given, omit the column.
+
 Compute cost per phase, then a **Total as a RANGE (low–high)** that already folds
 in contingency. Show the math **in chat to the human** (rate × effort + contingency).
 **Timeline:** phases in dependency order → calendar estimate (note parallelism).
 
 ### CLIENT-DOC RULE (hard — commercial privacy)
 Client-facing artifacts (`docs/PROPOSAL.md` client sections, `docs/proposal.html`,
-and any PDF/print) MUST show **totals and phase costs only**.
+and any PDF/print) MUST show **totals and package costs only**.
 **Never** print: hourly/day rates, rate cards, contingency %, “incl. X% buffer”,
 salary, or the estimate math. Contingency is already inside the numbers — do not
 label it on the client page.
@@ -71,38 +88,83 @@ List every assumption the estimate rests on (infra provided, third-party/licence
 costs excluded, content/design provided, etc.). These are the baseline that
 change-orders re-price against.
 
+If hosting/database is not in the quote, the exclusion **must** say the client
+pays the provider directly.
+
 ## STEP 5 — WRITE + RENDER
+Collapse the internal PLAN phases into **3–6 client packages / sprints** that a
+non-engineer can read. PLAN may have any number of phases; the sign page does not
+list them all.
+
+Payment copy = short **software delivery events** tied to those packages, e.g.
+deposit on sign-off then work starts · when the main package is usable · when
+production is up within the scope on this quote. **Never** construction wording
+(% structure, house handover, site prep / equipment staging).
+
 1. Write `docs/PROPOSAL.md` — the SOURCE OF TRUTH (versioned v1 + date). This is
    what `CHANGES.md` re-prices against. **Client-safe** body (no rate / no
    contingency %):
 ```
 # Proposal — <project>   (v1, <date>)
 ## Scope        — in-scope: … | out-of-scope: …
-## Phases       — table: phase | complexity | effort (range) | cost
+## Packages     — table: package | cost
+                — or package | estimated | billed | cost  (only if hours columns requested)
 ## Total        — <low>–<high>   ← totals only; no “incl. X% contingency”
 ## Timeline     — <estimate>, dependency order
 ## Assumptions  — …
-## Exclusions   — …
-## Payment      — milestones (if any)
+## Exclusions   — … (hosting/database: client pays provider, if that was the answer)
+## Payment      — software delivery events + the asked split (if any)
+## Screens      — docs/proposal.html pages 2–N (or “none — no UI in scope”)
+                — not pixel-binding; sign page 1 only; page count must match the HTML
 ## Sign-off     — approved by: ___  date: ___  version: v1
 ```
+   Point the Screens section at the **real** HTML page range after render
+   (page 1 = sign · remaining sheets = screen appendix). Keep PROPOSAL.md and
+   `docs/proposal.html` in sync.
    If you keep an internal rate memo, put it in a **separate private** file (not
    the client PROPOSAL.md / HTML). PROPOSAL.md itself stays client-safe so it can
    be shared.
 
-2. RENDER a client-facing `docs/proposal.html` from `.issflow/templates/proposal.html`:
-   copy it, replace every `{{PLACEHOLDER}}`, and fill the CONTENT in the declared
-   language (the section labels are already bilingual TH / EN). It must fit ONE A4
-   page — be terse (≈ 3–6 phase rows, ≈ 4 assumptions, short scope items); trim before
-   it spills to a second page. Fill `{{COMPANY}}` / `{{COMPANY_TAGLINE}}` / `{{LOGO}}`
-   from the ISSUING company's brand declared in OVERVIEW (or ask once) — white-label,
-   never hardcode the kit's name. Leave `{{TOTAL_NOTE}}` empty or a non-rate line
+2. RENDER a client-facing `docs/proposal.html` from `.issflow/templates/proposal.html`
+   (Claude Code also mirrors this under `.claude/templates/` — same file). Copy it,
+   replace every `{{PLACEHOLDER}}`, and fill the CONTENT in the declared language
+   (the section labels are already bilingual TH / EN).
+
+   **Page 1 = the only signable A4 sheet.** Be terse (≈ 3–6 package rows, ≈ 4
+   assumptions, short scope items). If page 1 overflows A4, **trim the sign-page
+   copy first** — never spill the sign block onto page 2. The screen appendix may
+   grow extra `.sheet` pages.
+
+   Fill `{{PACKAGE_TABLE}}` with the matching header:
+   - default: ชุดงาน / Packages + Cost
+   - if hours columns requested: ประเมิน / คิดเงิน / ยอด (and EN equivalents)
+   Fill `{{BANK_COL}}` only when the human gave bank details; otherwise leave
+   empty so payment takes the full width.
+   Fill `{{COMPANY}}` / `{{COMPANY_TAGLINE}}` / `{{LOGO}}` from the ISSUING
+   company's brand declared in OVERVIEW (or ask once) — white-label, never
+   hardcode the kit's name. Leave `{{TOTAL_NOTE}}` empty or a non-rate line
    (e.g. currency / “ราคารวมทั้งโครงการ”) — **never** a contingency % or rate.
+   Set `{{PAGE_FOOTER}}` to the real page count (e.g. sign page 1 of N).
+
+   **Screen appendix (required when UI is in scope)** — same `docs/proposal.html`,
+   not a second signable file. After page 1's page-break, emit `.sheet.screens`
+   into `{{SCREEN_SHEETS}}`:
+   - Build frames from **PLAN + OVERVIEW** modules/capabilities (empty chrome is
+     fine). Do **not** wait for UX-PACK (that gate is after sign-off).
+   - Cover **every** in-scope module and capability — not a 4–8 frame sampler.
+   - Group sheets by package; module bar on each sheet; numbered short captions
+     under frames.
+   - Label: not pixel-binding. Sign on page 1 only. **No emoji as icons.**
+   - Use the template's desk/phone/sidebar/card/table CSS. Do not invent a
+     parallel stylesheet.
+
    Print-ready (Ctrl/Cmd-P → A4 → Save as PDF). Keep PROPOSAL.md and proposal.html
    in sync.
 
 ## STEP 6 — SIGN-OFF GATE
 Show me the proposal. **STOP for approval** (commercial gate — always interactive).
+Do **not** run `/design` or `/phase` yourself.
+
 On approval: record the approved version + date in PROPOSAL.md and STATE.md, and
 append a HISTORY line `proposal v<n> approved (<total>)`.
 

package/template/.issflow/istartsoft-flow/METHODOLOGY.md

@@ -34,10 +34,13 @@
 
 Caveman ULTRA mode always on. Apply the `karpathy-guidelines` skill (engineering
 discipline) on every coding and debugging task. Apply the `ux-design` skill (the UX
-cookbook + wireframe baseline) on every UI-facing task. Apply the `security` skill
-(the Secure SDLC cookbook) at design (threat model), while coding (secure coding),
-and before any deploy. Apply the `code-standards` skill (naming per the language's
-own idiom + the declared architecture) on every coding task.
+cookbook + wireframe baseline) on every UI-facing task. When **authoring** a new
+visual direction (`/design`, or no approved UX-PACK yet), apply `ui-ux-pro-max`
+first and fold the look into the UX pack — do not re-roll styles at phase CLOSE.
+Apply the `security` skill (the Secure SDLC cookbook) at design (threat model),
+while coding (secure coding), and before any deploy. Apply the `code-standards`
+skill (naming per the language's own idiom + the declared architecture) on every
+coding task.
 
 -----
 
@@ -109,10 +112,12 @@ from idea to closeout:
    the proposal estimates *these* phases.
 5. **Proposal & estimate (OPTIONAL — depends on the job)** — for client / quoted
    work, `/propose` reads OVERVIEW + PLAN → `docs/PROPOSAL.md` + a rendered
-   `docs/proposal.html`: scope, phase breakdown, effort + cost estimate, timeline,
-   assumptions, with a **client sign-off gate** before build. **Ask rate +
-   contingency in chat** when missing — the kit stores **no** default rate (rates
-   are confidential). Client docs show **totals only** (never rate or contingency %).
+   `docs/proposal.html`: scope, **package** rows on the signable A4 page (not every
+   PLAN phase), effort + cost estimate, timeline, assumptions, and a screen
+   appendix in the **same HTML** after a page-break, with a **client sign-off gate**
+   before build. **Ask rate + contingency in chat** when missing — the kit stores
+   **no** default rate (rates are confidential). Client docs show **totals only**
+   (never rate or contingency %).
    Internal / personal projects skip straight from plan to build (and may set
    design/architecture gates to `n/a`).
 6. **Design + architecture gates (rule 15 — after proposal, before build)** —
@@ -153,7 +158,7 @@ those gates, never the plan, the money, or the design/arch frame.
 | House role | Kit surface |
 |------------|-------------|
 | BA / PM | `/overview` grill · `grill-me` · PLAN / PROPOSAL / CR gates |
-| UX / UI | `/design` (UX pack) · `ux-design` skill · `/ui-audit` · rule 9 CLOSE |
+| UX / UI | `/design` (UX pack) · `ui-ux-pro-max` (look) · `ux-design` (frame + gate) · `/ui-audit` · rule 9 CLOSE |
 | Architect | `/design` (ARCHITECTURE) · `researcher` DESIGN · `code-standards` · `/log-decision` |
 | Developer | `implementer` · `/phase` · `/feature` · `/quick` |
 | QA | `test-author` · `e2e-runner` · `/qa-audit` · `/uat` |
@@ -620,10 +625,12 @@ the KB. The kit works normally without a KB.
 ## File contract
 
 - `docs/PRD.md` — crystallised product requirements (or your BMAD/iSSM stories).
-- `docs/PROPOSAL.md` — scope + phase breakdown + effort/cost totals + assumptions
-  + sign-off. Versioned; client-safe commercial baseline (no rate / contingency %).
+- `docs/PROPOSAL.md` — scope + package rows + effort/cost totals + assumptions
+  + screen-appendix page range + sign-off. Versioned; client-safe commercial
+  baseline (no rate / contingency %).
 - `docs/proposal.html` — the client-facing proposal, rendered from PROPOSAL.md via
-  `.issflow/templates/proposal.html`, in the project language; print-ready (PDF).
+  `.issflow/templates/proposal.html`, in the project language; page 1 is the
+  signable A4 sheet, then screen frames in the same file (print A4).
 - `docs/UX-PACK.md` · `docs/ARCHITECTURE.md` — pre-build design/arch frames
   (rule 15); templates under `.issflow/templates/`.
 - `.issflow/templates/` — document templates (proposal.html, UX-PACK, ARCHITECTURE,
@@ -687,6 +694,8 @@ the KB. The kit works normally without a KB.
   `scripts/regression.sh` (default mock; `--real` runs the real corpus).
 - `.issflow/skills/ux-design/` — the UX cookbook + wireframe baseline (read on
   demand for any UI work).
+- `.issflow/skills/ui-ux-pro-max/` — visual direction for `/design` (vendored
+  search engine + catalogue; MIT upstream).
 - `.issflow/skills/security/` — the Secure SDLC cookbook + threat-modeling /
   secure-coding / pentest / standards references (read on demand for security work).
 - `.issflow/skills/code-standards/` — naming-per-language + architecture cookbook

package/template/.issflow/skills/ui-ux-pro-max/LICENSE.upstream

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Next Level Builder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/template/.issflow/skills/ui-ux-pro-max/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: ui-ux-pro-max
+description: >
+  Design intelligence for NEW visual direction — styles, palettes, type, landing
+  patterns. Use when authoring `/design` UX-PACK, setting OVERVIEW UX direction,
+  or the project has no approved UX pack yet. Triggers: "/design", "UX pack",
+  "visual direction", "design system", "palette", "typography", "landing pattern",
+  "ทิศทางดีไซน์", "โทนสี". Skip for backend, and skip re-rolling styles when an
+  approved UX-PACK already exists (follow that frame; validate with ux-design).
+---
+
+# ui-ux-pro-max — visual direction (authoring)
+
+Vendored from [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)
+(MIT — see `LICENSE.upstream` + `UPSTREAM.md`). Engine lives **in this folder**.
+
+`ux-design` remains the **gate** (hard rule 9 — wireframe + cookbook). This skill
+picks the **look**. Do not let a catalogue restyle override an approved UX pack.
+
+## When
+
+- `/design` STEP 1 (author the UX pack) — **required** when UI is in scope.
+- First visual direction (OVERVIEW UX / no approved `docs/UX-PACK.md`).
+- Human explicitly asks to restyle — then re-run and wait for UX-PACK re-approve.
+
+**Not** at `/phase` CLOSE. CLOSE = `ux-design` cookbook against the approved pack.
+Do not run `--design-system` again per slice.
+
+## Engine
+
+```
+python3 .issflow/skills/ui-ux-pro-max/scripts/search.py
+```
+
+If this project's kit was mirrored for Claude Code, the same files exist under
+`.claude/skills/ui-ux-pro-max/` — use whichever path is present.
+
+Try `python3`, then `python`, then `py -3`. Stdlib only. If Python 3 is missing,
+**ask the human** to install it (python.org / Homebrew / apt). Do not install
+Python or npm yourself. Do not tell them to run `uipro init` — the catalogue
+is already in the kit.
+
+On-demand detail: `references/quick-reference.md`, `references/pro-rules.md`.
+
+## Authoring workflow
+
+1. Product / industry / keywords from OVERVIEW + PLAN (2–5 terms). Detect stack
+   from the project; never assume HTML+Tailwind.
+2. Run:
+
+```
+python3 .issflow/skills/ui-ux-pro-max/scripts/search.py "<product> <industry> <keywords>" --design-system -p "<project>" -f markdown
+```
+
+   Retry once if empty. Do not persist unverified output. Do **not** pass
+   `--persist` / do **not** write a parallel `design-system/` tree — fold into
+   `docs/UX-PACK.md` → Frame & tokens (style, palette, type, effects,
+   anti-patterns). Kit SoT stays UX-PACK.
+3. Optional domain search only for a named gap:
+
+```
+python3 .issflow/skills/ui-ux-pro-max/scripts/search.py "<query>" --domain ux|icons|chart|typography|style|color|landing
+python3 .issflow/skills/ui-ux-pro-max/scripts/search.py "<query>" --stack <detected>
+```
+
+4. Then apply `ux-design` authoring (wireframe + cookbook). Catalogue must still
+   pass: no emoji icons, tokens not raw hex in components, WCAG AA.
+
+If UX-PACK is already **approved**, read it and stop — unless the human asked to
+change the look.

package/template/.issflow/skills/ui-ux-pro-max/UPSTREAM.md

@@ -0,0 +1,4 @@
+upstream: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
+commit: 623a9a9
+license: MIT (LICENSE.upstream)
+omitted: scripts/tests, validate_data.py, phosphor-icons-upstream.json, google-font-licenses.json

package/template/.issflow/skills/ui-ux-pro-max/data/app-interface.csv

@@ -0,0 +1,33 @@
+No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code Example Bad,Severity
+1,Accessibility,Icon Button Labels,icon button accessibilityLabel,iOS/Android/React Native,Icon-only buttons must expose an accessible label,Set accessibilityLabel or label prop on icon buttons,Icon buttons without accessible names,"<Pressable accessibilityLabel=""Close""><XIcon /></Pressable>",<Pressable><XIcon /></Pressable>,Critical
+2,Accessibility,Form Control Labels,form input label accessibilityLabel,iOS/Android/React Native,All inputs must have a visible label and an accessibility label,Pair Text label with input and set accessibilityLabel,Inputs with placeholder only,"<View><Text>Email</Text><TextInput accessibilityLabel=""Email address"" /></View>","<TextInput placeholder=""Email"" /></View>",Critical
+3,Accessibility,Role & Traits,accessibilityRole accessibilityTraits,iOS/Android/React Native,Interactive elements must expose correct roles/traits,Use accessibilityRole/button/link/checkbox etc.,Rely on generic views with no roles,"<Pressable accessibilityRole=""button"">Submit</Pressable>",<View onTouchStart={submit}>Submit</View>,High
+4,Accessibility,Dynamic Updates,accessibilityLiveRegion announce,iOS/Android/React Native,Async status updates should be announced to screen readers,Use accessibilityLiveRegion or announceForAccessibility,Update text silently with no announcement,"<Text accessibilityLiveRegion=""polite"">{status}</Text>",<Text>{status}</Text>,Medium
+5,Accessibility,Decorative Icons,accessible={false} importantForAccessibility,iOS/Android/React Native,Decorative icons should be hidden from screen readers,Mark decorative icons as not accessible,Have screen reader read every icon,"<Icon accessible={false} importantForAccessibility=""no"" />",<Icon />,Medium
+6,Touch,Touch Target Size,touch target size platform runtime arbitration iOS 44pt Android 48dp web 24 CSS px React Native hitSlop,iOS/Android/React Native,Native targets use 44pt on iOS and 48dp on Android; web WCAG 2.2 has a separate 24 by 24 CSS px minimum with exceptions,Select 44pt for iOS and 48dp for Android at runtime; evaluate web targets separately against WCAG 2.5.8 and its exceptions,"Collapse iOS 44pt, Android 48dp, and web 24 CSS px into one cross-platform number","Platform.select({ ios: 44, android: 48 }); // web: evaluate 24 CSS px + WCAG exceptions",<Pressable><Icon size={16} /></Pressable>,Critical
+7,Touch,Touch Spacing,touch spacing gap 8px,iOS/Android/React Native,Adjacent touch targets need enough spacing,Keep at least 8dp spacing between touchables,Cluster many buttons with no gap,<View style={{ gap: 8 }}><Button ... /><Button ... /></View>,<View><Button ... /><Button ... /></View>,Medium
+8,Touch,Gesture Conflicts,scroll swipe back gesture,iOS/Android/React Native,Custom gestures must not break system scroll/back,Reserve horizontal swipes for carousels,Full-screen custom swipe conflicting with back,HorizontalPager inside vertical ScrollView,PanResponder on full screen blocking back,High
+9,Navigation,Back Behavior,back handler navigation stack,iOS/Android/React Native,Back navigation should be predictable and preserve state,Use navigation.goBack and keep screen state,Reset stack or exit app unexpectedly,onPress={() => navigation.goBack()},BackHandler.exitApp() on first press,Critical
+10,Navigation,Bottom Tabs,tab bar max items,iOS/Android/React Native,Bottom tab bar should have at most 5 primary items,Use 3–5 tabs and move extras to More/Settings,Overloaded tab bar with many icons,Home/Explore/Profile/Settings,Home/Explore/Shop/Cart/Profile/Settings/More,Medium
+11,Navigation,Modal Escape,modal dismiss close affordance,iOS/Android/React Native,Modals/sheets must have clear close actions,Provide close button and swipe-down where platform expects,Trapping users in modal with no obvious exit,"<Modal><Button title=""Close"" onPress={onClose} /></Modal>",<Modal><View>{children}</View></Modal>,High
+12,State,Preserve Screen State,navigation preserve state,iOS/Android/React Native,Returning to a screen should restore its scroll and form state,Keep components mounted or persist state,Reset list scroll and form inputs on every visit,<Tab.Navigator screenOptions={{ unmountOnBlur: false }}>,<Tab.Screen options={{ unmountOnBlur: true }} />,Medium
+13,Feedback,Loading Indicators,activity indicator skeleton,iOS/Android/React Native,Show visible feedback during network operations,Use ActivityIndicator or skeleton for >300ms operations,Leave button and screen frozen,"{loading ? <ActivityIndicator /> : <Button title=""Save"" />}"," ""<Button title=""""Save"""" onPress={submit} /> // no loading""",High
+14,Feedback,Success Feedback,toast checkmark banner,iOS/Android/React Native,Confirm successful actions with brief feedback,Show toast/checkmark or banner,Complete actions silently with no confirmation,showToast('Saved successfully'),// silently update state only,Medium
+15,Feedback,Error Feedback,inline error banner,iOS/Android/React Native,Show clear error messages near the problem,input-level error + summary banner,Only change border color with no explanation,<TextInput ... /><Text style={{color:'red'}}>{error}</Text>,<TextInput style={{borderColor:'red'}} />,High
+16,Forms,Inline Validation,onBlur validation,iOS/Android/React Native,Validate inputs on blur or submit with clear messaging,Validate onBlur and onSubmit,Validate on every keystroke causing jank,onBlur={() => validateEmail(value)},onChangeText={v => validateEmail(v)} // every char,Medium
+17,Forms,Keyboard Type,keyboardType returnKeyType,iOS/Android/React Native,Use appropriate keyboardType and returnKeyType,Match email/tel/number/search types,Use default keyboard for all inputs,"<TextInput keyboardType=""email-address"" />","<TextInput keyboardType=""default"" />",Medium
+18,Forms,Auto Focus & Next,autoFocus blurOnSubmit onSubmitEditing,iOS/Android/React Native,Guide users through form fields with Next/Done flows,Use onSubmitEditing to focus next input,Force users to tap each field manually,onSubmitEditing={() => nextRef.current?.focus()},"// no onSubmitEditing, manual tap only",Low
+19,Forms,Password Visibility,secureTextEntry toggle,iOS/Android/React Native,Allow toggling password visibility securely,Provide Show/Hide icon toggling secureTextEntry,Force users to type blind with no option,<TextInput secureTextEntry={secure} /><Icon onPress={toggle} />,<TextInput secureTextEntry /> // no toggle,Medium
+20,Performance,Virtualize Long Lists,FlatList SectionList virtualization,iOS/Android/React Native,Use FlatList/SectionList for lists over ~50 items,Use keyExtractor and initialNumToRender appropriately,Render hundreds of items with ScrollView,<FlatList data={items} renderItem={...} />,<ScrollView>{items.map(renderItem)}</ScrollView>,High
+21,Performance,Image Size & Cache,Image resize cache,iOS/Android/React Native,Use correctly sized and cached images,Use Image component with proper resizeMode and caching,Load full-resolution images everywhere,"<Image source={{uri}} resizeMode=""cover"" />",<Image source={require('4k.png')} /> // small avatar,Medium
+22,Performance,Debounce High-Freq Events,debounce scroll search,iOS/Android/React Native,Debounce scroll/search callbacks to avoid jank,Wrap handlers with debounce/throttle,Run heavy logic on every event,onScroll={debouncedHandleScroll},onScroll={handleScrollHeavy},Medium
+23,Animation,Duration & Easing,animation duration easing,iOS/Android/React Native,Micro-interactions should be 150–300ms with native-like easing,Use ease-out for enter/ease-in for exit,Use long or linear animations for core UI,"Animated.timing(..., { duration: 200, easing: Easing.out(Easing.quad) })","Animated.timing(..., { duration: 800, easing: Easing.linear })",Medium
+24,Animation,Respect Reduced Motion,reduced motion accessibility,iOS/Android/React Native,Respect OS reduced-motion accessibility setting,Check reduceMotionEnabled and simplify animations,Ignore user motion preferences,if (reduceMotionEnabled) skipAnimation(),Always run complex parallax animations,Critical
+25,Animation,Limited Continuous Motion,loop animation loader,iOS/Android/React Native,Reserve infinite animations for loaders and live data,Use looping only where necessary,Keep decorative elements looping forever,Animated.loop(loaderAnim) for ActivityIndicator,Animated.loop(bounceAnim) on background icons,Medium
+26,Typography,Base Font Size,fontScale dynamic type,iOS/Android/React Native,Body text must be readable and support Dynamic Type,Use platform fontScale and at least 14–16pt base,Render critical text below 12pt,<Text style={{ fontSize: 16 }}>Body</Text>,<Text style={{ fontSize: 10 }}>Body</Text>,High
+27,Typography,Dynamic Type Support,allowFontScaling adjustsFontSizeToFit,iOS/Android/React Native,Support system text scaling without breaking layout,Set allowFontScaling and test large text,Disable scaling on all text globally,<Text allowFontScaling>{label}</Text>,<Text allowFontScaling={false}>{label}</Text>,High
+28,Safe Areas,Safe Area Insets,safe area insets notch gesture,iOS/Android/React Native,Content must not overlap notches/gesture bars,Wrap screens in SafeAreaView or apply insets,Place tappable content under system bars,<SafeAreaView style={{ flex: 1 }}><Screen /></SafeAreaView>,<View style={{ flex: 1 }}><Screen /></View>,High
+29,Theming,Light/Dark Contrast,dark mode contrast tokens,iOS/Android/React Native,Ensure sufficient contrast in both light and dark themes,Use semantic tokens and test both themes,Reuse light-theme grays directly in dark mode,colors.textPrimaryDark = '#F9FAFB',colors.textPrimaryDark = '#9CA3AF' on '#111827',High
+30,Anti-Pattern,No Gesture-Only Actions,gesture only hidden controls,iOS/Android/React Native,Don't rely solely on hidden gestures for core actions,Provide visible buttons in addition to gestures,Rely on swipe/shake only with no UI affordance,Swipe to delete + visible Delete button,Only shake device to undo with no UI,Critical
+31,Accessibility,Dragging Alternatives,accessible drag interaction drag single pointer alternative keyboard drag alternative reorder resize move buttons React Native native runtime platform router arbitration iOS Android web,iOS/Android/React Native,React Native drag and reorder operations need a non-drag path selected for the active native runtime,Provide named Move up/down buttons or a position menu beside drag handles; route iOS and Android behavior through the runtime platform adapter,"Make drag, swipe, or a web-only pointer handler the only way to reorder native content","<Button title=""Move up"" onPress={() => moveItem(index, index - 1)} />",<DragHandle /> only,High
+32,Forms,Authentication Reuse,password manager passkey paste redundant entry,iOS/Android/React Native,Authentication and multi-step flows should reuse prior values,Support password managers passkeys paste and prefilled confirmed values,Force users to retype credentials or the same data in one flow,"textContentType=""password"" autoComplete=""current-password""",onPaste disabled,Critical

package/template/.issflow/skills/ui-ux-pro-max/data/catalog-summary.json

@@ -0,0 +1,78 @@
+{
+  "schemaVersion": 1,
+  "verifiedAt": "2026-08-26",
+  "counts": {
+    "styles": {
+      "total": 88,
+      "searchable": 79,
+      "active": 50,
+      "supplemental": 29,
+      "deprecated": 9
+    },
+    "products": 192,
+    "palettes": 192,
+    "reasoningProfiles": 192,
+    "fontPairings": 74,
+    "googleFonts": 1934,
+    "curatedIcons": 105,
+    "upstreamPhosphorIcons": 1512,
+    "uxGuidelines": 119,
+    "motionPresets": 17,
+    "chartTypes": 25,
+    "stacks": 22,
+    "stackGuidelines": 1271
+  },
+  "snapshots": {
+    "google-fonts.csv": {
+      "sha256": "1c8c3b2ea1faf6a1012da463756def8b3889db33f2226f0343bb4daa80307d03"
+    },
+    "google-font-licenses.json": {
+      "sha256": "35688523f2955795caa1a47c53b83099e60c1708461476f9cc3a050cf3b0148a"
+    },
+    "icons.csv": {
+      "sha256": "50816c6012030178195a16ee481ebf58b47bd985d70e8ec58886cc83f6eddafc"
+    },
+    "phosphor-icons-upstream.json": {
+      "sha256": "2399325233b277b5c97a80e6a5e8941154f5d057beee4e7613db87c87d700236"
+    }
+  },
+  "promotionPolicy": {
+    "changedFamilySetRequiresExplicitApproval": true,
+    "relevanceGateRequired": true,
+    "unlicensedFamiliesExcluded": true
+  },
+  "pendingCandidates": [
+    {
+      "family": "Edu NSW ACT Cursive",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu NSW ACT Hand Pre",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu QLD Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu SA Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu VIC WA NT Hand",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Edu VIC WA NT Hand Pre",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Google Sans",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    },
+    {
+      "family": "Google Sans Flex",
+      "reason": "No exact-family METADATA.pb entry in the official google/fonts repository snapshot"
+    }
+  ]
+}