mustflow 2.116.4 → 2.117.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/package.json +1 -1
  2. package/templates/default/i18n.toml +152 -8
  3. package/templates/default/locales/en/.mustflow/skills/INDEX.md +131 -13
  4. package/templates/default/locales/en/.mustflow/skills/agent-eval-integrity-review/SKILL.md +62 -34
  5. package/templates/default/locales/en/.mustflow/skills/agent-execution-control-review/SKILL.md +102 -31
  6. package/templates/default/locales/en/.mustflow/skills/agent-memory-context-governance-review/SKILL.md +163 -0
  7. package/templates/default/locales/en/.mustflow/skills/agent-planning-recovery-review/SKILL.md +180 -0
  8. package/templates/default/locales/en/.mustflow/skills/agent-release-bundle-rollout-review/SKILL.md +181 -0
  9. package/templates/default/locales/en/.mustflow/skills/agent-runtime-isolation-review/SKILL.md +196 -0
  10. package/templates/default/locales/en/.mustflow/skills/agent-runtime-multi-worker-review/SKILL.md +180 -0
  11. package/templates/default/locales/en/.mustflow/skills/automation-investment-case-review/SKILL.md +173 -0
  12. package/templates/default/locales/en/.mustflow/skills/client-platform-strategy-review/SKILL.md +236 -0
  13. package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/SKILL.md +302 -0
  14. package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/references/connection-fault-injection-resource-lifetime-validation.md +277 -0
  15. package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/references/node-stream-transport-lifecycle-checklist.md +381 -0
  16. package/templates/default/locales/en/.mustflow/skills/credit-ledger-integrity-review/SKILL.md +8 -4
  17. package/templates/default/locales/en/.mustflow/skills/credit-monetization-integrity-review/SKILL.md +283 -0
  18. package/templates/default/locales/en/.mustflow/skills/desktop-commercial-distribution-review/SKILL.md +225 -0
  19. package/templates/default/locales/en/.mustflow/skills/external-prompt-injection-defense/SKILL.md +49 -3
  20. package/templates/default/locales/en/.mustflow/skills/freemium-ad-monetization-review/SKILL.md +196 -0
  21. package/templates/default/locales/en/.mustflow/skills/game-economy-monetization-review/SKILL.md +208 -0
  22. package/templates/default/locales/en/.mustflow/skills/game-liveops-commerce-integrity-review/SKILL.md +237 -0
  23. package/templates/default/locales/en/.mustflow/skills/growth-distribution-integrity-review/SKILL.md +247 -0
  24. package/templates/default/locales/en/.mustflow/skills/idempotency-integrity-review/SKILL.md +20 -2
  25. package/templates/default/locales/en/.mustflow/skills/llm-model-routing-integrity-review/SKILL.md +183 -0
  26. package/templates/default/locales/en/.mustflow/skills/llm-product-monetization-review/SKILL.md +311 -0
  27. package/templates/default/locales/en/.mustflow/skills/llm-token-cost-control-review/SKILL.md +15 -1
  28. package/templates/default/locales/en/.mustflow/skills/localization-market-expansion-review/SKILL.md +224 -0
  29. package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/SKILL.md +94 -2
  30. package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/references/cross-runtime-memory-stream-reproduction-harness.md +289 -0
  31. package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/references/node-memory-resource-backpressure-diagnostics.md +369 -0
  32. package/templates/default/locales/en/.mustflow/skills/multi-agent-work-coordination/SKILL.md +7 -2
  33. package/templates/default/locales/en/.mustflow/skills/pricing-model-integrity-review/SKILL.md +288 -0
  34. package/templates/default/locales/en/.mustflow/skills/product-engagement-retention-review/SKILL.md +234 -0
  35. package/templates/default/locales/en/.mustflow/skills/product-onboarding-activation-review/SKILL.md +269 -0
  36. package/templates/default/locales/en/.mustflow/skills/product-portfolio-integrity-review/SKILL.md +233 -0
  37. package/templates/default/locales/en/.mustflow/skills/prompt-contract-quality-review/SKILL.md +1 -0
  38. package/templates/default/locales/en/.mustflow/skills/referral-incentive-integrity-review/SKILL.md +206 -0
  39. package/templates/default/locales/en/.mustflow/skills/retry-policy-integrity-review/SKILL.md +45 -2
  40. package/templates/default/locales/en/.mustflow/skills/routes.toml +346 -7
  41. package/templates/default/locales/en/.mustflow/skills/service-portfolio-capital-allocation-review/SKILL.md +245 -0
  42. package/templates/default/locales/en/.mustflow/skills/subscription-retention-profit-review/SKILL.md +217 -0
  43. package/templates/default/manifest.toml +97 -1
@@ -2,7 +2,7 @@
2
2
  mustflow_doc: skill.multi-agent-work-coordination
3
3
  locale: en
4
4
  canonical: true
5
- revision: 3
5
+ revision: 4
6
6
  lifecycle: mustflow-owned
7
7
  authority: procedure
8
8
  name: multi-agent-work-coordination
@@ -54,7 +54,12 @@ Do not use this skill when:
54
54
 
55
55
  - one agent is doing a small linear task
56
56
  - the user only asks for a normal code change, review, or test run
57
- - the requested work is a production automation runtime rather than repository coordination
57
+ - the requested work decides whether several agents in a production runtime beat one, or designs
58
+ orchestrator-worker topology, role diversity, correlated-error controls, artifact ownership, and
59
+ central verification; use `agent-runtime-multi-worker-review`
60
+ - the requested work separates durable agent state from queued short-lived workers, ephemeral
61
+ sandboxes, temporary credentials, or a trusted effect broker; use
62
+ `agent-runtime-isolation-review`
58
63
  - the requested work designs an LLM product agent's planner, executor, verifier, tool gates, approval or interrupt state, durable resume behavior, loop budgets, handoffs, guardrails, or trace outcome evaluation; use `agent-execution-control-review`
59
64
  - the repository or host instructions forbid starting workers or long-running processes
60
65
 
@@ -0,0 +1,288 @@
1
+ ---
2
+ mustflow_doc: skill.pricing-model-integrity-review
3
+ locale: en
4
+ canonical: true
5
+ revision: 2
6
+ lifecycle: mustflow-owned
7
+ authority: procedure
8
+ name: pricing-model-integrity-review
9
+ description: Apply this skill when a product changes card-required or cardless trials, paid starter offers, lifetime or founder access, local-currency presentment, regional pricing, subscription versus usage-based or hybrid monetization, price levels, price elasticity, annual prepay, or annual discounts and must optimize eligible-cohort contribution without deceptive renewal, unbounded future-cost rights, geographic arbitrage, cash-revenue confusion, or copied benchmark defaults.
10
+ metadata:
11
+ mustflow_schema: "1"
12
+ mustflow_kind: procedure
13
+ pack_id: mustflow.core
14
+ skill_id: mustflow.core.pricing-model-integrity-review
15
+ command_intents:
16
+ - changes_status
17
+ - changes_diff_summary
18
+ - lint
19
+ - build
20
+ - test_related
21
+ - test
22
+ - docs_validate_fast
23
+ - test_release
24
+ - mustflow_check
25
+ ---
26
+
27
+ # Pricing Model Integrity Review
28
+
29
+ <!-- mustflow-section: purpose -->
30
+ ## Purpose
31
+
32
+ Choose trial, access-right, geographic, monetization-model, price-level, and billing-cadence policy
33
+ from retained user value and long-horizon contribution rather than trial-to-paid conversion, launch
34
+ cash, payer-only ARPU, or annual cash collection. Keep product economics, payment execution,
35
+ entitlements, accounting, tax, fraud, consumer consent, and legal authority connected but separately
36
+ owned.
37
+
38
+ <!-- mustflow-section: use-when -->
39
+ ## Use When
40
+
41
+ - A free trial changes whether a payment method is required, when it is collected, whether renewal is
42
+ automatic, or whether a small paid starter is offered instead.
43
+ - A lifetime deal, founder pass, perpetual tier, early-access package, or prepaid long-duration right
44
+ changes price, included usage, support, upgrades, transfer, or future service obligations.
45
+ - Checkout changes between a single base currency, local-currency presentment, manual currency prices,
46
+ or regional purchasing-power bands.
47
+ - A product chooses or changes subscription, metered usage, credit, seat, outcome, or hybrid base-plus-
48
+ usage pricing and its customer-visible value metric.
49
+ - Monthly prices, packages, entitlements, anchors, elasticity experiments, ARPU, conversion, churn, or
50
+ contribution claims are created, changed, reviewed, or reported.
51
+ - Annual prepay, monthly billing, annual discounts, months-free copy, included allowances, renewal,
52
+ refund, cash-flow, bookings, recognized revenue, or contribution comparisons change.
53
+
54
+ <!-- mustflow-section: do-not-use-when -->
55
+ ## Do Not Use When
56
+
57
+ - The main risk is credit-pack count, bonus versus discount framing, purchased-credit expiry,
58
+ rollover, spend order, or quote-reserve-settle behavior; use
59
+ `credit-monetization-integrity-review`.
60
+ - The main risk is LLM token versus task units, standard versus precision model packaging, managed
61
+ provider cost, BYOK, customer-supplied API keys, or LLM failed-work charging; use
62
+ `llm-product-monetization-review`.
63
+ - The main risk is provider checkout, invoice, recurring-payment state, tax calculation, refund,
64
+ dispute, chargeback, fraud control, webhook, or payment credential storage; use
65
+ `payment-integrity-review`.
66
+ - The main risk is cancellation, pause, downgrade, save offers, or dormant-user win-back; use
67
+ `subscription-retention-profit-review`.
68
+ - The main risk is signup friction, first-owned value, sample results, or onboarding without a trial
69
+ payment or price-model decision; use `product-onboarding-activation-review`.
70
+ - The task requests jurisdiction-specific legal, tax, accounting, consumer-credit, or revenue-
71
+ recognition advice. Use current qualified authority; this skill prepares the evidence packet and
72
+ product contract but does not make that classification.
73
+
74
+ <!-- mustflow-section: required-inputs -->
75
+ ## Required Inputs
76
+
77
+ - Eligible-cohort ledger: eligible visitor or account, assignment before the pricing gate, exposure,
78
+ activation, first owned value, trial start, paid conversion, refund, chargeback, retained paid use,
79
+ exclusions, identity joins, segment, and denominator.
80
+ - Value and cost ledger: user-recognizable value metric, value cadence, marginal service cost,
81
+ payment and platform fees, tax treatment, support, refund, dispute, abuse, capacity, cost variance,
82
+ and active-user usage distribution.
83
+ - Trial and consent ledger: payment-method requirement, collection time, trial entitlement, exact end
84
+ date, renewal price and cadence, consent evidence, reminder, cancellation path, descriptor, receipt,
85
+ refund policy, abuse control, and applicable platform or jurisdiction review.
86
+ - Lifetime-obligation ledger: net proceeds, acquisition cost, included rights, seats, storage,
87
+ compute or credits, support, future modules, excess usage, refunds, taxes, reserve, active-life
88
+ distribution, heavy-user tail, cost inflation, subscription cannibalization, and transfer policy.
89
+ - Currency and region ledger: integration and settlement currency, presentment currency, exchange
90
+ rate and fee, manual price, regional band, price floor, billing entity, payment-country and tax
91
+ evidence, customer type, relocation, travel, grace, reverification, grandfathering, and arbitrage.
92
+ - Model and meter ledger: subscription allowance, usage unit, meter ingestion and reconciliation,
93
+ value-to-cost coupling, usage predictability, spend cap, alert, overage, budget expectation,
94
+ entitlement, and buyer procurement need.
95
+ - Price and package ledger: price version, currency, tax display, entitlement, target segment,
96
+ eligible-user conversion, payer revenue, retained use, churn, refund, support, contribution, and
97
+ migration or grandfathering policy.
98
+ - Annual-prepay ledger: monthly and annual net price, honest equivalent discount, cash timing,
99
+ payment fees, refunds, disputes, servicing cost timing, renewal, survival curve, discount
100
+ cannibalization, cost inflation, capital value, bookings, and recognized-revenue boundary.
101
+ - Experiment ledger: decision under test, control and variants, preassignment, packaging parity,
102
+ power and horizon, interference, repeated looks, guardrails, promotion rule, and rollback.
103
+
104
+ <!-- mustflow-section: preconditions -->
105
+ ## Preconditions
106
+
107
+ - Separate local-currency presentment from a regional price reduction. Currency conversion changes
108
+ how a price is shown and paid; purchasing-power pricing changes the economic price.
109
+ - Separate cash collected, bookings, recognized revenue, and contribution. None can substitute for
110
+ another merely because payment occurred up front.
111
+ - Assign before card collection, trial entry, package exposure, or price visibility when measuring
112
+ full-funnel impact. Keep people who abandon the gate in the intent-to-treat denominator.
113
+ - Refresh current platform, payment-network, provider, jurisdiction, tax, accounting, cancellation,
114
+ reminder, and refund authority before changing negative-option renewal, stored credentials,
115
+ regional eligibility, perpetual rights, or annual prepay.
116
+ - Treat vendor benchmarks, copied price points, fixed country multipliers, universal annual discount
117
+ rates, and another product's lifetime assumptions as priors or experiment candidates, not defaults.
118
+ - Keep command execution under `.mustflow/config/commands.toml`; this skill does not authorize live
119
+ prices, plans, entitlements, payments, refunds, messages, experiments, migrations, or filings.
120
+
121
+ <!-- mustflow-section: allowed-edits -->
122
+ ## Allowed Edits
123
+
124
+ - Add or refine pricing policy, trial consent and reminder contracts, lifetime-right boundaries,
125
+ regional eligibility, local-currency display, monetization metrics, metering, price experiments,
126
+ annual-prepay economics, event schemas, fixtures, tests, docs, route metadata, and synchronized
127
+ templates.
128
+ - Add explicit handoffs to payment, credit, entitlement, fraud, accounting, tax, privacy,
129
+ consumer-protection, or platform owners when their evidence is required.
130
+ - Remove trial-to-paid-only optimization, unlimited variable-cost lifetime promises, IP-only regional
131
+ eligibility, hidden renewal, fake price localization, payer-only ARPU claims, or annual-cash claims
132
+ that omit future delivery and refund obligations.
133
+ - Do not retroactively reduce paid rights, convert a cardless trial into recurring billing without
134
+ fresh consent, misstate discount equivalence, or spend prepaid cash as if no future service remains.
135
+
136
+ <!-- mustflow-section: procedure -->
137
+ ## Procedure
138
+
139
+ 1. Split the work into six decisions: trial credential policy, lifetime or long-duration access,
140
+ currency and regional pricing, monetization model and value metric, price level and packaging, and
141
+ billing cadence or annual discount. Do not let one conversion metric silently decide all six.
142
+ 2. Define the headline outcome per eligible assigned user over declared short and long horizons.
143
+ Prefer incremental contribution supported by activation, paid conversion, useful paid output,
144
+ retained paid use, refund, dispute, support, fraud, and variable cost. Keep trial-to-paid, payer
145
+ ARPPU, bookings, and cash collected as diagnostics.
146
+ 3. Evaluate cardless, card-required, and small paid-starter candidates from time-to-value, trial
147
+ abuse, marginal cost, buyer intent, trust, and ownership boundaries. There is no universal winner.
148
+ Collecting payment at a real cost or durable-ownership boundary is a candidate, not a rule.
149
+ 4. Measure the entire trial funnel. A card-required trial can raise conversion among starters while
150
+ losing eligible visitors before trial. Compare eligible-to-value, eligible-to-paid, refunds,
151
+ chargebacks, cancellation, support, retained paid use, and contribution, not starter-to-paid alone.
152
+ 5. Make recurring conversion explicit. Before trial start, state the entitlement, exact trial end,
153
+ renewal amount and cadence, payment method, cancellation route, and refund rule. Preserve consent
154
+ evidence, send required reminders, use a recognizable descriptor and receipt, and keep online
155
+ cancellation at least as easy as the applicable authority requires.
156
+ 6. Separate product friction from payment control. Use identity, rate, device, workload, or risk
157
+ controls proportionate to abuse without forcing every honest visitor through a stored credential.
158
+ Route credential storage, risk scoring, authentication, disputes, and provider state through
159
+ `payment-integrity-review`.
160
+ 7. Model a lifetime offer as a current cash receipt plus a long-lived delivery obligation. Define
161
+ exactly what is perpetual: product version, core features, account access, support, seats, storage,
162
+ usage allowance, updates, future modules, and transfer. Do not let the word lifetime define these
163
+ rights implicitly.
164
+ 8. Calculate cash break-even and economic break-even separately. Deduct fees, taxes, refunds,
165
+ acquisition, support, expected service cost across active life, capacity, reserve, and the
166
+ contribution of subscriptions displaced by the offer. Declare the horizon and uncertainty.
167
+ 9. Stress the lifetime model against heavy-user share, usage-tail size, longer survival, higher
168
+ external cost, support concentration, concurrent use, resale, and high-cost future features.
169
+ Average usage alone is not proof that an unlimited promise is affordable.
170
+ 10. Bound future-cost rights. Prefer declared seats, storage, compute, credits, fair-use enforcement,
171
+ or separately paid excess usage where marginal cost persists. Preserve paid core access while
172
+ making optional future modules and variable-cost expansion explicit before purchase.
173
+ 11. Reserve for remaining delivery. Do not treat all launch cash as spendable profit. Record the
174
+ reserve method, usage and survival assumptions, release conditions, and qualified accounting
175
+ review; update them when cost or active-life evidence changes.
176
+ 12. Localize currency independently of price. Show exchange rate, conversion or platform fee,
177
+ settlement behavior, refund behavior, supported recurring methods, and rounding. Compare customer
178
+ total and payment completion; do not call a currency conversion a purchasing-power discount.
179
+ 13. Use purchasing-power data only as a prior. Derive a regional price floor from marginal service
180
+ cost, payment and platform fees, taxes where borne, support, refund and fraud cost, and required
181
+ contribution. Validate willingness to pay and retained contribution with product cohorts.
182
+ 14. Start regional pricing with the fewest materially distinct bands the evidence supports. A fixed
183
+ three-band, four-band, or copied country ratio is not a law. Keep manual overrides and country
184
+ additions versioned and review small or volatile markets before merging them into a band.
185
+ 15. Determine regional eligibility from the lawful billing relationship and multiple consistent
186
+ signals such as billing entity, payment country, tax evidence, account history, and customer
187
+ type. Do not use IP alone. Define relocation, travel, VPN, grace, reverification, grandfathering,
188
+ business procurement, resale, and appeal behavior.
189
+ 16. Separate affordability from fraud. A regional discount is not a fraud control. Route risk-based
190
+ authentication, velocity, card-country mismatch, account takeover, disputes, and provider rules
191
+ through payment or fraud owners while measuring false declines and legitimate travel.
192
+ 17. Select the monetization model from value cadence, marginal-cost coupling, usage variance,
193
+ predictability, budget needs, buyer procurement, and metering reliability. Subscription suits
194
+ recurring value with predictable included cost; usage pricing suits episodic value that scales
195
+ with consumption; hybrid suits a recurring base plus material variable-cost work. These are
196
+ hypotheses to validate, not universal thresholds.
197
+ 18. Charge on a user-recognizable value unit where possible. Internal tokens, model calls, database
198
+ rows, or compute seconds may be suitable for developer infrastructure but often produce confusing
199
+ consumer bills. Map the meter to useful output and disclose estimation, aggregation, latency,
200
+ correction, and failed-work treatment.
201
+ 19. For hybrid pricing, define the base entitlement, included allowance, overage price, spend cap,
202
+ threshold alerts, hard-stop or grace behavior, delayed meter reconciliation, refunds, and plan
203
+ changes. Prevent surprise bills and preserve reconstructable usage.
204
+ 20. Test price without changing hidden mechanisms. Preassign eligible users and keep package,
205
+ entitlement, trial, renewal, and presentation equal unless the experiment explicitly tests a
206
+ bundle. Use narrow candidates around current evidence rather than copying familiar price endings.
207
+ 21. Distinguish payer ARPPU from eligible-user ARPU and contribution. Calculate price elasticity,
208
+ eligible conversion, retained paid use, churn, refunds, disputes, support, variable cost, and
209
+ contribution by declared segment, currency, tax, and platform fee. A higher payer average can
210
+ hide a smaller and worse eligible cohort.
211
+ 22. Preserve price-version rights. Define grandfathering, migration notice, consent, package
212
+ changes, downgrade paths, and treatment of existing annual or lifetime customers. Do not use a
213
+ low entry price as bait for an undisclosed or retroactive entitlement reduction.
214
+ 23. Compare annual and monthly economics under the same survival and service assumptions. Annual
215
+ net contribution includes discounted price, payment fees, refunds, disputes, taxes where borne,
216
+ cost timing, support, renewal, cost inflation, and cannibalized full-price monthly contribution.
217
+ Monthly contribution includes its payment cadence and survival curve.
218
+ 24. Keep annual cash separate from earned economics. Record cash receipt and liquidity value, but
219
+ also the remaining service obligation, refund exposure, recognized-revenue schedule determined
220
+ by qualified authority, and future variable cost. Up-front cash does not prove long-term profit.
221
+ 25. Derive the annual discount from incremental contribution, liquidity need, renewal, and customer
222
+ commitment value. A fixed ten, twenty, thirty, or forty percent is an experiment set, not a
223
+ default. Make months-free copy mathematically equivalent to the actual monthly and annual totals.
224
+ 26. Decide whether annual usage rights arrive up front or by period from abuse, capacity, cost, and
225
+ user expectation. State rollover, cancellation, downgrade, refund, and expiry rights explicitly
226
+ and route credit balances through `credit-monetization-integrity-review`.
227
+ 27. Sequence experiments when traffic is limited. Resolve material model and package ambiguity
228
+ before fine price tuning; then isolate trial gate, price level, annual discount, and geography as
229
+ separate mechanisms. Do not ship one opaque variant that changes all of them.
230
+ 28. Promote only a reversible, versioned policy whose eligible-cohort contribution improves without
231
+ violating consent, transparent pricing, paid rights, affordability, fraud fairness, payment
232
+ integrity, accounting boundaries, or current platform and legal authority.
233
+
234
+ <!-- mustflow-section: postconditions -->
235
+ ## Postconditions
236
+
237
+ - Trial policy is measured from the pre-gate eligible cohort and includes activation, payment,
238
+ refund, chargeback, cancellation, retained-use, contribution, consent, and reminder evidence.
239
+ - Lifetime rights and exclusions are explicit, heavy-tail and cannibalization stress tests exist,
240
+ future variable cost is bounded, and remaining delivery has a declared reserve assumption.
241
+ - Local-currency presentment and regional price reduction remain separate; regional eligibility is
242
+ versioned, multi-signal, appealable, and not treated as fraud control.
243
+ - Subscription, usage, or hybrid pricing follows value and cost evidence with a customer-visible
244
+ meter, allowance, overage, alert, spend-cap, and failure policy where applicable.
245
+ - Price experiments retain preassigned abandoners and distinguish payer ARPPU, eligible-user ARPU,
246
+ retained contribution, refunds, churn, support, and segment effects.
247
+ - Annual cash, bookings, recognized revenue, remaining service obligation, survival, renewal, cost,
248
+ and contribution remain distinguishable.
249
+
250
+ <!-- mustflow-section: verification -->
251
+ ## Verification
252
+
253
+ Use configured oneshot command intents when available: `changes_status`, `changes_diff_summary`,
254
+ `lint`, `build`, `test_related`, `test`, `docs_validate_fast`, `test_release`, and `mustflow_check`.
255
+ Do not infer raw analytics, billing, payment-provider, entitlement, warehouse, accounting, pricing,
256
+ experiment, deployment, or production commands.
257
+
258
+ <!-- mustflow-section: failure-handling -->
259
+ ## Failure Handling
260
+
261
+ - If assignment begins after card entry, trial start, paywall view, or package selection, label the
262
+ result exposure-conditioned and do not generalize it to eligible visitors.
263
+ - If renewal consent, reminder, cancellation, refund, or stored-credential authority is unresolved,
264
+ do not start recurring collection; preserve the lower-risk existing behavior and escalate.
265
+ - If lifetime heavy-tail cost, active life, cannibalization, or rights are unknown, bound usage or
266
+ keep the offer experimental; do not sell unlimited future variable cost from an average-case model.
267
+ - If region or customer type cannot be established fairly, use the ordinary lawful price and an
268
+ appeal or reverification path rather than an IP-only denial or silent price switch.
269
+ - If the meter cannot be reconciled or explained to the customer, do not make it the billing source
270
+ of truth. Repair or choose a coarser value unit first.
271
+ - If a price or annual arm wins cash or payer ARPPU but loses eligible-cohort contribution, retained
272
+ use, refund, dispute, support, or trust guardrails, reject or narrow it.
273
+ - If annual recognized-revenue or tax treatment lacks qualified authority, report cash and product
274
+ economics separately and leave accounting classification unresolved.
275
+
276
+ <!-- mustflow-section: output-format -->
277
+ ## Output Format
278
+
279
+ - Eligible cohort, assignment, exposure, denominator, segments, and horizons
280
+ - Trial credential, consent, reminder, renewal, cancellation, refund, abuse, and contribution result
281
+ - Lifetime rights, bounded usage, heavy-tail stress, cannibalization, reserve, and break-even result
282
+ - Local currency, regional band, price floor, eligibility, relocation, appeal, and fraud handoff
283
+ - Subscription, usage, or hybrid model; value metric; meter; allowance; overage; cap; and alerts
284
+ - Price candidates, elasticity, package parity, ARPPU, eligible-user ARPU, churn, and contribution
285
+ - Annual discount, survival, renewal, cash, bookings, recognized-revenue boundary, and obligation
286
+ - Files changed
287
+ - Command intents run and skipped checks
288
+ - Remaining pricing-model risk
@@ -0,0 +1,234 @@
1
+ ---
2
+ mustflow_doc: skill.product-engagement-retention-review
3
+ locale: en
4
+ canonical: true
5
+ revision: 1
6
+ lifecycle: mustflow-owned
7
+ authority: procedure
8
+ name: product-engagement-retention-review
9
+ description: Apply this skill when a product adds or changes weekly value reports, usage summaries, time-saved claims, artifact recaps, streaks, attendance rewards, grace or recovery mechanics, abandoned-work reminders, completion nudges, notification timing, or engagement experiments and must distinguish durable user value from activity theater, reward farming, natural return, and notification harm.
10
+ metadata:
11
+ mustflow_schema: "1"
12
+ mustflow_kind: procedure
13
+ pack_id: mustflow.core
14
+ skill_id: mustflow.core.product-engagement-retention-review
15
+ command_intents:
16
+ - changes_status
17
+ - changes_diff_summary
18
+ - lint
19
+ - build
20
+ - test_related
21
+ - test
22
+ - docs_validate_fast
23
+ - test_release
24
+ - mustflow_check
25
+ ---
26
+
27
+ # Product Engagement Retention Review
28
+
29
+ <!-- mustflow-section: purpose -->
30
+ ## Purpose
31
+
32
+ Improve durable post-activation value without mistaking message opens, app launches, attendance,
33
+ streak preservation, reward claims, or natural return for retention. Keep value reports, streaks,
34
+ rewards, and abandoned-work reminders as separate mechanisms with separate eligibility, causal
35
+ evidence, quality guardrails, and stop conditions.
36
+
37
+ <!-- mustflow-section: use-when -->
38
+ ## Use When
39
+
40
+ - A product sends a weekly or periodic report of completed work, generated artifacts, usage, saved
41
+ time, progress, outcomes, or value delivered.
42
+ - A product introduces attendance, consecutive-use records, streak freezes, grace days, recovery,
43
+ wagers, badges, credits, points, or other rewards for recurring behavior.
44
+ - A user abandons a draft, setup, import, generation, analysis, checkout-like product task, or other
45
+ resumable work and the product considers a reminder after a delay.
46
+ - Notification timing, send-versus-silence, reminder count, re-entry quality, long-term retained use,
47
+ or unsubscribe and block guardrails are created, changed, reviewed, or reported.
48
+
49
+ <!-- mustflow-section: do-not-use-when -->
50
+ ## Do Not Use When
51
+
52
+ - The main risk is signup, first-run activation, pre-account experience, samples, or tutorials; use
53
+ `product-onboarding-activation-review`.
54
+ - The main risk is cancellation, pause, downgrade, retention offers, dormant-subscriber win-back, or
55
+ contribution profit; use `subscription-retention-profit-review`.
56
+ - The task only changes notification consent, endpoint registration, provider delivery, retries,
57
+ deduplication, quiet hours, unsubscribe transport, or delivery receipts; use
58
+ `notification-delivery-integrity-review`.
59
+ - The task only changes general gamification visuals without a recurring engagement or retention
60
+ claim; use the matching product or UI skill.
61
+
62
+ <!-- mustflow-section: required-inputs -->
63
+ ## Required Inputs
64
+
65
+ - Eligible-cohort ledger: eligibility moment, assignment unit, randomization, exposure, holdout,
66
+ exclusions, identity joins, locale and time zone, expected product cadence, and denominator.
67
+ - Value-report ledger: completed or consumed artifacts, meaningful outcome evidence, report cadence,
68
+ value-estimation method, zero-activity handling, deep-link target, privacy, access control, expiry,
69
+ and suppression rules.
70
+ - Streak and reward ledger: qualifying value event, cadence, late-event policy, time-zone boundary,
71
+ grace or recovery, reward type and cost, abuse controls, accessibility, pause or vacation behavior,
72
+ and withdrawal plan.
73
+ - Abandoned-work ledger: task identity, saved state, last meaningful progress, completion and natural
74
+ return events, estimated value, expiry, resumability, failure state, sensitivity, and cancellation
75
+ of scheduled reminders.
76
+ - Contact ledger: channel, consent, purpose, frequency cap, quiet time, local-time policy,
77
+ unsubscribe or block state, send request, provider acceptance, delivery evidence, and suppression.
78
+ - Outcome ledger: task completion, useful artifact consumption, repeated value, retained use, paid
79
+ outcome, refunds or cancellation, shallow activity, re-abandonment, support burden, reward cost,
80
+ unsubscribe, block, uninstall, complaint, and accessibility impact.
81
+ - Experiment ledger: control, single-mechanism and combined variants, observation windows, minimum
82
+ detectable effect, repeated-testing policy, interference risk, segment policy, and promotion rule.
83
+
84
+ <!-- mustflow-section: preconditions -->
85
+ ## Preconditions
86
+
87
+ - Define the product-value event and expected natural cadence before creating a report, streak, or
88
+ reminder. Daily use is not the default for products whose value occurs weekly, monthly, or only
89
+ when a real task exists.
90
+ - Keep a no-message, no-streak, or no-reward holdout capable of measuring natural return and durable
91
+ behavior. Observational differences between recipients, streak holders, and other users do not
92
+ establish incremental effect.
93
+ - Treat external case studies, vendor benchmarks, and another product's timing or effect size as
94
+ hypotheses, not repository defaults or forecasts.
95
+ - Verify consent, privacy, delivery, and security boundaries before exposing task names, generated
96
+ content, business metrics, or deep links outside the product.
97
+ - Keep command execution under `.mustflow/config/commands.toml`; this skill does not authorize live
98
+ messaging, analytics queries, production flags, rewards, billing changes, or data collection.
99
+
100
+ <!-- mustflow-section: allowed-edits -->
101
+ ## Allowed Edits
102
+
103
+ - Add or refine report composition, value-evidence rules, zero-activity suppression, streak
104
+ qualification, grace and recovery, reward eligibility and withdrawal, abandoned-task state,
105
+ reminder scheduling and cancellation, experiment assignment, metrics, guardrails, fixtures,
106
+ tests, docs, route metadata, and synchronized templates.
107
+ - Remove raw activity counts, unverifiable time-saved claims, attendance-only streak credit, or
108
+ reminder waves that do not change a meaningful user outcome.
109
+ - Add deep links only when authorization is rechecked at open time and expired, deleted, completed,
110
+ or transferred work has a safe fallback.
111
+ - Do not fabricate saved-time value, expose sensitive content in notifications, bypass consent or
112
+ quiet-time rules, make a reward necessary to recover already-owned data, or hide opt-out controls.
113
+
114
+ <!-- mustflow-section: procedure -->
115
+ ## Procedure
116
+
117
+ 1. Separate the mechanisms before designing a bundle. A value report proves already received value,
118
+ a streak changes future behavior through continuity and loss aversion, a reward changes behavior
119
+ through an external payoff, and an abandoned-work reminder restores a specific interrupted
120
+ intent. Do not use one mechanism's metric as proof for another.
121
+ 2. Define one meaningful downstream outcome for each mechanism. Prefer completed or consumed useful
122
+ artifacts, resumed-and-finished work, repeated core value, retained use, or contribution. Treat
123
+ report opens, notification clicks, app launches, attendance, streak extension, and reward claims
124
+ as leading events only.
125
+ 3. Fix assignment and holdout before exposure. Measure outcomes per eligible assigned user or task,
126
+ including non-openers, naturally returning users, failed deliveries, and users who opt out after
127
+ assignment. Keep assignment, send, provider acceptance, delivery, open, resume, and completion
128
+ as distinct events.
129
+ 4. Build value reports from evidence the user would recognize. Prefer named completed work, results
130
+ consumed or shared, progress toward a declared goal, and one relevant next action.
131
+ Raw session, click, token, character, or generation counts are not value by themselves.
132
+ 5. Estimate saved time only from a declared comparator and method. State whether the estimate comes
133
+ from user input, a validated task baseline, or a conservative model; preserve uncertainty and
134
+ avoid summing overlapping savings. Omit the claim when the method is not defensible.
135
+ 6. Handle zero or low activity deliberately. A periodic report that says nothing happened can remind
136
+ a subscriber to cancel or disclose inactivity to the wrong recipient. Segment, reduce cadence,
137
+ change the content to a genuinely useful recovery path, or stay silent; do not pad it with vanity
138
+ numbers.
139
+ 7. Keep report deep links narrow and current. Link to the named result or next task, reauthorize on
140
+ open, handle deleted or transferred artifacts, and avoid a generic dashboard when a safe direct
141
+ destination exists.
142
+ 8. Define streak credit from completed value, not presence. Choose a qualifying event whose quality
143
+ cannot be satisfied by opening the app, tapping attendance, generating junk, or repeating a
144
+ trivial action. Preserve domain-specific minimum quality and anti-abuse checks.
145
+ 9. Align streak cadence with real value. Use daily continuity only for legitimately daily behavior;
146
+ otherwise use scheduled sessions, weekly goals, rolling windows, or milestone progress. Specify
147
+ time zone, travel, late synchronization, offline events, duplicate events, and period closure.
148
+ 10. Provide humane continuity. Grace, pause, recovery, and outage repair can preserve motivation
149
+ without pretending work occurred. Define limits and auditability, avoid permanent hostage states,
150
+ and distinguish forgiven continuity from completed value in analytics.
151
+ 11. Separate streak from reward experimentally. Prefer control, streak-only, reward-only, and both
152
+ when sample and cost support a factorial design. Track reward expense, shallow activity, fraud,
153
+ and displaced intrinsic use rather than crediting the combined bundle to streak psychology.
154
+ 12. Test persistence after reducing or withdrawing the reward. A temporary rise that disappears when
155
+ payment stops is purchased activity, not a durable habit. Preserve a fair disclosed transition
156
+ and do not revoke rewards already earned under the stated contract.
157
+ 13. Create abandoned-work eligibility from a specific resumable state. Require evidence of intent and
158
+ unfinished value, a safe saved checkpoint, a still-valid owner, and a useful return target. Do
159
+ not infer abandonment from a closed tab alone when completion may occur elsewhere.
160
+ 14. Measure natural return before choosing timing. A short delay can claim users who would have
161
+ returned unaided; a long delay can miss the task's value window. Model or observe the baseline
162
+ return hazard by task type, user intent, local context, sensitivity, and expiry before selecting
163
+ candidate delays.
164
+ 15. Compare silence with bounded single-send timing arms first. Test candidate delays such as near
165
+ term, next suitable local context, or later saved-work recovery only when the task remains useful.
166
+ Do not copy a universal ten-minute, twenty-four-hour, or three-day sequence from another product.
167
+ 16. Cancel scheduled reminders on natural return, completion, deletion, ownership transfer, task
168
+ invalidation, consent withdrawal, channel suppression, or a newer task generation. Make schedule
169
+ creation and cancellation idempotent so retries cannot produce a reminder storm.
170
+ 17. Add a later reminder only after one-send evidence shows incremental completed value beyond the
171
+ earlier send. Cap frequency across campaigns, avoid stacking report, streak, marketing, and task
172
+ reminders, and preserve channel-specific opt-out and quiet-time behavior.
173
+ 18. Judge return quality, not just return. Track completion after resume, time to useful result,
174
+ repeated value, re-abandonment, error, support, reward-only behavior, unsubscribe, block, uninstall,
175
+ complaint, and downstream paid or retained outcomes over an appropriate horizon.
176
+ 19. Predeclare segment and interference policy. Account for power users, low-frequency workflows,
177
+ new versus established users, locale and time zone, shared accounts, team notifications, and
178
+ network effects. Do not discover a winning segment after the fact and ship it as established.
179
+ 20. Promote the narrowest mechanism that improves meaningful outcome per eligible unit without
180
+ guardrail harm. Keep a kill switch, suppress stale eligibility, and retain the holdout long enough
181
+ to detect novelty, fatigue, reward withdrawal, and notification saturation.
182
+
183
+ <!-- mustflow-section: postconditions -->
184
+ ## Postconditions
185
+
186
+ - Value reports contain defensible completed value, suppress or intentionally handle zero activity,
187
+ and omit unsupported time-saved claims.
188
+ - Streak credit follows meaningful product cadence and completed value, while grace, recovery, and
189
+ reward state remain analytically distinct.
190
+ - Reward impact is separated from streak impact and checked after reward reduction or withdrawal.
191
+ - Abandoned-work reminders target a specific live resumable task, use context-tested timing, and are
192
+ canceled on natural return, completion, invalidation, or consent loss.
193
+ - Causal decisions use eligible-unit holdouts and meaningful downstream outcomes rather than opens,
194
+ clicks, attendance, streak counts, or reward claims.
195
+ - Promotion evidence includes opt-out, block, uninstall, re-abandonment, quality, cost, and fatigue
196
+ guardrails, or the result remains explicitly preliminary.
197
+
198
+ <!-- mustflow-section: verification -->
199
+ ## Verification
200
+
201
+ Use configured oneshot command intents when available: `changes_status`, `changes_diff_summary`,
202
+ `lint`, `build`, `test_related`, `test`, `docs_validate_fast`, `test_release`, and `mustflow_check`.
203
+ Do not infer raw analytics, notification-provider, experimentation, browser, deployment, or
204
+ production commands.
205
+
206
+ <!-- mustflow-section: failure-handling -->
207
+ ## Failure Handling
208
+
209
+ - If completed or consumed value cannot be derived, label the report as an activity summary and do
210
+ not claim that it proves user value or retention.
211
+ - If saved-time estimation has no defensible comparator, omit the number instead of inventing one.
212
+ - If streak eligibility can be farmed without core value, redesign the qualifying event before
213
+ testing retention.
214
+ - If reward removal eliminates the behavior, report purchased activity and its cost rather than a
215
+ durable habit.
216
+ - If natural return, task completion, or schedule cancellation cannot be observed reliably, do not
217
+ credit reminder timing causally and reduce message frequency.
218
+ - If reminder return rises while completion quality falls or opt-out, block, uninstall, complaint,
219
+ or re-abandonment rises materially, reject or narrow the treatment.
220
+ - If consent or authorization is ambiguous, suppress the external message and route transport or
221
+ privacy repair through the matching skill.
222
+
223
+ <!-- mustflow-section: output-format -->
224
+ ## Output Format
225
+
226
+ - Eligible cohort or task, assignment, holdout, exposure, and denominator
227
+ - Value report evidence, saved-time method, zero-activity policy, and deep-link boundary
228
+ - Streak qualifying event, cadence, grace, recovery, and anti-abuse contract
229
+ - Reward isolation, cost, withdrawal, and persistence evidence
230
+ - Abandoned-work state, natural-return baseline, timing arms, and cancellation contract
231
+ - Meaningful outcome, return quality, fatigue, and contact guardrails
232
+ - Files changed
233
+ - Command intents run and skipped checks
234
+ - Remaining engagement-retention risk