@sylphx/flow 2.8.0 → 2.10.0
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/CHANGELOG.md +32 -0
- package/assets/slash-commands/review-account-security.md +51 -0
- package/assets/slash-commands/review-admin.md +54 -0
- package/assets/slash-commands/review-auth.md +47 -0
- package/assets/slash-commands/review-billing.md +47 -0
- package/assets/slash-commands/review-code-quality.md +63 -0
- package/assets/slash-commands/review-data-architecture.md +36 -0
- package/assets/slash-commands/review-database.md +40 -0
- package/assets/slash-commands/review-delivery.md +71 -0
- package/assets/slash-commands/review-discovery.md +49 -0
- package/assets/slash-commands/review-growth.md +62 -0
- package/assets/slash-commands/review-i18n.md +50 -0
- package/assets/slash-commands/review-ledger.md +40 -0
- package/assets/slash-commands/review-observability.md +55 -0
- package/assets/slash-commands/review-operability.md +54 -0
- package/assets/slash-commands/review-performance.md +56 -0
- package/assets/slash-commands/review-pricing.md +48 -0
- package/assets/slash-commands/review-privacy.md +50 -0
- package/assets/slash-commands/review-pwa.md +51 -0
- package/assets/slash-commands/review-referral.md +54 -0
- package/assets/slash-commands/review-security.md +53 -0
- package/assets/slash-commands/review-seo.md +60 -0
- package/assets/slash-commands/review-storage.md +41 -0
- package/assets/slash-commands/review-support.md +55 -0
- package/assets/slash-commands/review-uiux.md +56 -0
- package/package.json +1 -1
- package/assets/slash-commands/saas-admin.md +0 -123
- package/assets/slash-commands/saas-auth.md +0 -78
- package/assets/slash-commands/saas-billing.md +0 -68
- package/assets/slash-commands/saas-discovery.md +0 -135
- package/assets/slash-commands/saas-growth.md +0 -94
- package/assets/slash-commands/saas-i18n.md +0 -66
- package/assets/slash-commands/saas-platform.md +0 -87
- package/assets/slash-commands/saas-review.md +0 -179
- package/assets/slash-commands/saas-security.md +0 -108
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-admin
|
|
3
|
-
description: SaaS admin platform review - RBAC, bootstrap, config, feature flags, ops
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Admin Platform Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review admin systems: RBAC, bootstrap flow, configuration management, feature flags governance, operational tooling, and impersonation.
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Access Control (RBAC)
|
|
16
|
-
|
|
17
|
-
* **Least privilege principle**: Users get minimum permissions needed.
|
|
18
|
-
* Role hierarchy with clear inheritance.
|
|
19
|
-
* Permission granularity (resource-level, action-level).
|
|
20
|
-
* All authorization is **server-enforced**; no client-trust.
|
|
21
|
-
* Role changes require appropriate privilege level and are audited.
|
|
22
|
-
|
|
23
|
-
### Admin Bootstrap (Hard Requirement)
|
|
24
|
-
|
|
25
|
-
* Admin bootstrap must **not rely on file seeding**.
|
|
26
|
-
* Use a secure, auditable **first-login allowlist** for the initial SUPER_ADMIN.
|
|
27
|
-
* **Permanently disable bootstrap** after completion — no re-entry.
|
|
28
|
-
* All privilege grants must be server-enforced and recorded in the audit log.
|
|
29
|
-
* The allowlist must be managed via **secure configuration (environment/secret store)**, not code or DB seeding.
|
|
30
|
-
|
|
31
|
-
### Configuration Management
|
|
32
|
-
|
|
33
|
-
* All **non-secret** product-level configuration must be manageable via admin (server-enforced).
|
|
34
|
-
* Configuration changes require **validation and change history**.
|
|
35
|
-
* Secrets/credentials are **environment-managed only**; admin may expose safe readiness/health visibility, not raw secrets.
|
|
36
|
-
* Support for environment-specific overrides (dev/staging/prod).
|
|
37
|
-
* Rollback capability for configuration changes.
|
|
38
|
-
|
|
39
|
-
### Feature Flags Governance
|
|
40
|
-
|
|
41
|
-
* Gradual rollout support (percentage-based, user segment-based).
|
|
42
|
-
* A/B testing integration where applicable.
|
|
43
|
-
* **Audit trail** for all flag changes (who/when/why).
|
|
44
|
-
* Emergency **kill switches** for rapid disable.
|
|
45
|
-
* Flag lifecycle management (created → active → deprecated → removed).
|
|
46
|
-
* Server-enforced evaluation; no client-side flag source-of-truth.
|
|
47
|
-
|
|
48
|
-
### Operational Management
|
|
49
|
-
|
|
50
|
-
* **User/account management tools**:
|
|
51
|
-
* Search, view, edit user profiles
|
|
52
|
-
* Account status management (active, suspended, banned)
|
|
53
|
-
* Manual verification/unverification
|
|
54
|
-
|
|
55
|
-
* **Entitlements/access management**:
|
|
56
|
-
* View and modify user entitlements
|
|
57
|
-
* Grant/revoke access with audit trail
|
|
58
|
-
* Bulk operations with safeguards
|
|
59
|
-
|
|
60
|
-
* **Lifecycle actions**:
|
|
61
|
-
* Account suspension/reactivation
|
|
62
|
-
* Data export (for user requests)
|
|
63
|
-
* Account deletion with proper cascade
|
|
64
|
-
|
|
65
|
-
* **Issue resolution workflows**:
|
|
66
|
-
* Support ticket integration
|
|
67
|
-
* Action history per user
|
|
68
|
-
* Notes and annotations
|
|
69
|
-
|
|
70
|
-
* **Step-up controls** for sensitive actions:
|
|
71
|
-
* Actions affecting money/credits require MFA
|
|
72
|
-
* Actions affecting security posture require MFA
|
|
73
|
-
* Destructive actions require confirmation + reason
|
|
74
|
-
|
|
75
|
-
### Impersonation
|
|
76
|
-
|
|
77
|
-
* Impersonation allowed **with explicit safeguards**:
|
|
78
|
-
* Requires elevated privilege level
|
|
79
|
-
* Time-limited sessions (auto-expire)
|
|
80
|
-
* Full audit logging (start, actions, end)
|
|
81
|
-
* Clear indicator in UI during impersonation
|
|
82
|
-
* Cannot impersonate higher-privilege users
|
|
83
|
-
* All actions during impersonation attributed to both impersonator and target.
|
|
84
|
-
* Optional: Visible indicator to impersonated user that session was accessed.
|
|
85
|
-
|
|
86
|
-
### Admin Audit Logging
|
|
87
|
-
|
|
88
|
-
* **All admin actions must be auditable**:
|
|
89
|
-
* Who performed the action
|
|
90
|
-
* When (timestamp with timezone)
|
|
91
|
-
* What action was taken
|
|
92
|
-
* Why (required reason for sensitive actions)
|
|
93
|
-
* Before/after state for mutations
|
|
94
|
-
* Correlation to session/request
|
|
95
|
-
* Audit logs must be:
|
|
96
|
-
* Immutable (append-only)
|
|
97
|
-
* Queryable and filterable
|
|
98
|
-
* Exportable for compliance
|
|
99
|
-
* Retained per data retention policy
|
|
100
|
-
|
|
101
|
-
## Domain Discovery
|
|
102
|
-
|
|
103
|
-
After reviewing compliance with spec, explore improvements:
|
|
104
|
-
|
|
105
|
-
* **Admin UX**: Is the admin panel efficient for common tasks? Keyboard shortcuts? Bulk actions?
|
|
106
|
-
* **Self-service vs admin**: What admin actions could be self-service for users?
|
|
107
|
-
* **Automation**: What repetitive admin tasks could be automated? Scheduled jobs?
|
|
108
|
-
* **Alerting**: Should certain admin actions trigger alerts? (e.g., mass deletions)
|
|
109
|
-
* **Delegation**: Can some admin tasks be delegated to lower roles safely?
|
|
110
|
-
* **Mobile admin**: Is there a need for mobile admin access? How to secure?
|
|
111
|
-
|
|
112
|
-
## Domain Gates
|
|
113
|
-
|
|
114
|
-
* [ ] RBAC implemented with least privilege
|
|
115
|
-
* [ ] Bootstrap flow is secure and one-time only
|
|
116
|
-
* [ ] Config changes are validated and audited
|
|
117
|
-
* [ ] Feature flags have full audit trail
|
|
118
|
-
* [ ] Sensitive actions require step-up (MFA)
|
|
119
|
-
* [ ] Impersonation is time-limited and fully logged
|
|
120
|
-
* [ ] All admin actions are auditable
|
|
121
|
-
* [ ] Audit logs are immutable and queryable
|
|
122
|
-
* [ ] No hardcoded admin credentials anywhere
|
|
123
|
-
* [ ] Admin endpoints are rate-limited
|
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-auth
|
|
3
|
-
description: SaaS identity review - SSO, passkeys, verification, account security
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Identity & Account Security Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review identity systems: authentication methods, SSO providers, passkeys/WebAuthn, verification flows, session management, and account security surfaces.
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Identity Providers (SSO)
|
|
16
|
-
|
|
17
|
-
* SSO providers (minimum): **Google, Apple, Facebook, Microsoft, GitHub** (prioritize by audience).
|
|
18
|
-
* If provider env/secrets are missing, **hide** the login option (no broken/disabled UI).
|
|
19
|
-
* Allow linking multiple providers and safe unlinking; server-enforced and abuse-protected.
|
|
20
|
-
|
|
21
|
-
### Passkeys (WebAuthn)
|
|
22
|
-
|
|
23
|
-
* Passkeys are first-class with secure enrollment/usage/recovery.
|
|
24
|
-
* Must support cross-device authentication where platform allows.
|
|
25
|
-
|
|
26
|
-
### Verification
|
|
27
|
-
|
|
28
|
-
* **Email verification is mandatory** baseline for high-impact capabilities.
|
|
29
|
-
* **Phone verification is optional** and used as risk-based step-up (anti-abuse, higher-trust flows, recovery); consent-aware and data-minimizing.
|
|
30
|
-
|
|
31
|
-
### Membership and Entitlements
|
|
32
|
-
|
|
33
|
-
* Membership is entitlement-driven and server-enforced.
|
|
34
|
-
* All authorization/entitlements are **server-enforced**; no client-trust.
|
|
35
|
-
|
|
36
|
-
### Account Security Surface
|
|
37
|
-
|
|
38
|
-
* Provide a dedicated **Account Security** surface.
|
|
39
|
-
* **Minimum acceptance criteria**:
|
|
40
|
-
* Session/device visibility and revocation
|
|
41
|
-
* MFA/passkey management
|
|
42
|
-
* Linked identity provider management
|
|
43
|
-
* Key security event visibility (and export where applicable)
|
|
44
|
-
* All server-enforced and auditable.
|
|
45
|
-
|
|
46
|
-
### Session Management
|
|
47
|
-
|
|
48
|
-
* Session/device visibility + revocation available to user.
|
|
49
|
-
* Security event visibility with clear audit trail.
|
|
50
|
-
* Recovery governance (including support-assisted recovery) with strict audit logging.
|
|
51
|
-
* Step-up authentication for sensitive actions.
|
|
52
|
-
|
|
53
|
-
### Password Security
|
|
54
|
-
|
|
55
|
-
* Password UX: masked + temporary reveal option.
|
|
56
|
-
* No plaintext passwords in logs/returns/storage/telemetry.
|
|
57
|
-
* MFA required for Admin/SUPER_ADMIN; step-up for high-risk actions.
|
|
58
|
-
|
|
59
|
-
## Domain Discovery
|
|
60
|
-
|
|
61
|
-
After reviewing compliance with spec, explore improvements:
|
|
62
|
-
|
|
63
|
-
* **Onboarding friction**: Is sign-up flow optimized? Too many steps? Missing social providers for target market?
|
|
64
|
-
* **Security vs UX balance**: Are step-up challenges appropriate? Too frequent? Too rare?
|
|
65
|
-
* **Recovery flows**: Is account recovery secure yet accessible? Support burden from lockouts?
|
|
66
|
-
* **Modern auth**: Are passkeys properly promoted? Is passwordless an option?
|
|
67
|
-
* **Trust signals**: Are verified badges shown? Does verification unlock features appropriately?
|
|
68
|
-
|
|
69
|
-
## Domain Gates
|
|
70
|
-
|
|
71
|
-
* [ ] All SSO providers working (or hidden if unconfigured)
|
|
72
|
-
* [ ] Passkey enrollment/usage/recovery tested
|
|
73
|
-
* [ ] Email verification enforced for high-impact actions
|
|
74
|
-
* [ ] Account security surface complete (sessions, MFA, providers, events)
|
|
75
|
-
* [ ] Session revocation works correctly
|
|
76
|
-
* [ ] No client-trust for authorization decisions
|
|
77
|
-
* [ ] Step-up auth for sensitive actions
|
|
78
|
-
* [ ] No plaintext passwords anywhere
|
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-billing
|
|
3
|
-
description: SaaS billing review - Stripe, webhooks, pricing governance, ledger
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Billing & Payments Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review all payment and billing systems: Stripe integration, webhook handling, pricing governance, subscription state machine, and financial-grade ledger (if applicable).
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Billing State Machine (Hard Requirement)
|
|
16
|
-
|
|
17
|
-
* **Billing and access state machine is mandatory**: define and validate the mapping **Stripe state → internal subscription state → entitlements**, including trial, past_due, unpaid, canceled, refund, and dispute outcomes.
|
|
18
|
-
* UI must only present interpretable, non-ambiguous states derived from server-truth.
|
|
19
|
-
* **No dual-write (hard requirement)**: subscription/payment truth must be derived from Stripe-driven events; internal systems must not directly rewrite billing truth or authorize entitlements based on non-Stripe truth, except for explicitly defined admin remediation flows that are fully server-enforced and fully audited.
|
|
20
|
-
|
|
21
|
-
### Stripe Integration
|
|
22
|
-
|
|
23
|
-
* Support subscriptions and one-time payments as product needs require.
|
|
24
|
-
* Tax/invoicing and refund/dispute handling must be behaviorally consistent with product UX and entitlement state.
|
|
25
|
-
|
|
26
|
-
### Webhook Handling (Hard Requirement)
|
|
27
|
-
|
|
28
|
-
* Webhooks must be idempotent, retry-safe, out-of-order safe, auditable; billing UI reflects server-truth state without ambiguity.
|
|
29
|
-
* **Webhook trust is mandatory (high-risk)**: webhook origin must be verified (signature verification and replay resistance). The Stripe **event id** must be used as the idempotency and audit correlation key; unverifiable events must be rejected and must trigger alerting.
|
|
30
|
-
* **Out-of-order behavior must be explicit**: all webhook handlers must define and enforce a clear out-of-order strategy (event ordering is not guaranteed even for the same subscription), and must define final-state decision rules.
|
|
31
|
-
|
|
32
|
-
### Pricing Governance (Stripe-first, not Dashboard-first)
|
|
33
|
-
|
|
34
|
-
* Stripe is the system-of-record for products, prices, subscriptions, invoices, and disputes; internal systems must not contradict Stripe truth.
|
|
35
|
-
* Pricing changes must be performed by creating new Stripe Prices and updating the "active sellable price" policy; historical prices must remain immutable for existing subscriptions unless an approved migration is executed.
|
|
36
|
-
* Default pricing change policy is **grandfathering**: existing subscribers keep their current price; new customers use the currently active sellable price.
|
|
37
|
-
* An operational-grade **Pricing Admin** must exist to manage creation of new Stripe Prices, activation/deactivation of sellable prices, and (optionally) controlled bulk subscription migrations; all actions must be governed by RBAC, step-up controls, and audit logs.
|
|
38
|
-
* Stripe Dashboard is treated as monitoring/emergency access; non-admin Stripe changes must be detectable (drift), alertable, and remediable.
|
|
39
|
-
|
|
40
|
-
### Financial-Grade Balance System (Only if "balance/credits/wallet" exists)
|
|
41
|
-
|
|
42
|
-
* Any balance concept must be implemented as an **immutable ledger** (append-only source of truth), not a mutable balance field.
|
|
43
|
-
* Deterministic precision (no floats), idempotent posting, concurrency safety, transactional integrity, and auditability are required.
|
|
44
|
-
* Monetary flows must be currency-based and reconcilable with Stripe; credits (if used) must be governed as non-cash entitlements.
|
|
45
|
-
|
|
46
|
-
### Auditability
|
|
47
|
-
|
|
48
|
-
* **Auditability chain is mandatory** for any high-value mutation: who/when/why, before/after state, and correlation to the triggering request/job/webhook must be recorded and queryable.
|
|
49
|
-
|
|
50
|
-
## Domain Discovery
|
|
51
|
-
|
|
52
|
-
After reviewing compliance with spec, explore improvements:
|
|
53
|
-
|
|
54
|
-
* **Conversion optimization**: Are there friction points in the checkout flow? Missing payment methods for target markets?
|
|
55
|
-
* **Churn reduction**: Is dunning (failed payment retry) properly configured? Are there win-back opportunities?
|
|
56
|
-
* **Pricing opportunities**: Are tiers properly differentiated? Is there usage-based pricing potential?
|
|
57
|
-
* **Trial optimization**: Is trial-to-paid conversion measured and optimized?
|
|
58
|
-
* **Upgrade/downgrade UX**: Is plan switching seamless? Prorated correctly?
|
|
59
|
-
|
|
60
|
-
## Domain Gates
|
|
61
|
-
|
|
62
|
-
* [ ] Stripe state machine fully mapped and documented
|
|
63
|
-
* [ ] Webhook handlers are idempotent and out-of-order safe
|
|
64
|
-
* [ ] Signature verification implemented and tested
|
|
65
|
-
* [ ] Pricing admin exists with RBAC and audit
|
|
66
|
-
* [ ] No dual-write violations
|
|
67
|
-
* [ ] Ledger is append-only (if balance exists)
|
|
68
|
-
* [ ] Billing UI reflects server-truth only
|
|
@@ -1,135 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-discovery
|
|
3
|
-
description: SaaS strategic discovery - features, pricing, competitive research
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Strategic Discovery & Opportunities
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Cross-domain strategic exploration: identify new feature opportunities, optimize pricing/packaging, and conduct competitive research. This is NOT compliance checking — it's creative/strategic work to improve the product.
|
|
12
|
-
|
|
13
|
-
## Mandate
|
|
14
|
-
|
|
15
|
-
* **Exploration required**: identify improvements for competitiveness, completeness, usability, reliability, and monetization within fixed constraints.
|
|
16
|
-
* Think beyond current implementation — what's missing? What would make users love this product?
|
|
17
|
-
* Convert insights into **testable acceptance criteria**, not vague suggestions.
|
|
18
|
-
|
|
19
|
-
## Feature Discovery
|
|
20
|
-
|
|
21
|
-
### Process
|
|
22
|
-
|
|
23
|
-
1. **Audit current capabilities**: What does the product do today?
|
|
24
|
-
2. **Identify gaps**: What's missing that users expect?
|
|
25
|
-
3. **Prioritize by impact**: What would move the needle most?
|
|
26
|
-
4. **Define success criteria**: How would we know the feature works?
|
|
27
|
-
|
|
28
|
-
### Areas to Explore
|
|
29
|
-
|
|
30
|
-
* **User workflows**: Are there manual steps that could be automated?
|
|
31
|
-
* **Integrations**: What third-party services should we connect to?
|
|
32
|
-
* **Data/insights**: What data do we have that users would value seeing?
|
|
33
|
-
* **Collaboration**: Are there multi-user/team features missing?
|
|
34
|
-
* **Mobile**: Is the mobile experience feature-complete or degraded?
|
|
35
|
-
* **API/Developer**: Should there be a public API? Webhooks for users?
|
|
36
|
-
* **AI/Automation**: Where could AI add value without being gimmicky?
|
|
37
|
-
|
|
38
|
-
### Output Format
|
|
39
|
-
|
|
40
|
-
For each feature opportunity:
|
|
41
|
-
```markdown
|
|
42
|
-
**Feature**: [Name]
|
|
43
|
-
**Problem**: [What user problem does this solve?]
|
|
44
|
-
**Impact**: [High/Medium/Low] — [Why?]
|
|
45
|
-
**Effort**: [High/Medium/Low] — [Why?]
|
|
46
|
-
**Success Criteria**: [How do we measure success?]
|
|
47
|
-
**Acceptance Criteria**:
|
|
48
|
-
- [ ] [Specific, testable requirement]
|
|
49
|
-
- [ ] [Another requirement]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
## Pricing & Monetization Discovery
|
|
53
|
-
|
|
54
|
-
### Process
|
|
55
|
-
|
|
56
|
-
1. **Audit current pricing**: Tiers, features per tier, price points
|
|
57
|
-
2. **Analyze value alignment**: Does pricing match perceived value?
|
|
58
|
-
3. **Identify friction**: Where do users hesitate to pay?
|
|
59
|
-
4. **Explore models**: Subscription, usage-based, hybrid, freemium
|
|
60
|
-
|
|
61
|
-
### Areas to Explore
|
|
62
|
-
|
|
63
|
-
* **Tier differentiation**: Are tiers clearly differentiated? Is there a "trapped middle"?
|
|
64
|
-
* **Feature gating**: Are the right features gated? Too much in free? Too little?
|
|
65
|
-
* **Price anchoring**: Is there a decoy tier? Is the recommended tier obvious?
|
|
66
|
-
* **Trial optimization**: Is trial length optimal? What converts?
|
|
67
|
-
* **Upgrade triggers**: What signals readiness to upgrade? Are we acting on them?
|
|
68
|
-
* **Annual discounts**: Is annual pricing compelling enough?
|
|
69
|
-
* **Add-ons**: Are there features that should be add-ons rather than tier-gated?
|
|
70
|
-
* **Usage-based**: Would pay-per-use work for any features?
|
|
71
|
-
|
|
72
|
-
### Output Format
|
|
73
|
-
|
|
74
|
-
For each pricing opportunity:
|
|
75
|
-
```markdown
|
|
76
|
-
**Change**: [What to change]
|
|
77
|
-
**Rationale**: [Why this improves monetization]
|
|
78
|
-
**Expected Impact**: [Conversion? ARPU? Retention?]
|
|
79
|
-
**Risk**: [What could go wrong?]
|
|
80
|
-
**Test Plan**: [How to validate before full rollout]
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
## Competitive Research
|
|
84
|
-
|
|
85
|
-
### Process
|
|
86
|
-
|
|
87
|
-
1. **Identify competitors**: Direct and indirect (alternative solutions)
|
|
88
|
-
2. **Analyze features**: What do they have that we don't?
|
|
89
|
-
3. **Analyze pricing**: How do they package and price?
|
|
90
|
-
4. **Analyze UX**: What do they do better? Worse?
|
|
91
|
-
5. **Synthesize insights**: What should we adopt? Avoid? Differentiate on?
|
|
92
|
-
|
|
93
|
-
### Areas to Explore
|
|
94
|
-
|
|
95
|
-
* **Feature parity**: What table-stakes features are we missing?
|
|
96
|
-
* **Differentiation**: What do we do uniquely well? How to amplify?
|
|
97
|
-
* **Pricing position**: Are we premium, mid-market, or budget? Is that intentional?
|
|
98
|
-
* **UX patterns**: What onboarding/guidance patterns work well elsewhere?
|
|
99
|
-
* **Growth tactics**: How do competitors acquire and retain users?
|
|
100
|
-
* **Market gaps**: What's everyone missing that we could own?
|
|
101
|
-
|
|
102
|
-
### Output Format
|
|
103
|
-
|
|
104
|
-
For each competitive insight:
|
|
105
|
-
```markdown
|
|
106
|
-
**Competitor**: [Name]
|
|
107
|
-
**Observation**: [What we learned]
|
|
108
|
-
**Implication**: [What this means for us]
|
|
109
|
-
**Action**: [Specific recommendation]
|
|
110
|
-
**Priority**: [High/Medium/Low]
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## Synthesis
|
|
114
|
-
|
|
115
|
-
After exploring all areas, produce a prioritized roadmap:
|
|
116
|
-
|
|
117
|
-
### Immediate Wins (Do Now)
|
|
118
|
-
High impact + Low effort opportunities
|
|
119
|
-
|
|
120
|
-
### Strategic Investments (Plan Carefully)
|
|
121
|
-
High impact + High effort opportunities
|
|
122
|
-
|
|
123
|
-
### Quick Wins (When Available)
|
|
124
|
-
Low impact + Low effort opportunities
|
|
125
|
-
|
|
126
|
-
### Deprioritized (Defer/Skip)
|
|
127
|
-
Low impact + High effort — document why not pursuing
|
|
128
|
-
|
|
129
|
-
## Exit Criteria
|
|
130
|
-
|
|
131
|
-
* [ ] Feature gaps identified with acceptance criteria
|
|
132
|
-
* [ ] Pricing optimization opportunities documented
|
|
133
|
-
* [ ] Competitive landscape analyzed
|
|
134
|
-
* [ ] Prioritized roadmap produced
|
|
135
|
-
* [ ] All recommendations have testable success criteria
|
|
@@ -1,94 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-growth
|
|
3
|
-
description: SaaS growth review - onboarding, referral, retention, guidance
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Growth Systems Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review growth systems: onboarding flows, referral program, retention mechanics, viral/sharing features, and user guidance.
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Growth System Foundation
|
|
16
|
-
|
|
17
|
-
* The system must produce a coherent, measurable growth system for activation, sharing/virality, and retention, aligned with compliance and anti-abuse constraints.
|
|
18
|
-
|
|
19
|
-
### Onboarding
|
|
20
|
-
|
|
21
|
-
* Onboarding must be **outcome-oriented** (guide to first value, not just feature tour).
|
|
22
|
-
* Localized for all supported locales.
|
|
23
|
-
* Accessible (WCAG AA).
|
|
24
|
-
* Instrumented (track completion, drop-off points).
|
|
25
|
-
* Progressive disclosure — don't overwhelm new users.
|
|
26
|
-
|
|
27
|
-
### Sharing/Virality
|
|
28
|
-
|
|
29
|
-
* Sharing must be **consent-aware** (no spam, no dark patterns).
|
|
30
|
-
* Abuse-resistant with rate limiting and detection.
|
|
31
|
-
* Measurable end-to-end (share → click → signup → conversion).
|
|
32
|
-
* Platform-appropriate sharing (native share sheet on mobile, copy link on desktop).
|
|
33
|
-
|
|
34
|
-
### Retention
|
|
35
|
-
|
|
36
|
-
* Retention must be **intentionally engineered**, not accidental.
|
|
37
|
-
* Monitored with cohort analysis.
|
|
38
|
-
* Protected against regressions (alert on retention drops).
|
|
39
|
-
* Re-engagement flows (email, push) must be consent-governed.
|
|
40
|
-
|
|
41
|
-
### Referral Program (Anti-Abuse Baseline Required)
|
|
42
|
-
|
|
43
|
-
* Referral must be measurable, abuse-resistant, and governed:
|
|
44
|
-
* Clear attribution semantics (who referred whom, when)
|
|
45
|
-
* Reward lifecycle governance (pending → approved → paid, including revocation/clawbacks)
|
|
46
|
-
* Anti-fraud measures
|
|
47
|
-
* Admin reporting and audit capabilities
|
|
48
|
-
* Localized and instrumented
|
|
49
|
-
|
|
50
|
-
* **Referral anti-fraud minimum baseline is mandatory**:
|
|
51
|
-
* Define minimum set of risk signals and enforcement measures
|
|
52
|
-
* Velocity controls (rate limiting referrals)
|
|
53
|
-
* Account/device linkage posture (detect self-referral)
|
|
54
|
-
* Risk-tiered enforcement (high-risk delays, low-risk instant)
|
|
55
|
-
* Reward delay/hold/freeze capabilities
|
|
56
|
-
* Clawback conditions clearly defined
|
|
57
|
-
* Auditable manual review/appeal posture where applicable
|
|
58
|
-
|
|
59
|
-
### Support and Communications
|
|
60
|
-
|
|
61
|
-
* Support/Contact surface must be discoverable, localized, WCAG AA, SEO-complete, privacy-safe, and auditable where relevant.
|
|
62
|
-
* Newsletter subscription/preferences must be consent-aware; unsubscribe enforcement must be reliable and immediate.
|
|
63
|
-
|
|
64
|
-
### Admin Platform (Growth-Related)
|
|
65
|
-
|
|
66
|
-
* **Admin analytics and reporting are mandatory**:
|
|
67
|
-
* Comprehensive dashboards/reports for business, growth, billing, referral, support, and security/abuse signals
|
|
68
|
-
* Governed by RBAC
|
|
69
|
-
* Reporting must be consistent with system-of-record truth and auditable
|
|
70
|
-
|
|
71
|
-
## Domain Discovery
|
|
72
|
-
|
|
73
|
-
After reviewing compliance with spec, explore improvements:
|
|
74
|
-
|
|
75
|
-
* **Activation optimization**: What's the "aha moment"? How fast do users reach it? What's blocking them?
|
|
76
|
-
* **Viral loops**: Are there natural sharing moments? Can product usage generate invites?
|
|
77
|
-
* **Retention hooks**: What brings users back? Email? Push? In-app value?
|
|
78
|
-
* **Referral improvements**: Is the reward compelling? Is sharing frictionless? What's the k-factor?
|
|
79
|
-
* **Churn analysis**: Why do users leave? Exit surveys? Behavioral patterns before churn?
|
|
80
|
-
* **Expansion revenue**: Are there upsell opportunities? Usage-based triggers?
|
|
81
|
-
|
|
82
|
-
## Domain Gates
|
|
83
|
-
|
|
84
|
-
* [ ] Onboarding tracks completion and drop-off
|
|
85
|
-
* [ ] Onboarding is localized and accessible
|
|
86
|
-
* [ ] Sharing respects consent and has rate limits
|
|
87
|
-
* [ ] Sharing is measurable end-to-end
|
|
88
|
-
* [ ] Retention cohorts are tracked
|
|
89
|
-
* [ ] Retention regression alerts exist
|
|
90
|
-
* [ ] Referral attribution is accurate
|
|
91
|
-
* [ ] Referral has anti-fraud controls
|
|
92
|
-
* [ ] Reward lifecycle is auditable
|
|
93
|
-
* [ ] Support surface is discoverable and localized
|
|
94
|
-
* [ ] Newsletter unsubscribe works immediately
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-i18n
|
|
3
|
-
description: SaaS internationalization review - locales, routing, canonicalization, hreflang
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Internationalization & Routing Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review internationalization systems: locale support, URL routing strategy, canonicalization, hreflang implementation, and UGC handling across languages.
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Supported Locales
|
|
16
|
-
|
|
17
|
-
`en`, `zh-Hans`, `zh-Hant`, `es`, `ja`, `ko`, `de`, `fr`, `pt-BR`, `it`, `nl`, `pl`, `tr`, `id`, `th`, `vi`
|
|
18
|
-
|
|
19
|
-
### URL Strategy: Prefix Except Default
|
|
20
|
-
|
|
21
|
-
* English is default and **non-prefixed**.
|
|
22
|
-
* `/en/*` must **not exist**; permanently redirect to non-prefixed equivalent.
|
|
23
|
-
* All non-default locales are `/<locale>/...`.
|
|
24
|
-
|
|
25
|
-
### Globalization Rules
|
|
26
|
-
|
|
27
|
-
* Use Intl APIs for formatting (dates, numbers, currencies).
|
|
28
|
-
* Explicit fallback rules for missing translations.
|
|
29
|
-
* **Missing translation keys must fail build** — no silent fallbacks in production.
|
|
30
|
-
* No hardcoded user-facing strings outside localization system.
|
|
31
|
-
|
|
32
|
-
### UGC Canonicalization
|
|
33
|
-
|
|
34
|
-
* Separate UI language from content language.
|
|
35
|
-
* Exactly one canonical URL per UGC resource determined by content language.
|
|
36
|
-
* No indexable locale-prefixed duplicates unless primary content is truly localized; otherwise redirect to canonical.
|
|
37
|
-
* Canonical/hreflang/sitemap must reflect only true localized variants.
|
|
38
|
-
|
|
39
|
-
### SEO Requirements
|
|
40
|
-
|
|
41
|
-
* `hreflang` tags with `x-default` pointing to non-prefixed (English) version.
|
|
42
|
-
* `sitemap.xml` containing only true localized variants.
|
|
43
|
-
* Canonical URLs properly set per page.
|
|
44
|
-
* No duplicate content across locale paths.
|
|
45
|
-
|
|
46
|
-
## Domain Discovery
|
|
47
|
-
|
|
48
|
-
After reviewing compliance with spec, explore improvements:
|
|
49
|
-
|
|
50
|
-
* **Market expansion**: Are high-value markets missing? (e.g., Arabic RTL, Hindi)
|
|
51
|
-
* **Translation quality**: Are translations professional or machine-generated? User complaints?
|
|
52
|
-
* **Locale detection**: Is auto-detection helpful or annoying? Is manual switching easy?
|
|
53
|
-
* **Regional pricing**: Does i18n support regional pricing display? Currency localization?
|
|
54
|
-
* **Legal localization**: Are terms/privacy properly localized per jurisdiction?
|
|
55
|
-
* **Date/time handling**: Timezone-aware displays? User preference respected?
|
|
56
|
-
|
|
57
|
-
## Domain Gates
|
|
58
|
-
|
|
59
|
-
* [ ] All supported locales have complete translations
|
|
60
|
-
* [ ] `/en/*` returns 301 redirect to non-prefixed
|
|
61
|
-
* [ ] Missing translation keys fail build
|
|
62
|
-
* [ ] hreflang tags present and correct
|
|
63
|
-
* [ ] x-default points to non-prefixed version
|
|
64
|
-
* [ ] Sitemap contains only true localized pages
|
|
65
|
-
* [ ] UGC has single canonical URL per content
|
|
66
|
-
* [ ] No hardcoded strings in components
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: saas-platform
|
|
3
|
-
description: SaaS frontend review - design system, SEO, PWA, performance, accessibility
|
|
4
|
-
agent: coder
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Frontend & Platform Review
|
|
8
|
-
|
|
9
|
-
## Scope
|
|
10
|
-
|
|
11
|
-
Review frontend systems: design system, SEO implementation, PWA capabilities, performance optimization, and accessibility compliance.
|
|
12
|
-
|
|
13
|
-
## Specification
|
|
14
|
-
|
|
15
|
-
### Design System & UX
|
|
16
|
-
|
|
17
|
-
* Design-system driven UI (tokens for colors, spacing, typography).
|
|
18
|
-
* Dark/light theme support with user preference persistence.
|
|
19
|
-
* **WCAG AA** accessibility compliance.
|
|
20
|
-
* CLS-safe (no layout shift).
|
|
21
|
-
* **Mobile-first** responsive design; desktop-second.
|
|
22
|
-
* Iconify for icons; no emoji in UI content.
|
|
23
|
-
|
|
24
|
-
### SEO Requirements
|
|
25
|
-
|
|
26
|
-
* **SEO-first + SSR-first** for indexable/discovery pages.
|
|
27
|
-
* Required metadata:
|
|
28
|
-
* Title and description (unique per page)
|
|
29
|
-
* Open Graph tags (og:title, og:description, og:image)
|
|
30
|
-
* Favicon (multiple sizes)
|
|
31
|
-
* Canonical URL
|
|
32
|
-
* robots meta tag
|
|
33
|
-
* `schema.org` structured data where applicable.
|
|
34
|
-
* `sitemap.xml` (auto-generated, up-to-date).
|
|
35
|
-
* `robots.txt` properly configured.
|
|
36
|
-
|
|
37
|
-
### PWA Capabilities
|
|
38
|
-
|
|
39
|
-
* Web app manifest with proper icons and theme colors.
|
|
40
|
-
* Service worker with explicit cache correctness.
|
|
41
|
-
* Push notifications using VAPID where applicable.
|
|
42
|
-
* **Service Worker caching boundary is mandatory**: service worker must not cache personalized/sensitive/authorized content.
|
|
43
|
-
* Authenticated and entitlement-sensitive routes must have explicit cache-control and SW rules.
|
|
44
|
-
* SW caching boundaries must be validated by tests to prevent stale or unauthorized state exposure.
|
|
45
|
-
|
|
46
|
-
### Performance
|
|
47
|
-
|
|
48
|
-
* Performance must be **measurable and regression-resistant**:
|
|
49
|
-
* Define and enforce performance budgets for key journeys
|
|
50
|
-
* Define caching boundaries and correctness requirements across SSR/ISR/static and service worker behavior
|
|
51
|
-
* Monitor Core Web Vitals and server latency; alert on regressions
|
|
52
|
-
* Target metrics:
|
|
53
|
-
* LCP < 2.5s
|
|
54
|
-
* FID < 100ms
|
|
55
|
-
* CLS < 0.1
|
|
56
|
-
* TTFB < 600ms
|
|
57
|
-
|
|
58
|
-
### Guidance System
|
|
59
|
-
|
|
60
|
-
* Guidance is mandatory for all user-facing features and monetization flows.
|
|
61
|
-
* Must be: discoverable, clear, dismissible with re-entry option.
|
|
62
|
-
* Localized and measurable (track engagement).
|
|
63
|
-
* Governed by eligibility and frequency controls.
|
|
64
|
-
|
|
65
|
-
## Domain Discovery
|
|
66
|
-
|
|
67
|
-
After reviewing compliance with spec, explore improvements:
|
|
68
|
-
|
|
69
|
-
* **Performance wins**: Are there obvious bundle size reductions? Lazy loading opportunities? Image optimization?
|
|
70
|
-
* **SEO gaps**: Missing structured data? Pages not indexed? Slow crawl rate?
|
|
71
|
-
* **PWA enhancement**: Is offline experience meaningful? Are push notifications valuable?
|
|
72
|
-
* **Accessibility**: Beyond AA compliance, are there UX improvements for assistive tech?
|
|
73
|
-
* **Design consistency**: Are there inconsistencies in the design system usage? Rogue styles?
|
|
74
|
-
* **Mobile experience**: Is mobile-first truly implemented? Touch targets adequate?
|
|
75
|
-
|
|
76
|
-
## Domain Gates
|
|
77
|
-
|
|
78
|
-
* [ ] Design tokens used consistently (no hardcoded values)
|
|
79
|
-
* [ ] Dark/light theme works correctly
|
|
80
|
-
* [ ] WCAG AA compliance verified
|
|
81
|
-
* [ ] All pages have unique title/description/OG tags
|
|
82
|
-
* [ ] Sitemap.xml exists and is current
|
|
83
|
-
* [ ] Schema.org markup present
|
|
84
|
-
* [ ] Service worker doesn't cache authenticated content
|
|
85
|
-
* [ ] Core Web Vitals within targets
|
|
86
|
-
* [ ] Performance budgets defined and enforced
|
|
87
|
-
* [ ] Guidance system implemented for key flows
|