super-ux 0.65.0 → 0.66.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 0.66.0 (2026-10-22): portfolios, creators and LLM referrals from GP Bullhound (2025)
+
+- **Two practices for a portfolio, BP-246..247** (source key `[GPB25]`): bundle the subscriptions a user already combines, at one price below the sum, judged against a same-cohort comparison or a holdout because bundle takers self-select (the report's "up to 50%" lower churn is a ceiling, p. 19); run a portfolio as one account, offer a sibling product as the single save offer, and report each product's retention beside the portfolio's (p. 26). Routed in `practice-selection.md` (a new plan-lineup row and the cancel/winback row); the catalog holds 247 practices.
+- **`funnel-research.md` → *AI answers as an acquisition channel*:** LLM referrals are counted as a channel of their own, one referrer row per assistant, read beside the self-reported share from the "How did you hear about us?" question and inside the organic share band; the zero-click share (40%) and the later conversion through search or the stores are cited by page (pp. 21, 39, 49, 50). The citation-source audit of public surfaces is named as the **seo-aeo-audit** skill's, not repeated. `practice-selection.md` routes it from the `analytics: yes` row.
+- **`ux-flows`, money moments:** a change to a paywall, trial, pricing or cancel flow states in its brief which *Your own numbers* metric it moves and the band it targets, and is judged on that metric.
+- **`copywriting` → `channel-playbooks.md` *Creators and ambassadors*:** creator programs priced and briefed per market, members telling their own story over reach, the cohort state each brief targets, a public figure only when their values match the product's, disclosure under the FTC Endorsement Guides, and creators judged by the locals they bring (pp. 29, 39, 42 to 44).
+
 ## 0.65.0 (2026-10-22): subscription economics, cohorts and four practices from GP Bullhound (2025)
 
 - **`funnel-research.md` → *Your own numbers*:** the unit economics a running subscription funnel is read by, each with its formula and the investor band it is judged against (LTV/CAC under 3x weak, 6x strong; CAC payback under 3 months; first-period annual retention under 30% weak, over 60% strong; renewal of 60%+ of each annual cohort and 40% of year 2; free-to-paid under 2% weak, 10%+ strong; organic share under 20% weak, over 50% strong), and two cohort cuts: the four states (new, current, reactivated, resurrected) and the locals/tourists split, with LTV per cohort and acquisition judged by the locals a channel brings rather than by ROAS. Cited by page from GP Bullhound's *Consumer Subscription Software* (October 2025), pp. 39, 65 to 67 and 71.

package/README.md

@@ -264,9 +264,9 @@ The contracts every skill reads:
 | [ux_doctor.py](plugins/super-ux/scripts/ux_doctor.py) | Contract doctor. It reports mixed or stale contract versions across a project's artifacts, files the tooling cannot find under their contract names, and audits produced against a base that is not there. `/ux-lint` checks a chain against itself; this checks it against the contract. Installed as `docs/ux/doctor.py`, read-only unless `--fix` |
 | [best-practices-index.md](plugins/super-ux/skills/references/best-practices-index.md) | Generated tag index over the catalog: tag → ids, id → title. Read it to decide which entries to open; regenerated by `plugins/super-ux/scripts/bp_index.py` and checked for drift by the validator |
 | [ux-design-principles.md](plugins/super-ux/skills/references/ux-design-principles.md) | How the agent thinks: the design pipeline (forward and backwards), task analysis, flow rules, heuristics PRN-01..24, the improvement procedure, anti-patterns |
-| [best-practices.md](plugins/super-ux/skills/references/best-practices.md) | Living, tag-indexed catalog of 245 proven practices: subscription-app laws, mobile/web/voice guidance (Apple HIG 2025, M3 Expressive, NN/g, Baymard, WCAG 2.2), monetization economics (RevenueCat/PLG 2025 benchmarks, ASO, freemium boundaries), web funnels end to end (landing, pricing, checkout, dunning, cancel), web2app (paid handoff, deferred deep links, storefront rules) and the funnel wiring that fails invisibly (what a personalization branch may vary, stand-up order, the three decisions a stored answer carries, GDPR Art. 13/17 timing, the access ladder), motion and page weight (HTTP Archive field data, W3C sustainability), accessibility as it actually fails (WebAIM Million, EAA/ADA exposure), frustration telemetry, gamification and trend governance, growth loops and referral mechanics, empty states, authentication (NIST SP 800-63B rev 4) and form recovery, motion craft and perceived quality, the defaults that make an interface read as generated, interface state, locale and platform surfaces (Web Interface Guidelines), visual craft, Figma structure |
+| [best-practices.md](plugins/super-ux/skills/references/best-practices.md) | Living, tag-indexed catalog of 247 proven practices: subscription-app laws, mobile/web/voice guidance (Apple HIG 2025, M3 Expressive, NN/g, Baymard, WCAG 2.2), monetization economics (RevenueCat/PLG 2025 benchmarks, ASO, freemium boundaries), web funnels end to end (landing, pricing, checkout, dunning, cancel), web2app (paid handoff, deferred deep links, storefront rules) and the funnel wiring that fails invisibly (what a personalization branch may vary, stand-up order, the three decisions a stored answer carries, GDPR Art. 13/17 timing, the access ladder), motion and page weight (HTTP Archive field data, W3C sustainability), accessibility as it actually fails (WebAIM Million, EAA/ADA exposure), frustration telemetry, gamification and trend governance, growth loops and referral mechanics, empty states, authentication (NIST SP 800-63B rev 4) and form recovery, motion craft and perceived quality, the defaults that make an interface read as generated, interface state, locale and platform surfaces (Web Interface Guidelines), visual craft, Figma structure |
 | [practice-selection.md](plugins/super-ux/skills/references/practice-selection.md) | The deterministic bridge: product profile → mandatory consideration sets → per-artifact checklists → a compliance table where every pulled practice gets a verdict. No silent skips, no cargo cult |
-| [funnel-research.md](plugins/super-ux/skills/references/funnel-research.md) | Reading a funnel market before designing one, `FR-01..FR-07`: where competitor funnels are visible, the four signals that survive when revenue is invisible, the fields that make a corpus comparable, which adjacent categories transfer, the stop before copying, and where each finding lands in the chain. Carried by `ux-foundation` and `ux-flows` |
+| [funnel-research.md](plugins/super-ux/skills/references/funnel-research.md) | Reading a funnel market before designing one, `FR-01..FR-07`: where competitor funnels are visible, the four signals that survive when revenue is invisible, the fields that make a corpus comparable, which adjacent categories transfer, the stop before copying, and where each finding lands in the chain; then *Your own numbers*: the subscription unit economics with investor bands, the cohort states, locals and tourists, and LLM referrals as a channel. Carried by `ux-foundation` and `ux-flows` |
 | [component-guidelines.md](plugins/super-ux/skills/references/component-guidelines.md) | Which control for which job (radios/select/switch, sheet/alert, modal/disclosure, combobox, nav bar/rail, FAB, dates, toasts) and the platform rules of Apple HIG, Material 3, W3C ARIA APG and GOV.UK |
 | [visual-identity.md](plugins/super-ux/skills/references/visual-identity.md) | The visual layer and its owner: `/sheleg-design` decides the one style pack, directions come before frames when the brief leaves the look open, the slop-marker floor holds even with no pack, and how the pack meets Figma and code |
 | [figma-integration.md](plugins/super-ux/skills/references/figma-integration.md) · [figma-structure.md](plugins/super-ux/skills/references/figma-structure.md) | The optional Figma surface (on by default): one file per surface (App, Web, ASO), frames critiqued against the director record before anyone approves the look, flow and art direction approved separately, and frames named `SCR-NN/<Screen>/<state>` that map 1:1 to `screens.md`, giving deterministic lookup and checkable drift |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-ux",
-  "version": "0.65.0",
+  "version": "0.66.0",
   "scripts": {
     "test": "python3 test/validate.py && python3 test/brand_lint_test.py && python3 test/display_copy_test.py && python3 test/ux_lint_test.py && python3 docs/ux/lint.py && python3 docs/brand/lint.py && node test/installer_test.js && npm run test:audit",
     "test:audit": "for t in test/audit_regressions/*.py; do python3 \"$t\" || exit 1; done"