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.
- package/package.json +1 -1
- package/templates/default/i18n.toml +152 -8
- package/templates/default/locales/en/.mustflow/skills/INDEX.md +131 -13
- package/templates/default/locales/en/.mustflow/skills/agent-eval-integrity-review/SKILL.md +62 -34
- package/templates/default/locales/en/.mustflow/skills/agent-execution-control-review/SKILL.md +102 -31
- package/templates/default/locales/en/.mustflow/skills/agent-memory-context-governance-review/SKILL.md +163 -0
- package/templates/default/locales/en/.mustflow/skills/agent-planning-recovery-review/SKILL.md +180 -0
- package/templates/default/locales/en/.mustflow/skills/agent-release-bundle-rollout-review/SKILL.md +181 -0
- package/templates/default/locales/en/.mustflow/skills/agent-runtime-isolation-review/SKILL.md +196 -0
- package/templates/default/locales/en/.mustflow/skills/agent-runtime-multi-worker-review/SKILL.md +180 -0
- package/templates/default/locales/en/.mustflow/skills/automation-investment-case-review/SKILL.md +173 -0
- package/templates/default/locales/en/.mustflow/skills/client-platform-strategy-review/SKILL.md +236 -0
- package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/SKILL.md +302 -0
- package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/references/connection-fault-injection-resource-lifetime-validation.md +277 -0
- package/templates/default/locales/en/.mustflow/skills/connection-lifecycle-integrity-review/references/node-stream-transport-lifecycle-checklist.md +381 -0
- package/templates/default/locales/en/.mustflow/skills/credit-ledger-integrity-review/SKILL.md +8 -4
- package/templates/default/locales/en/.mustflow/skills/credit-monetization-integrity-review/SKILL.md +283 -0
- package/templates/default/locales/en/.mustflow/skills/desktop-commercial-distribution-review/SKILL.md +225 -0
- package/templates/default/locales/en/.mustflow/skills/external-prompt-injection-defense/SKILL.md +49 -3
- package/templates/default/locales/en/.mustflow/skills/freemium-ad-monetization-review/SKILL.md +196 -0
- package/templates/default/locales/en/.mustflow/skills/game-economy-monetization-review/SKILL.md +208 -0
- package/templates/default/locales/en/.mustflow/skills/game-liveops-commerce-integrity-review/SKILL.md +237 -0
- package/templates/default/locales/en/.mustflow/skills/growth-distribution-integrity-review/SKILL.md +247 -0
- package/templates/default/locales/en/.mustflow/skills/idempotency-integrity-review/SKILL.md +20 -2
- package/templates/default/locales/en/.mustflow/skills/llm-model-routing-integrity-review/SKILL.md +183 -0
- package/templates/default/locales/en/.mustflow/skills/llm-product-monetization-review/SKILL.md +311 -0
- package/templates/default/locales/en/.mustflow/skills/llm-token-cost-control-review/SKILL.md +15 -1
- package/templates/default/locales/en/.mustflow/skills/localization-market-expansion-review/SKILL.md +224 -0
- package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/SKILL.md +94 -2
- package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/references/cross-runtime-memory-stream-reproduction-harness.md +289 -0
- package/templates/default/locales/en/.mustflow/skills/memory-lifetime-review/references/node-memory-resource-backpressure-diagnostics.md +369 -0
- package/templates/default/locales/en/.mustflow/skills/multi-agent-work-coordination/SKILL.md +7 -2
- package/templates/default/locales/en/.mustflow/skills/pricing-model-integrity-review/SKILL.md +288 -0
- package/templates/default/locales/en/.mustflow/skills/product-engagement-retention-review/SKILL.md +234 -0
- package/templates/default/locales/en/.mustflow/skills/product-onboarding-activation-review/SKILL.md +269 -0
- package/templates/default/locales/en/.mustflow/skills/product-portfolio-integrity-review/SKILL.md +233 -0
- package/templates/default/locales/en/.mustflow/skills/prompt-contract-quality-review/SKILL.md +1 -0
- package/templates/default/locales/en/.mustflow/skills/referral-incentive-integrity-review/SKILL.md +206 -0
- package/templates/default/locales/en/.mustflow/skills/retry-policy-integrity-review/SKILL.md +45 -2
- package/templates/default/locales/en/.mustflow/skills/routes.toml +346 -7
- package/templates/default/locales/en/.mustflow/skills/service-portfolio-capital-allocation-review/SKILL.md +245 -0
- package/templates/default/locales/en/.mustflow/skills/subscription-retention-profit-review/SKILL.md +217 -0
- package/templates/default/manifest.toml +97 -1
package/templates/default/locales/en/.mustflow/skills/product-onboarding-activation-review/SKILL.md
ADDED
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
---
|
|
2
|
+
mustflow_doc: skill.product-onboarding-activation-review
|
|
3
|
+
locale: en
|
|
4
|
+
canonical: true
|
|
5
|
+
revision: 2
|
|
6
|
+
lifecycle: mustflow-owned
|
|
7
|
+
authority: procedure
|
|
8
|
+
name: product-onboarding-activation-review
|
|
9
|
+
description: Apply this skill when a product changes pre-account core-value experiences, signup checkpoints, guest-to-account transfer, signup or first-run questions, authentication choices, personalization, samples, empty states, tutorials, contextual help, progressive disclosure, activation definitions, time-to-value, retained use, paid conversion, or onboarding experiments and must balance friction against meaningful user-owned outcomes without survivor-biased metrics.
|
|
10
|
+
metadata:
|
|
11
|
+
mustflow_schema: "1"
|
|
12
|
+
mustflow_kind: procedure
|
|
13
|
+
pack_id: mustflow.core
|
|
14
|
+
skill_id: mustflow.core.product-onboarding-activation-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 Onboarding Activation Review
|
|
28
|
+
|
|
29
|
+
<!-- mustflow-section: purpose -->
|
|
30
|
+
## Purpose
|
|
31
|
+
|
|
32
|
+
Move an eligible visitor or newly assigned user to one meaningful result they own while accounting
|
|
33
|
+
for every user lost to account creation, authentication, questions, setup, samples, tutorials, or
|
|
34
|
+
choice overload. Prevent signup rate, onboarding completion, tour clicks, sample views, or template
|
|
35
|
+
opens from masquerading as activation or paid conversion.
|
|
36
|
+
|
|
37
|
+
<!-- mustflow-section: use-when -->
|
|
38
|
+
## Use When
|
|
39
|
+
|
|
40
|
+
- A product chooses between account-first and a bounded pre-account or guest core-value experience,
|
|
41
|
+
or moves the account checkpoint to save, export, share, collaboration, payment, or sensitive work.
|
|
42
|
+
- Anonymous work, sample state, generated results, drafts, or attribution must transfer into a
|
|
43
|
+
durable account without loss, duplication, or ownership confusion.
|
|
44
|
+
- Signup or first-run flow adds, removes, or changes authentication methods, intent, role,
|
|
45
|
+
skill-level, company, use-case, goal, preferred-output, or other personalization questions.
|
|
46
|
+
- A product shows sample data, an example result, template, demo workspace, prefilled project,
|
|
47
|
+
generated example, or interactive preview before a user enters their own data.
|
|
48
|
+
- The first-use path changes between no onboarding, a short task path, a detailed tutorial,
|
|
49
|
+
contextual help, several feature choices, or one primary action.
|
|
50
|
+
- Activation, time-to-value, first feature execution, retained use, paid conversion, or onboarding
|
|
51
|
+
experiment definitions are created, changed, reviewed, or reported.
|
|
52
|
+
|
|
53
|
+
<!-- mustflow-section: do-not-use-when -->
|
|
54
|
+
## Do Not Use When
|
|
55
|
+
|
|
56
|
+
- The main risk is authentication assurance, credential storage, session security, account recovery
|
|
57
|
+
security, identity-provider protocol correctness, permission, or authorization; use
|
|
58
|
+
`auth-permission-change` and the matching security skill.
|
|
59
|
+
- The main risk is general page friction, accessibility, form usability, navigation, or task
|
|
60
|
+
completion outside the new-user value path; use `website-task-friction-review`.
|
|
61
|
+
- The main risk is weekly value reports, streaks, attendance rewards, abandoned-work reminders, or
|
|
62
|
+
post-activation engagement nudges; use `product-engagement-retention-review`.
|
|
63
|
+
- The main risk is subscription cancellation, win-back, pause, downgrade, retention offers, or
|
|
64
|
+
post-churn profit; use `subscription-retention-profit-review`.
|
|
65
|
+
- The task only changes marketing-page copy or lead capture and does not claim product activation,
|
|
66
|
+
retained use, or paid conversion.
|
|
67
|
+
- The task only implements analytics transport, event delivery, consent, or privacy controls without
|
|
68
|
+
changing the activation contract; use the matching analytics, privacy, or data-boundary skill.
|
|
69
|
+
|
|
70
|
+
<!-- mustflow-section: required-inputs -->
|
|
71
|
+
## Required Inputs
|
|
72
|
+
|
|
73
|
+
- Eligible-cohort ledger: visitor or user eligibility moment, assignment unit, randomization moment,
|
|
74
|
+
exposure rules, exclusions, anonymous and account identity joins, bot or internal traffic policy,
|
|
75
|
+
and denominator.
|
|
76
|
+
- Pre-account experience ledger: available core task, input and output sensitivity, compute or abuse
|
|
77
|
+
cost, persistence, export or sharing, irreversible operations, account checkpoint, fallback, and
|
|
78
|
+
cleanup.
|
|
79
|
+
- Question ledger: each requested field, input effort, required or optional status, answer source,
|
|
80
|
+
immediate decision it changes, fallback for missing answers, privacy class, and later inference
|
|
81
|
+
alternative.
|
|
82
|
+
- Personalization ledger: answer-to-screen, sample, recommendation, template, primary action, and
|
|
83
|
+
default-path mapping; route version; unsupported-answer behavior; and whether copy or actual work
|
|
84
|
+
changes.
|
|
85
|
+
- Sample ledger: source, sample label, editability, permissions, cost, transition to user data,
|
|
86
|
+
persistence, cleanup, and whether the user receives a result based on meaningful own input.
|
|
87
|
+
- Account and identity ledger: stable internal user identifier, provider and provider-subject
|
|
88
|
+
identity, contact addresses, verified state, link and unlink proof, duplicate-account handling,
|
|
89
|
+
recovery boundary, and anonymous-state transfer transaction.
|
|
90
|
+
- Instruction ledger: task complexity, prerequisite knowledge, safety or legal requirement,
|
|
91
|
+
no-onboarding path, short task path, contextual help triggers, detailed tutorial, skip or advanced
|
|
92
|
+
path, and successful task postcondition.
|
|
93
|
+
- Activation contract: user-owned result, required input, successful postcondition, allowed sample
|
|
94
|
+
contribution, time window, repeat-value event, paid outcome, and invalid proxy events.
|
|
95
|
+
- Funnel ledger: eligible visitor, core-task start, account checkpoint reached, account completed,
|
|
96
|
+
anonymous work claimed, own result produced, repeat value, paid outcome, refund, and retained use.
|
|
97
|
+
- Experiment ledger: control and variants, power or minimum detectable effect assumptions, exposure
|
|
98
|
+
integrity, guardrails, observation windows, delayed outcomes, segment policy, and stop decision.
|
|
99
|
+
|
|
100
|
+
<!-- mustflow-section: preconditions -->
|
|
101
|
+
## Preconditions
|
|
102
|
+
|
|
103
|
+
- Define activation from a product-value postcondition before changing the account gate, onboarding
|
|
104
|
+
UI, authentication choice, tutorial, or metric.
|
|
105
|
+
- When comparing account-first with try-before-signup, begin the headline denominator at the same
|
|
106
|
+
eligible visitor boundary, before either variant creates friction.
|
|
107
|
+
- Keep every eligible assigned visitor or user in the intent-to-treat denominator, including users
|
|
108
|
+
who abandon account creation, questions, authentication, tutorials, or instrumentation.
|
|
109
|
+
- A guest experience must not expose sensitive, regulated, irreversible, high-abuse, or unbounded
|
|
110
|
+
paid work merely to remove signup friction.
|
|
111
|
+
- Treat external onboarding, authentication, checkout, demo, and retention benchmarks as priors or
|
|
112
|
+
design leads, not transferable effect sizes or repository defaults.
|
|
113
|
+
- Keep command execution under `.mustflow/config/commands.toml`; this skill does not authorize live
|
|
114
|
+
experiments, analytics queries, production flags, identity-provider changes, messaging, billing
|
|
115
|
+
changes, or new data collection.
|
|
116
|
+
|
|
117
|
+
<!-- mustflow-section: allowed-edits -->
|
|
118
|
+
## Allowed Edits
|
|
119
|
+
|
|
120
|
+
- Add or refine account checkpoints, guest sandboxes, anonymous state transfer, onboarding state
|
|
121
|
+
machines, question schemas, authentication choices, personalization mappings, sample workspaces,
|
|
122
|
+
own-data transitions, instruction paths, activation events, experiment assignment, metrics,
|
|
123
|
+
guardrails, fixtures, tests, docs, route metadata, and synchronized templates.
|
|
124
|
+
- Remove questions whose answers do not change the user's immediate first-value path.
|
|
125
|
+
- Replace passive tours or static galleries with clearly labeled editable samples when the product
|
|
126
|
+
and permission model support a safe transition to a user-owned result.
|
|
127
|
+
- Add stable user and identity records, explicit account-link confirmation, and duplicate-account
|
|
128
|
+
recovery only within the existing authentication and security contract.
|
|
129
|
+
- Do not collect additional personal or company data merely to improve CRM completeness, identify a
|
|
130
|
+
person by email address alone, auto-link accounts from an email match, or weaken consent, access,
|
|
131
|
+
deletion, credential, recovery, or purpose-limitation rules.
|
|
132
|
+
|
|
133
|
+
<!-- mustflow-section: procedure -->
|
|
134
|
+
## Procedure
|
|
135
|
+
|
|
136
|
+
1. Define one observable activation outcome. Require at least one meaningful user-owned input and a
|
|
137
|
+
successful result or state change tied to the product's core value. Record signup, sample views,
|
|
138
|
+
tour completion, recommendation clicks, and template opens as funnel events, not activation.
|
|
139
|
+
2. Fix the denominator at eligible visitor or assignment before account or onboarding friction.
|
|
140
|
+
Calculate activation, retained use, paid conversion, and contribution per eligible assigned unit,
|
|
141
|
+
not per signup, answerer, onboarding completer, sample viewer, or activated survivor.
|
|
142
|
+
3. Decompose the funnel without changing the headline denominator. Use stage conversion to locate
|
|
143
|
+
losses, then return to intent-to-treat outcomes for the decision. Do not optimize signup rate at
|
|
144
|
+
the expense of fewer visitors reaching owned value or paid contribution.
|
|
145
|
+
4. Classify the first-value path. Distinguish an instant result with bounded inputs, an editable
|
|
146
|
+
collaboration sample, guest commerce, an expensive generated result, and sensitive or regulated
|
|
147
|
+
work. A pre-account experience is an option, not a universal rule.
|
|
148
|
+
5. Place the account checkpoint at the first boundary that genuinely needs durable ownership,
|
|
149
|
+
persistence, cross-device recovery, export, sharing, collaboration, payment, sensitive data,
|
|
150
|
+
abuse control, or an irreversible operation. Do not gate a safe disposable preview merely to
|
|
151
|
+
inflate signups, and do not delay identity past a real security boundary.
|
|
152
|
+
6. Bound guest execution. Limit cost, rate, persistence, data scope, permissions, and shareability;
|
|
153
|
+
label disposable state and provide a useful error or fallback.
|
|
154
|
+
Prevent a guest identifier from becoming an authorization credential.
|
|
155
|
+
7. Transfer anonymous work atomically from the user's perspective. Preserve the chosen assignment,
|
|
156
|
+
result, draft, and attribution; claim each artifact once; establish ownership and permissions;
|
|
157
|
+
make retries idempotent; and avoid a blank restart after account completion.
|
|
158
|
+
8. Price each question against the work it changes. Ask an early question only when its answer
|
|
159
|
+
changes the immediate sample, recommendation, primary action, permissions, or result path enough
|
|
160
|
+
to plausibly offset abandonment. Defer fields inferable from later behavior.
|
|
161
|
+
9. Prefer a low-effort intent choice over typed profiling. Add another question only when its answer
|
|
162
|
+
creates a distinct first task or prevents a material wrong path. Do not copy a universal question
|
|
163
|
+
count, field-drop rate, completion threshold, or three-step rule from another product.
|
|
164
|
+
10. Make personalization operational. Change the sample, first task, recommendation target, default,
|
|
165
|
+
or workflow step; decorative greetings or reordered cards alone do not establish value. Keep a
|
|
166
|
+
safe skip, unknown, novel-intent, and changed-intent path.
|
|
167
|
+
11. Show value before expensive setup when feasible. Keep the sample inside the real product,
|
|
168
|
+
identify it as sample data, make the relevant input or output editable, and preserve the next
|
|
169
|
+
action needed to convert it into the user's own work.
|
|
170
|
+
12. Separate authentication UX from authentication assurance. Email and password, emailed link or
|
|
171
|
+
code, social or enterprise federation, passkeys, and platform login differ in completion,
|
|
172
|
+
re-entry, device availability, recovery, privacy, provider dependency, and support burden; none
|
|
173
|
+
is a universal retention winner or an automatic security substitute.
|
|
174
|
+
13. Choose authentication options from service and risk context. Account for consumer versus
|
|
175
|
+
enterprise users, platform norms, shared or lost devices, email reliability, provider access,
|
|
176
|
+
privacy relay, regulated assurance, offline or cross-device use, and recovery. Route credential,
|
|
177
|
+
session, phishing-resistance, and authorization decisions through `auth-permission-change`.
|
|
178
|
+
14. Keep product identity stable across authentication methods. Use an internal `user_id` and a
|
|
179
|
+
separate identity record keyed by issuer or provider plus immutable provider subject. Treat
|
|
180
|
+
email as a changeable contact attribute; require current-account proof and fresh provider proof
|
|
181
|
+
before linking; preserve explicit duplicate-account and recovery paths.
|
|
182
|
+
15. Choose the instruction format from task complexity and consequence. Use no forced onboarding
|
|
183
|
+
when the safe core action is self-evident, a short task path when a few ordered choices unlock
|
|
184
|
+
value, contextual help when explanation is needed at a decision point, and a detailed tutorial
|
|
185
|
+
only when prerequisite knowledge, safety, irreversibility, or legal duty makes it necessary.
|
|
186
|
+
16. Teach by completing the real task. Keep skip, back, resume, and advanced paths where safe; store
|
|
187
|
+
progress only when useful; avoid long passive tours before value; and do not count tutorial completion as activation.
|
|
188
|
+
17. Choose one primary action per current intent. Secondary navigation, escape, accessibility, and
|
|
189
|
+
safety controls remain available but visually subordinate. Reveal broader features after the
|
|
190
|
+
first owned result or when the user explicitly asks for them.
|
|
191
|
+
18. Randomize before the intervention. Compare the current path with bounded variants such as guest
|
|
192
|
+
preview, a different account checkpoint, fewer questions, authentication choice, editable
|
|
193
|
+
sample, contextual help, or a focused primary action. Avoid changing all mechanisms at once
|
|
194
|
+
unless the experiment intentionally evaluates the complete bundle.
|
|
195
|
+
19. Calculate friction break-even explicitly. When downstream outcome definitions are equal, a
|
|
196
|
+
conditional outcome lift must at least offset the ratio between control and variant completion.
|
|
197
|
+
Prefer directly observed per-eligible-visitor outcomes over modeled or borrowed rates.
|
|
198
|
+
20. Track outcome depth and durability separately: core-task start, account completion, first own
|
|
199
|
+
result, repeated core action, retained use, paid conversion, refund or cancellation, support
|
|
200
|
+
burden, guest compute cost, abuse, duplicate accounts, recovery failure, and identity-link error.
|
|
201
|
+
21. Predeclare guardrails and analysis policy. Include latency, accessibility, privacy, error rate,
|
|
202
|
+
support contacts, sample cleanup, low-frequency use cases, segment heterogeneity, and delayed
|
|
203
|
+
outcomes. Correct for repeated peeking and do not promote post-hoc segments as preregistered.
|
|
204
|
+
22. Preserve experiment identity across anonymous state, account creation, authentication retries,
|
|
205
|
+
devices, and identity linking. Record assignment and exposure separately so tracking prevention,
|
|
206
|
+
duplicate events, or late loading cannot silently move units between variants.
|
|
207
|
+
23. Promote only when the full assigned cohort improves or a declared target segment has a safe,
|
|
208
|
+
stable policy. Keep reversible fallbacks for unsupported intents, identity-provider failure,
|
|
209
|
+
guest-transfer failure, and new-user states.
|
|
210
|
+
|
|
211
|
+
<!-- mustflow-section: postconditions -->
|
|
212
|
+
## Postconditions
|
|
213
|
+
|
|
214
|
+
- Activation requires a user-owned value result and excludes signup, passive sample, and tutorial
|
|
215
|
+
proxy events.
|
|
216
|
+
- Account-first and pre-account variants share an eligible-visitor denominator and a bounded account
|
|
217
|
+
checkpoint appropriate to cost, ownership, sensitivity, and irreversibility.
|
|
218
|
+
- Anonymous results transfer once into stable account ownership without resetting the user to blank.
|
|
219
|
+
- Authentication options are service- and risk-specific, identity is not keyed by email alone, and
|
|
220
|
+
credential or assurance decisions remain under the authentication security contract.
|
|
221
|
+
- Every early question changes a named immediate decision or is deferred.
|
|
222
|
+
- Samples are labeled, safely editable, and connected to an own-data result.
|
|
223
|
+
- Instruction depth follows task complexity and consequence, and activation is not tutorial
|
|
224
|
+
completion.
|
|
225
|
+
- Promotion evidence includes delayed retained use, paid outcomes, and named guardrails, or remains
|
|
226
|
+
explicitly preliminary.
|
|
227
|
+
|
|
228
|
+
<!-- mustflow-section: verification -->
|
|
229
|
+
## Verification
|
|
230
|
+
|
|
231
|
+
Use configured oneshot command intents when available: `changes_status`, `changes_diff_summary`,
|
|
232
|
+
`lint`, `build`, `test_related`, `test`, `docs_validate_fast`, `test_release`, and `mustflow_check`.
|
|
233
|
+
Do not infer raw analytics, warehouse, experimentation, identity-provider, browser, deployment, or
|
|
234
|
+
production commands.
|
|
235
|
+
|
|
236
|
+
<!-- mustflow-section: failure-handling -->
|
|
237
|
+
## Failure Handling
|
|
238
|
+
|
|
239
|
+
- If no user-owned activation postcondition exists, keep the work as an onboarding hypothesis or
|
|
240
|
+
event-instrumentation change and do not claim activation improvement.
|
|
241
|
+
- If the guest boundary cannot contain sensitive data, abuse, cost, ownership, or irreversible
|
|
242
|
+
effects, keep account creation before that operation.
|
|
243
|
+
- If anonymous state cannot be claimed atomically and idempotently, preserve a recoverable draft and
|
|
244
|
+
do not advertise seamless transfer.
|
|
245
|
+
- If assignment or identity joins are unreliable, stop causal claims and report exposure-analysis
|
|
246
|
+
limits separately from intent-to-treat evidence.
|
|
247
|
+
- If a sample cannot transition safely into user ownership, keep it read-only and do not count it as
|
|
248
|
+
activation.
|
|
249
|
+
- If authentication completion improves while duplicate accounts, recovery failures, or assurance
|
|
250
|
+
regress, do not call the option a durable winner.
|
|
251
|
+
- If personalization benefit appears only after excluding abandoners, reject the survivor-biased
|
|
252
|
+
result.
|
|
253
|
+
- If delayed retention, payment, refund, or cancellation outcomes are unavailable, report the result
|
|
254
|
+
as an early funnel signal rather than a durable business win.
|
|
255
|
+
|
|
256
|
+
<!-- mustflow-section: output-format -->
|
|
257
|
+
## Output Format
|
|
258
|
+
|
|
259
|
+
- Eligible visitor or user cohort, assignment, exposure, and denominator
|
|
260
|
+
- User-owned activation and invalid proxy events
|
|
261
|
+
- Pre-account experience, account checkpoint, and anonymous-state transfer
|
|
262
|
+
- Authentication option, identity, linking, duplicate-account, and recovery boundaries
|
|
263
|
+
- Question cost and immediate decision changed
|
|
264
|
+
- Personalization, sample, and sample-to-own contract
|
|
265
|
+
- No-onboarding, short task, contextual help, or detailed-tutorial decision
|
|
266
|
+
- Funnel, break-even, delayed outcome, and guardrail evidence
|
|
267
|
+
- Files changed
|
|
268
|
+
- Command intents run and skipped checks
|
|
269
|
+
- Remaining onboarding-activation risk
|
package/templates/default/locales/en/.mustflow/skills/product-portfolio-integrity-review/SKILL.md
ADDED
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
---
|
|
2
|
+
mustflow_doc: skill.product-portfolio-integrity-review
|
|
3
|
+
locale: en
|
|
4
|
+
canonical: true
|
|
5
|
+
revision: 1
|
|
6
|
+
lifecycle: mustflow-owned
|
|
7
|
+
authority: procedure
|
|
8
|
+
name: product-portfolio-integrity-review
|
|
9
|
+
description: Apply this skill when a multi-product business changes unified versus separate accounts, shared identity or account portals, common versus service-specific credit wallets, cross-service credit value, individual subscriptions versus pure or mixed bundles, portfolio entitlements, bundle cannibalization, umbrella versus independent or endorsed brands, brand-fit and failure spillover, service-specific suspension or data boundaries, cross-product reuse, or portfolio customer value and must combine customer convenience without collapsing money rights, authorization, product economics, or operational failure domains.
|
|
10
|
+
metadata:
|
|
11
|
+
mustflow_schema: "1"
|
|
12
|
+
mustflow_kind: procedure
|
|
13
|
+
pack_id: mustflow.core
|
|
14
|
+
skill_id: mustflow.core.product-portfolio-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
|
+
# Product Portfolio Integrity Review
|
|
28
|
+
|
|
29
|
+
<!-- mustflow-section: purpose -->
|
|
30
|
+
## Purpose
|
|
31
|
+
|
|
32
|
+
Review account, wallet, subscription, and brand integration as separate portfolio decisions. Reduce
|
|
33
|
+
the cost of trying a second product without letting one product's entitlement, fraud state, variable
|
|
34
|
+
cost, outage, data access, or reputation silently control every other product.
|
|
35
|
+
|
|
36
|
+
<!-- mustflow-section: use-when -->
|
|
37
|
+
## Use When
|
|
38
|
+
|
|
39
|
+
- Several products compare one account with separate accounts, a shared account portal, common login,
|
|
40
|
+
linked identities, shared workspaces, or product-specific membership.
|
|
41
|
+
- Products compare one common credit wallet with separate balances, service conversion rates,
|
|
42
|
+
product-specific grants, portfolio credits, or cross-service spend.
|
|
43
|
+
- A business compares individual subscriptions, an all-products subscription, pure bundling, mixed
|
|
44
|
+
bundling, optional add-ons, shared allowances, or usage overage.
|
|
45
|
+
- Products compare one umbrella brand, endorsed product brands, independent brands, rebranding,
|
|
46
|
+
parent-brand guarantees, or failure and reputation spillover.
|
|
47
|
+
- Reuse, cross-product adoption, bundle churn, paid recharge, contribution, cannibalization, support,
|
|
48
|
+
abuse, or portfolio customer value is created, changed, reviewed, or reported.
|
|
49
|
+
|
|
50
|
+
<!-- mustflow-section: do-not-use-when -->
|
|
51
|
+
## Do Not Use When
|
|
52
|
+
|
|
53
|
+
- The task is implementation of a Product Registry, shared auth, billing, entitlements, credit ledger,
|
|
54
|
+
account portal, admin console, or app factory without a commercial portfolio decision; use
|
|
55
|
+
`small-service-platform-architecture-review` and the narrower technical owner.
|
|
56
|
+
- The task only changes atomic credit reservation, lot allocation, refund, expiry, reconciliation, or
|
|
57
|
+
wallet concurrency; use `credit-ledger-integrity-review`.
|
|
58
|
+
- The task only changes generic price levels, annual billing, trials, or one product's subscription
|
|
59
|
+
model; use `pricing-model-integrity-review`.
|
|
60
|
+
- The task only changes cross-promotion placement, affiliate acquisition, result watermarking, or
|
|
61
|
+
campaign fatigue; use `growth-distribution-integrity-review`.
|
|
62
|
+
- The task requests jurisdiction-specific identity, stored-value, accounting, tax, competition,
|
|
63
|
+
trademark, contract, privacy, or consumer-law advice. Use current qualified authority.
|
|
64
|
+
|
|
65
|
+
<!-- mustflow-section: required-inputs -->
|
|
66
|
+
## Required Inputs
|
|
67
|
+
|
|
68
|
+
- Portfolio ledger: products, customer segments, jobs, purchase owners, workflow adjacency,
|
|
69
|
+
substitutes and complements, cost shape, support expectations, trust promise, risk class, and
|
|
70
|
+
current shared or separate surfaces.
|
|
71
|
+
- Identity ledger: global user identity, credentials, organizations, workspaces, memberships, roles,
|
|
72
|
+
service access, data ownership, consent, account linking, recovery, deletion, export, suspension,
|
|
73
|
+
fraud state, and support authority.
|
|
74
|
+
- Wallet ledger: wallet and lot owner, paid, subscription, promotional, referral, refund, and
|
|
75
|
+
product-specific classes; service exchange rate, variable cost, quote, reservation, capture,
|
|
76
|
+
release, reversal, expiry, cap, recharge, abuse, and reconciliation.
|
|
77
|
+
- Package ledger: individual product, bundle, add-on, allowance, overage, price, entitlement, service
|
|
78
|
+
cost, downgrade, upgrade, pause, cancellation, refund, migration, and grandfathering.
|
|
79
|
+
- Brand ledger: parent and product name, audience and job fit, quality promise, evidence transfer,
|
|
80
|
+
endorsement strength, visual relationship, contract party, support, status communication,
|
|
81
|
+
incident spillover, privacy or safety risk, and separation claim.
|
|
82
|
+
- Economics ledger: eligible conversion, second-product first owned value, paid reuse, recharge,
|
|
83
|
+
individual-to-bundle upgrade, multi-subscription downgrade, incremental revenue, variable cost,
|
|
84
|
+
support, fraud, refund, churn, dormant entitlement, and retained portfolio contribution.
|
|
85
|
+
- Experiment ledger: account, wallet, package, and brand version; assignment time and unit; rollout
|
|
86
|
+
order; holdout; migration effects; interference; horizon; guardrails; and promotion rule.
|
|
87
|
+
|
|
88
|
+
<!-- mustflow-section: preconditions -->
|
|
89
|
+
## Preconditions
|
|
90
|
+
|
|
91
|
+
- Separate account identity, authentication, authorization, wallet rights, package entitlements, and
|
|
92
|
+
brand presentation. Sharing one does not authorize sharing the others.
|
|
93
|
+
- Define the second-product owned-value event and portfolio contribution outcome before calling
|
|
94
|
+
login reuse, credit spend, bundle enrollment, or shared branding successful.
|
|
95
|
+
- Treat copied wallet ratios, bundle discounts, brand-fit scores, churn lifts, product counts, and
|
|
96
|
+
rollout sequences as hypotheses, not defaults.
|
|
97
|
+
- Refresh current identity, stored-value, payment, tax, accounting, privacy, trademark, platform, and
|
|
98
|
+
competition constraints before changing live rights or public brand claims.
|
|
99
|
+
- This skill does not authorize account merges, wallet transfers, entitlement migrations, price
|
|
100
|
+
changes, rebranding, experiments, live messages, releases, or production changes.
|
|
101
|
+
|
|
102
|
+
<!-- mustflow-section: allowed-edits -->
|
|
103
|
+
## Allowed Edits
|
|
104
|
+
|
|
105
|
+
- Add or refine portfolio policy, identity and service-membership boundaries, wallet classes and
|
|
106
|
+
exchange policy, individual and bundle packages, entitlement rules, brand architecture, failure
|
|
107
|
+
isolation, experiment events, contribution metrics, fixtures, tests, docs, route metadata, and
|
|
108
|
+
synchronized templates.
|
|
109
|
+
- Add explicit handoffs to identity, access, credit, payment, subscription, pricing, accounting,
|
|
110
|
+
privacy, security, platform, trademark, or legal owners.
|
|
111
|
+
- Replace global account records, one undifferentiated balance, bundle-only pricing, account-churn
|
|
112
|
+
theater, or logo-only isolation with explicit service rights and evidence.
|
|
113
|
+
- Do not merge product data, suspend unrelated products, rewrite purchased rights, silently migrate
|
|
114
|
+
subscriptions, or imply operational separation that current systems and contracts do not provide.
|
|
115
|
+
|
|
116
|
+
<!-- mustflow-section: procedure -->
|
|
117
|
+
## Procedure
|
|
118
|
+
|
|
119
|
+
1. Split four decisions: account, wallet, subscription package, and brand architecture. Sequence them
|
|
120
|
+
so one treatment does not hide the effect of another.
|
|
121
|
+
2. Map product relationship. Classify shared customer, purchase owner, adjacent workflow,
|
|
122
|
+
complementarity, substitution, cost shape, trust promise, and risk. Common ownership alone does
|
|
123
|
+
not prove that integration creates customer value.
|
|
124
|
+
3. Use a global identity only to remove repeated identity proof where appropriate. Keep service
|
|
125
|
+
membership, workspace, organization, role, permission, consent, data, session policy, and
|
|
126
|
+
suspension as explicit product-scoped facts.
|
|
127
|
+
4. Separate login continuity from authorization. A user recognized by product B has no B entitlement,
|
|
128
|
+
tenant membership, data access, or consent until the corresponding policy grants it.
|
|
129
|
+
5. Design account recovery and enforcement by blast radius. Cover compromised identity, disputed
|
|
130
|
+
payment, product abuse, organization removal, support lock, export, deletion, and appeal without
|
|
131
|
+
turning one weak product signal into an unexplained portfolio-wide ban.
|
|
132
|
+
6. Measure unified account value from eligible second-product activation and retained paid use.
|
|
133
|
+
Login success, account count, or free cross-use alone does not prove higher customer value.
|
|
134
|
+
7. Treat a shared wallet as a transfer mechanism, not demand creation. Preserve paid, subscription,
|
|
135
|
+
promotional, referral, refund, and product-specific lots with their acquisition and policy
|
|
136
|
+
versions.
|
|
137
|
+
8. Price cross-service spend explicitly. Define service exchange rates, quotes, caps, variable-cost
|
|
138
|
+
exposure, premium modes, and refund rules. One nominal credit need not buy the same resource or
|
|
139
|
+
outcome in products with different cost and value.
|
|
140
|
+
9. Prevent wallet arbitrage and cannibalization. Test whether users replace two profitable purchases
|
|
141
|
+
with one smaller shared balance, route grants into the highest-cost product, or count promotional
|
|
142
|
+
trial spend as paid adoption.
|
|
143
|
+
10. Route wallet mutation through append-only ledger, reservation, capture, release, reversal,
|
|
144
|
+
idempotency, lot allocation, and reconciliation owners. This skill decides portfolio rights, not
|
|
145
|
+
atomic balance implementation.
|
|
146
|
+
11. Split complements from substitutes before packaging. Complementary products may support a
|
|
147
|
+
workflow bundle; substitutes can concentrate use in the most expensive option and may need a
|
|
148
|
+
shared allowance, metered overage, or separate entitlement.
|
|
149
|
+
12. Compare individual-only, pure bundle, and mixed bundle at package and budget parity. Preserve
|
|
150
|
+
individual purchase when one-product demand is material, and treat mixed bundling as a candidate,
|
|
151
|
+
not a universal winner.
|
|
152
|
+
13. Price bundle migration, not only acquisition. Include upgrades, existing multi-product customers
|
|
153
|
+
downgrading into a cheaper bundle, additional usage cost, unused entitlements, refunds, support,
|
|
154
|
+
taxes, and later recharge or overage.
|
|
155
|
+
14. Keep bundle entitlement and product activation separate. A door opened by the package does not
|
|
156
|
+
create cross-use; product data transfer, a concrete adjacent job, and owned value in the second
|
|
157
|
+
product must still exist.
|
|
158
|
+
15. Distinguish bundle-level cancellation from service health. Track product-level active use,
|
|
159
|
+
dormant entitlements, partial value, downgrade, pause, and payment failure so a low bundle churn
|
|
160
|
+
rate does not hide a portfolio of unused products.
|
|
161
|
+
16. Choose a brand model from customer fit and failure cost: branded house, endorsed products, or
|
|
162
|
+
independent brands. Do not make every product share one name merely because account and billing
|
|
163
|
+
are shared.
|
|
164
|
+
17. Transfer trust only where the parent evidence applies. Compare audience, job, quality promise,
|
|
165
|
+
tone, price, safety, regulation, and expected support; a trusted parent in one category does not
|
|
166
|
+
guarantee competence in an unrelated or higher-risk product.
|
|
167
|
+
18. Treat endorsement strength as adjustable. Use parent-first naming for closely fitted core
|
|
168
|
+
products, endorsement for adjacent products, and weaker or separate presentation where
|
|
169
|
+
experimentation or incident cost is materially different.
|
|
170
|
+
19. Do not confuse brand separation with failure isolation. Verify product-scoped data access,
|
|
171
|
+
deploy and dependency boundaries, status communication, support, abuse decisions, incident
|
|
172
|
+
response, contracts, and recovery. A new logo cannot contain a shared outage or breach.
|
|
173
|
+
20. Explain shared relationships honestly. Billing descriptors, terms, privacy notices, account
|
|
174
|
+
portals, support, and incident notices should not contradict the public brand structure.
|
|
175
|
+
21. Roll out in identifiable stages. Account continuity, bounded wallet portability, mixed packages,
|
|
176
|
+
and brand changes should have separate versions, baselines, guardrails, and rollback or migration
|
|
177
|
+
plans whenever feasible.
|
|
178
|
+
22. Measure the full portfolio. Use eligible second-product first value, paid repeat use, recharge,
|
|
179
|
+
package mix, service-level activity, total variable cost, support, refunds, fraud, churn,
|
|
180
|
+
incident spillover, and retained portfolio contribution rather than product count or gross bundle
|
|
181
|
+
revenue.
|
|
182
|
+
23. Promote only a reversible policy that improves portfolio contribution and customer comprehension
|
|
183
|
+
while preserving product-scoped authorization, money rights, service economics, privacy,
|
|
184
|
+
support, failure containment, and honest brand promises.
|
|
185
|
+
|
|
186
|
+
<!-- mustflow-section: postconditions -->
|
|
187
|
+
## Postconditions
|
|
188
|
+
|
|
189
|
+
- Account, wallet, package, and brand decisions remain distinct and versioned.
|
|
190
|
+
- Unified identity does not imply cross-product authorization, data access, consent, entitlement, or
|
|
191
|
+
global enforcement without an explicit policy.
|
|
192
|
+
- Shared credit preserves balance classes, service economics, paid reuse evidence, and technical
|
|
193
|
+
ledger handoffs.
|
|
194
|
+
- Individual and bundle packages account for migration, cannibalization, usage cost, dormant value,
|
|
195
|
+
and service-level health.
|
|
196
|
+
- Brand architecture reflects product fit and real operational failure boundaries.
|
|
197
|
+
- Headline value uses eligible portfolio contribution rather than account reuse, service count,
|
|
198
|
+
free credit spend, gross bundle revenue, or logo reach.
|
|
199
|
+
|
|
200
|
+
<!-- mustflow-section: verification -->
|
|
201
|
+
## Verification
|
|
202
|
+
|
|
203
|
+
Use configured oneshot command intents when available: `changes_status`, `changes_diff_summary`,
|
|
204
|
+
`lint`, `build`, `test_related`, `test`, `docs_validate_fast`, `test_release`, and
|
|
205
|
+
`mustflow_check`. Do not infer live identity, wallet, payment, subscription, entitlement, brand,
|
|
206
|
+
analytics, experiment, migration, deployment, or production commands.
|
|
207
|
+
|
|
208
|
+
<!-- mustflow-section: failure-handling -->
|
|
209
|
+
## Failure Handling
|
|
210
|
+
|
|
211
|
+
- If service membership or data ownership is implicit, do not approve a unified account migration.
|
|
212
|
+
- If wallet classes, service cost, or historical rights cannot be reconstructed, preserve separate
|
|
213
|
+
balances until the credit owners can define safe portability.
|
|
214
|
+
- If bundle economics omit existing multi-product downgrades or variable usage cost, report gross
|
|
215
|
+
package demand without claiming incremental profit.
|
|
216
|
+
- If brand fit or incident spillover is unknown, use a reversible endorsed relationship rather than
|
|
217
|
+
claiming either full integration or complete isolation.
|
|
218
|
+
- If several portfolio axes changed together, report a bundle effect and do not claim which
|
|
219
|
+
mechanism caused reuse, churn, or contribution.
|
|
220
|
+
|
|
221
|
+
<!-- mustflow-section: output-format -->
|
|
222
|
+
## Output Format
|
|
223
|
+
|
|
224
|
+
- Portfolio products, customers, jobs, complement or substitute relationship, cost, trust, and risk
|
|
225
|
+
- Global identity, service membership, authorization, data, consent, recovery, suspension, and appeal
|
|
226
|
+
- Wallet classes, service exchange, quote, rights, recharge, arbitrage, cannibalization, and ledger
|
|
227
|
+
handoff
|
|
228
|
+
- Individual, bundle, add-on, overage, migration, dormant entitlement, churn, and contribution
|
|
229
|
+
- Parent and product brand fit, endorsement, promise, public relationship, incident spillover, and
|
|
230
|
+
operational isolation
|
|
231
|
+
- Experiment sequencing, metrics, files changed, command intents run and skipped checks
|
|
232
|
+
- Remaining product-portfolio risk
|
|
233
|
+
|
package/templates/default/locales/en/.mustflow/skills/prompt-contract-quality-review/SKILL.md
CHANGED
|
@@ -49,6 +49,7 @@ Review prompts as product contracts, not prose polish. A production prompt shoul
|
|
|
49
49
|
context assembly, prompt construction, generation, citation validation, or answerability failed;
|
|
50
50
|
use `rag-pipeline-triage` first.
|
|
51
51
|
- The main risk is token spend, provider prompt-cache hit rate, chat-history bloat, RAG context size, model routing cost, reasoning budget, retry replay, or cost observability; use `llm-token-cost-control-review`.
|
|
52
|
+
- The main risk is choosing a cheap-first model cascade, escalation threshold, fallback model, or route calibration while preserving accepted outcomes; use `llm-model-routing-integrity-review`.
|
|
52
53
|
- The main risk is time to first token, first useful output, streaming latency, LLM round trips, tool wait, prompt-cache latency, model routing speed, realtime continuation, priority tier, predicted-output latency, or user-perceived response speed; use `llm-response-latency-review`.
|
|
53
54
|
- The main risk is autonomous agent control flow, planner/executor/verifier separation, tool-call gates, approval or interrupt state, durable resume behavior, loop budgets, retry classification, handoffs, guardrails, or trace outcome evaluation; use `agent-execution-control-review`.
|
|
54
55
|
- The main risk is untrusted text overriding instructions, hidden commands, data exfiltration, or agent permission drift; use `external-prompt-injection-defense` first, then this skill only for the prompt contract that remains.
|