arkaos 2.58.0 → 2.60.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/VERSION CHANGED
@@ -1 +1 @@
1
- 2.58.0
1
+ 2.60.0
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: ecom/product-launch
3
3
  description: >
4
- Product launch plan: pre-launch, launch day, post-launch with marketing sync.
4
+ E-commerce product launch plan positioning + pricing ladder + content
5
+ assets + channel mix + ad creative + day-by-day launch sequence + post-
6
+ launch optimisation triggers.
5
7
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
8
  ---
7
9
 
@@ -21,12 +23,169 @@ does not replace the vault.
21
23
 
22
24
  # Product Launch — `/ecom launch <product>`
23
25
 
24
- > **Agent:** Ricardo (E-Commerce Director) | **Framework:** Product Launch Plan + GTM
26
+ > **Lead:** Ricardo (E-Commerce Director) | **Cross-dept:** Mateus (Brand) + Helena (CFO) + Luna (Marketing) + Pedro (Paid) + Isabel (Visual) + Eduardo (Copy) | **Framework:** GTM × Launch Sequence + Inventory-Aware Demand Curve
25
27
 
26
- ## What It Does
28
+ ## What ships
27
29
 
28
- Product launch plan: pre-launch, launch day, post-launch with marketing sync.
30
+ A production launch package in 7 deliverables:
29
31
 
30
- ## Output
32
+ 1. **Positioning** — competitive set + onlyness frame + price tier
33
+ 2. **Pricing ladder** — anchor + main + promo + bundle with margin math per tier
34
+ 3. **Content assets** — product page + photo brief + video brief + email + social copy
35
+ 4. **Channel mix** — owned + marketplace + paid + organic + partnerships per priority
36
+ 5. **Ad creative plan** — static + video + UGC + retargeting per channel
37
+ 6. **Day-by-day launch sequence** — soft launch through post-launch optimisation
38
+ 7. **Executive summary** — 1-page printable with sales target + kill-switch criterion
31
39
 
32
- Launch plan with timeline, channel activation, and success metrics
40
+ ## Positioning Frame (e-commerce specific)
41
+
42
+ Position the SKU on three axes simultaneously:
43
+
44
+ 1. **Competitive set** — name 3-5 directly competing SKUs across price tiers
45
+ 2. **Differentiation angle** — what's the one thing this SKU does that the competitive set doesn't
46
+ 3. **Price tier** — entry / mid / premium / luxury with explicit anchor comparison
47
+
48
+ Format:
49
+ ```yaml
50
+ positioning:
51
+ category: <product category>
52
+ competitive_set: [<SKU 1>, <SKU 2>, <SKU 3>]
53
+ onlyness: "The only <category> that <unique mechanism> for <customer> who want <outcome>"
54
+ price_tier: entry | mid | premium | luxury
55
+ anchor_competitor: <SKU we benchmark against>
56
+ anchor_price: <competitor price>
57
+ our_price: <price + delta vs anchor + rationale>
58
+ ```
59
+
60
+ ## Pricing Ladder
61
+
62
+ Every launch ships with a 4-tier pricing ladder, not a single price:
63
+
64
+ | Tier | Use | Margin floor | When to show |
65
+ |---|---|---|---|
66
+ | **Anchor** | Shown crossed-out to anchor perception | n/a (decorative) | First view |
67
+ | **Main** | Default offer | Gross margin ≥ category benchmark | Default state |
68
+ | **Promo** | Limited-time deal (launch week, holiday) | Gross margin ≥ 60% of main | Launch week + scarcity moments |
69
+ | **Bundle** | Multi-SKU or main + accessory | Combined margin ≥ main × 1.3 | Cart upsell |
70
+
71
+ Margin math must close at every tier. Promo prices that don't cover variable costs are not promos — they're losses.
72
+
73
+ ## Content Asset Inventory
74
+
75
+ Required assets per launch:
76
+
77
+ ```yaml
78
+ content_assets:
79
+ product_page:
80
+ - hero_image: 1
81
+ - lifestyle_images: 3-5
82
+ - detail_shots: 3-5
83
+ - video: 15-30s
84
+ - bullets: 5-7
85
+ - long_description: 200-400 words
86
+ - faq: 5-8 questions
87
+
88
+ email:
89
+ - launch_announcement: 1
90
+ - reminder_24h_before: 1
91
+ - launch_day: 1
92
+ - day_3_social_proof: 1
93
+ - day_7_last_chance: 1
94
+
95
+ social:
96
+ - announcement_post: 3-5 platforms × 1 format
97
+ - launch_day_post: 3-5 platforms × 1 format
98
+ - countdown_stories: 3-7 days
99
+
100
+ ad_creative:
101
+ - static_image: 5-10 variants
102
+ - video_15s: 3-5 variants
103
+ - video_30s: 2-3 variants
104
+ - ugc_request_brief: 1
105
+ ```
106
+
107
+ ## Channel Mix Priority
108
+
109
+ Channel ramp follows a deliberate sequence. Day-0 is not "everywhere at once" — it's a controlled wedge.
110
+
111
+ | Priority | Day 0 | Week 1 | Month 1 | Why this order |
112
+ |---|---|---|---|---|
113
+ | 1 | Email list (warm) | Email + retargeting | Email + retargeting + organic | Warmest audience first, validates demand signal |
114
+ | 2 | Direct traffic + organic | Direct + organic + meta paid | Add marketplace listing | Earned reach before paid |
115
+ | 3 | Marketplace listing | Paid scale-up | TikTok / influencer | Paid only after CR validated |
116
+ | 4 | Influencer outreach | Influencer publishes | Affiliate program | Third-party signal once core demand proven |
117
+
118
+ Skipping the warm-audience-first step burns paid spend on uninformed buyers and produces unstable CR baselines.
119
+
120
+ ## Day-by-Day Launch Sequence Template
121
+
122
+ ```
123
+ T-30 Inventory commit + content brief signed off
124
+ T-21 Photo + video shoot
125
+ T-14 Product page in staging
126
+ T-7 Email warm-up (#1 sent — "something's coming")
127
+ T-3 Email reminder (#2 sent — date + sneak peek)
128
+ T-0 LAUNCH:
129
+ 06:00 — Product page live
130
+ 08:00 — Email blast to full list
131
+ 10:00 — Social announcement (all platforms)
132
+ 12:00 — First-hour analytics check (CR, AOV, traffic)
133
+ 14:00 — Retargeting ads live (only if signal positive)
134
+ 16:00 — Live-stream / Q&A if applicable
135
+ 20:00 — End-of-day metrics review + decision: continue ramp or pause
136
+ T+1 Day-2 email + paid ramp decision
137
+ T+3 Social proof email (real customer reactions)
138
+ T+7 "Last chance for launch pricing" email
139
+ T+8 Move to evergreen pricing
140
+ T+14 Post-launch retrospective + decision (scale / iterate / kill)
141
+ ```
142
+
143
+ Each step has a named owner and a success criterion. The "decision: continue ramp or pause" gate at T+0 evening is the load-bearing one — preventing wasted paid spend on a dud.
144
+
145
+ ## Inventory-Aware Demand Curve
146
+
147
+ Match channel ramp to inventory levels:
148
+
149
+ ```yaml
150
+ inventory_demand_curve:
151
+ units_in_stock: <N>
152
+ base_sales_velocity: <units per day at baseline>
153
+ launch_uplift_factor: 5-15x baseline typical
154
+ days_of_stock_at_launch_velocity: <calculated>
155
+
156
+ scenarios:
157
+ sold_out_before_day_3:
158
+ action: "Throttle paid spend immediately, switch promo to 'next batch' positioning"
159
+ pre_emptive: "Set inventory alert at 30% stock; cap ad spend automatically"
160
+ sold_out_between_day_3_and_day_7:
161
+ action: "Pause paid Day 4, reactivate when restock confirmed"
162
+ pre_emptive: "Pre-order option live by Day 3 if velocity > 2x projection"
163
+ sells_through_below_projection:
164
+ action: "Switch to discovery-mode messaging, increase retargeting frequency"
165
+ pre_emptive: "Have 'discovery angle 2' copy variant pre-approved for fast swap"
166
+ ```
167
+
168
+ Launches that ignore inventory produce either backorder customer-experience disasters or markdown-spiral losses.
169
+
170
+ ## Kill-Switch Criteria (named upfront)
171
+
172
+ Every launch ships with explicit kill criteria — if any fires, stop spending paid budget:
173
+
174
+ - Day-0 CR < 50% of category benchmark
175
+ - Day-3 cumulative AOV < 80% of projected
176
+ - Day-7 return rate > 2× category baseline
177
+ - Day-7 negative-review-to-purchase ratio > category baseline
178
+
179
+ Kill-switch criteria stated upfront prevent the "let's just spend more to make it work" trap.
180
+
181
+ ## Common Failure Modes
182
+
183
+ 1. **Single-price launch** — no ladder, leaves margin on the table and removes promo lever
184
+ 2. **Channel-everywhere day-0** — burns paid spend before CR signal is validated
185
+ 3. **Inventory-blind ramp** — sells out at peak demand or markdowns at post-peak slump
186
+ 4. **No kill-switch** — bad launches drag on consuming budget without falsification path
187
+ 5. **Asset shortage** — running launch with incomplete photo/video set produces below-benchmark CR
188
+
189
+ ## Output → Obsidian: `WizardingCode/Ecom/Launches/<product>-<date>/`
190
+
191
+ Delivers: positioning + pricing ladder (margin math per tier) + content asset inventory + channel mix priority + day-by-day launch sequence + ad creative plan + inventory-aware demand curve + kill-switch criteria + 1-page executive summary.
@@ -0,0 +1,130 @@
1
+ id: ecom-audit
2
+ name: Store Audit
3
+ description: Full e-commerce store audit — UX + SEO + performance + content + conversion — with ranked remediation plan
4
+ department: ecom
5
+ tier: enterprise
6
+ command: "/ecom audit"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Audit Brief
14
+ description: Define store URL, vertical, audience, primary KPI, scope of audit
15
+ agents:
16
+ - agent_id: ecom-director-ricardo
17
+ role: Frame store, vertical, baseline KPIs (conversion rate, AOV, traffic mix)
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms audit scope and baseline KPIs
21
+
22
+ - id: ux-audit
23
+ name: UX Audit (Baymard + Nielsen)
24
+ description: Baymard 76-criteria checklist + Nielsen 10 heuristics audit on key flows
25
+ agents:
26
+ - agent_id: ux-designer-sofia-d
27
+ role: UX audit with criteria-level scoring per key flow (homepage / category / PDP / cart / checkout)
28
+ gate:
29
+ type: user_approval
30
+ description: User approves UX audit
31
+ outputs:
32
+ - type: document
33
+ format: markdown
34
+ obsidian_path: "WizardingCode/Ecom/Audits/UX/"
35
+ description: UX audit with Baymard + Nielsen scores per flow
36
+
37
+ - id: seo-audit
38
+ name: SEO Audit
39
+ description: Technical SEO + on-page + content audit
40
+ agents:
41
+ - agent_id: seo-specialist-ana
42
+ role: Technical SEO (Core Web Vitals + crawl + index + schema) + on-page audit (title + meta + content + internal links)
43
+ gate:
44
+ type: user_approval
45
+ description: User approves SEO audit
46
+
47
+ - id: performance-audit
48
+ name: Performance Audit
49
+ description: Core Web Vitals + page weight + render path + mobile performance
50
+ agents:
51
+ - agent_id: ux-designer-sofia-d
52
+ role: Performance audit with LCP/INP/CLS + page weight + render-blocking analysis per key flow
53
+ gate:
54
+ type: user_approval
55
+ description: User approves performance audit
56
+
57
+ - id: content-audit
58
+ name: Content Audit
59
+ description: Product copy + category copy + about + policies + brand voice consistency
60
+ agents:
61
+ - agent_id: copy-director-eduardo
62
+ role: Content audit with brand voice consistency check + copy quality scoring
63
+ gate:
64
+ type: user_approval
65
+ description: User approves content audit
66
+
67
+ - id: conversion-audit
68
+ name: Conversion Audit
69
+ description: ResearchXL framework — heuristic + quantitative + qualitative + technical
70
+ agents:
71
+ - agent_id: conversion-strategist-ines
72
+ role: ResearchXL audit across all 4 dimensions, identifies top 10 conversion friction points
73
+ gate:
74
+ type: user_approval
75
+ description: User approves conversion audit
76
+ outputs:
77
+ - type: document
78
+ format: markdown
79
+ obsidian_path: "WizardingCode/Ecom/Audits/Conversion/"
80
+ description: ResearchXL conversion audit with top 10 friction points
81
+
82
+ - id: ranked-remediation
83
+ name: Ranked Remediation Plan
84
+ description: ICE prioritisation of all findings across UX + SEO + Performance + Content + Conversion
85
+ agents:
86
+ - agent_id: ecom-director-ricardo
87
+ role: ICE scoring per finding, ranked remediation plan with effort estimates
88
+ gate:
89
+ type: user_approval
90
+ description: User approves ranked remediation
91
+
92
+ - id: self-critique
93
+ name: Self-Critique
94
+ description: Stress-test the audit — is every finding evidence-backed? Are remediations sized correctly?
95
+ agents:
96
+ - agent_id: ecom-director-ricardo
97
+ role: Audit coherence + remediation feasibility check
98
+ gate:
99
+ type: auto
100
+
101
+ - id: quality-gate
102
+ name: Quality Gate
103
+ model_override: opus
104
+ description: Mandatory quality review
105
+ agents:
106
+ - agent_id: cqo-marta
107
+ role: Orchestrate quality review
108
+ - agent_id: copy-director-eduardo
109
+ role: Audit prose, scoring rationale clarity, no clichés
110
+ parallel: true
111
+ - agent_id: tech-director-francisca
112
+ role: Technical findings accuracy, scoring math, prioritisation rigour
113
+ parallel: true
114
+ gate:
115
+ type: quality_gate
116
+ required_verdict: APPROVED
117
+
118
+ - id: delivery
119
+ name: Audit Report Delivery
120
+ description: Compile full audit + executive summary + 30-day quick-win plan + 90-day strategic plan
121
+ agents:
122
+ - agent_id: ecom-director-ricardo
123
+ role: Full audit report + executive summary + 30/90-day plans
124
+ gate:
125
+ type: auto
126
+ outputs:
127
+ - type: document
128
+ format: markdown
129
+ obsidian_path: "WizardingCode/Ecom/Audits/"
130
+ description: Complete store audit — UX + SEO + Performance + Content + Conversion + ranked remediation + 30-day + 90-day plans + exec summary
@@ -0,0 +1,137 @@
1
+ id: ecom-launch
2
+ name: Product Launch (E-commerce)
3
+ description: Product launch plan for an e-commerce SKU or collection — positioning + pricing + content + distribution + ad creative + post-launch optimisation
4
+ department: ecom
5
+ tier: enterprise
6
+ command: "/ecom launch"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Launch Brief
14
+ description: Define product, target customer, launch date, sales target, budget, inventory commit
15
+ agents:
16
+ - agent_id: ecom-director-ricardo
17
+ role: Frame product, target customer, launch date, sales target, budget
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms product brief and launch parameters
21
+
22
+ - id: positioning
23
+ name: Product Positioning
24
+ description: Position the SKU — competitive set, differentiation angle, price tier
25
+ agents:
26
+ - agent_id: ecom-director-ricardo
27
+ role: Positioning statement + competitive set + price tier
28
+ - agent_id: brand-strategist-mateus
29
+ role: Brand-relative positioning + onlyness frame
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves positioning
34
+
35
+ - id: pricing-strategy
36
+ name: Pricing Strategy
37
+ description: Price ladder — anchor + main + promo + bundle. Margin math per tier.
38
+ agents:
39
+ - agent_id: ecom-director-ricardo
40
+ role: Price ladder with margin per tier
41
+ - agent_id: cfo-helena
42
+ role: Margin floor + promo economics check
43
+ parallel: true
44
+ gate:
45
+ type: user_approval
46
+ description: User approves pricing strategy
47
+
48
+ - id: content-assets
49
+ name: Content Assets
50
+ description: Product page copy + photography brief + video brief + email copy + social copy
51
+ agents:
52
+ - agent_id: ecom-director-ricardo
53
+ role: Content asset inventory with delivery dates
54
+ - agent_id: copy-director-eduardo
55
+ role: Product page + email + social copy
56
+ parallel: true
57
+ - agent_id: visual-designer-isabel
58
+ role: Photography + video brief specs
59
+ parallel: true
60
+ gate:
61
+ type: user_approval
62
+ description: User approves content assets
63
+
64
+ - id: distribution-channels
65
+ name: Distribution Channels
66
+ description: Channel mix — owned channels + marketplace + paid + organic + partnerships
67
+ agents:
68
+ - agent_id: ecom-director-ricardo
69
+ role: Channel mix with day-0 / week-1 / month-1 priorities
70
+ - agent_id: marketing-director-luna
71
+ role: Paid + organic channel allocation
72
+ parallel: true
73
+ gate:
74
+ type: user_approval
75
+ description: User approves channel mix
76
+
77
+ - id: ad-creative
78
+ name: Ad Creative Plan
79
+ description: Ad creative across formats — static + video + UGC + retargeting
80
+ agents:
81
+ - agent_id: paid-specialist-pedro
82
+ role: Ad creative plan with format × channel matrix
83
+ - agent_id: visual-designer-isabel
84
+ role: Creative brief per format
85
+ parallel: true
86
+ gate:
87
+ type: auto
88
+
89
+ - id: launch-sequence
90
+ name: Launch Sequence
91
+ description: Day-by-day sequence — soft launch, hard launch, post-launch optimisation triggers
92
+ agents:
93
+ - agent_id: ecom-director-ricardo
94
+ role: Day-by-day launch sequence with daily success criteria
95
+ gate:
96
+ type: user_approval
97
+ description: User approves launch sequence
98
+
99
+ - id: self-critique
100
+ name: Self-Critique
101
+ description: Stress-test the launch — does inventory match demand projection? Are channel ramp curves realistic? Is the kill-switch criterion clear?
102
+ agents:
103
+ - agent_id: ecom-director-ricardo
104
+ role: Launch coherence + inventory + ramp curve check
105
+ gate:
106
+ type: auto
107
+
108
+ - id: quality-gate
109
+ name: Quality Gate
110
+ model_override: opus
111
+ description: Mandatory quality review
112
+ agents:
113
+ - agent_id: cqo-marta
114
+ role: Orchestrate quality review
115
+ - agent_id: copy-director-eduardo
116
+ role: All copy quality + no over-promise + no AI clichés
117
+ parallel: true
118
+ - agent_id: tech-director-francisca
119
+ role: Tracking + inventory + channel-tech integrity
120
+ parallel: true
121
+ gate:
122
+ type: quality_gate
123
+ required_verdict: APPROVED
124
+
125
+ - id: delivery
126
+ name: Launch Package Delivery
127
+ description: Compile the launch package — positioning + pricing + content + channels + ads + sequence + analytics + executive summary
128
+ agents:
129
+ - agent_id: ecom-director-ricardo
130
+ role: Full launch package + executive summary
131
+ gate:
132
+ type: auto
133
+ outputs:
134
+ - type: document
135
+ format: markdown
136
+ obsidian_path: "WizardingCode/Ecom/Launches/"
137
+ description: Complete launch package — positioning + pricing + content + distribution + ad creative + launch sequence + exec summary
@@ -0,0 +1,139 @@
1
+ id: ecom-marketplace
2
+ name: Marketplace Operations
3
+ description: Marketplace operations setup or optimization (Mirakl, multi-vendor, Amazon/Shopify) — catalog + onboarding + orders + payments + analytics
4
+ department: ecom
5
+ tier: enterprise
6
+ command: "/ecom marketplace"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Marketplace Brief
14
+ description: Define marketplace type (operator vs participant), platform, vendor scale target, vertical
15
+ agents:
16
+ - agent_id: ecom-director-ricardo
17
+ role: Frame marketplace type, platform, vendor scale, vertical
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms marketplace context
21
+
22
+ - id: governance-model
23
+ name: Governance Model
24
+ description: Define curated vs open, commission model, vendor approval criteria, content moderation
25
+ agents:
26
+ - agent_id: ecom-director-ricardo
27
+ role: Governance model with curation criteria + commission economics + moderation policy
28
+ - agent_id: strategy-director-tomas
29
+ role: Strategic positioning — vertical specialisation vs horizontal
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves governance model
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/Ecom/Marketplace/Governance/"
38
+ description: Governance model with curation + commission + moderation policies
39
+
40
+ - id: catalog-architecture
41
+ name: Catalog Architecture
42
+ description: Taxonomy, attribute schema, normalisation rules, deduplication strategy
43
+ agents:
44
+ - agent_id: ecom-director-ricardo
45
+ role: Taxonomy + attribute schema + dedup strategy
46
+ - agent_id: tech-director-francisca
47
+ role: Schema technical feasibility + ETL pipeline implications
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User approves catalog architecture
52
+
53
+ - id: vendor-onboarding
54
+ name: Vendor Onboarding Flow
55
+ description: Onboarding flow — application + verification + agreement + training + first-listing
56
+ agents:
57
+ - agent_id: ecom-director-ricardo
58
+ role: Onboarding flow with friction-vs-quality trade-off explicit
59
+ - agent_id: ux-designer-sofia-d
60
+ role: Onboarding UX with completion targets per step
61
+ parallel: true
62
+ gate:
63
+ type: user_approval
64
+ description: User approves onboarding flow
65
+
66
+ - id: order-fulfilment
67
+ name: Order & Fulfilment Flow
68
+ description: Order routing + fulfilment SLA + returns/refunds + dispute resolution
69
+ agents:
70
+ - agent_id: ecom-director-ricardo
71
+ role: Order flow design + SLA spec + dispute resolution policy
72
+ gate:
73
+ type: user_approval
74
+ description: User approves order/fulfilment flow
75
+
76
+ - id: payments-payouts
77
+ name: Payments & Payouts
78
+ description: Payment processing model + split-payment to vendors + escrow + chargeback handling
79
+ agents:
80
+ - agent_id: ecom-director-ricardo
81
+ role: Payment + payout model with chargeback handling policy
82
+ - agent_id: cfo-helena
83
+ role: Cash flow + escrow capital requirement check
84
+ parallel: true
85
+ gate:
86
+ type: user_approval
87
+ description: User approves payments model
88
+
89
+ - id: analytics-stack
90
+ name: Analytics Stack
91
+ description: Vendor-facing analytics + operator analytics + customer-facing trust signals
92
+ agents:
93
+ - agent_id: ecom-director-ricardo
94
+ role: Analytics layer with per-audience views
95
+ - agent_id: tech-director-francisca
96
+ role: Data pipeline feasibility
97
+ parallel: true
98
+ gate:
99
+ type: auto
100
+
101
+ - id: self-critique
102
+ name: Self-Critique
103
+ description: Stress-test the model — does governance scale? Is fulfilment SLA enforceable? Does the take-rate math close?
104
+ agents:
105
+ - agent_id: ecom-director-ricardo
106
+ role: Coherence + scalability + economics check
107
+ gate:
108
+ type: auto
109
+
110
+ - id: quality-gate
111
+ name: Quality Gate
112
+ model_override: opus
113
+ description: Mandatory quality review
114
+ agents:
115
+ - agent_id: cqo-marta
116
+ role: Orchestrate quality review
117
+ - agent_id: copy-director-eduardo
118
+ role: Policy prose, vendor-facing copy, no AI clichés
119
+ parallel: true
120
+ - agent_id: tech-director-francisca
121
+ role: Schema integrity, pipeline feasibility, payment model correctness
122
+ parallel: true
123
+ gate:
124
+ type: quality_gate
125
+ required_verdict: APPROVED
126
+
127
+ - id: delivery
128
+ name: Marketplace Package Delivery
129
+ description: Compile the marketplace package + 90-day launch roadmap if greenfield, or 90-day optimisation roadmap if existing
130
+ agents:
131
+ - agent_id: ecom-director-ricardo
132
+ role: Full marketplace package + 90-day roadmap
133
+ gate:
134
+ type: auto
135
+ outputs:
136
+ - type: document
137
+ format: markdown
138
+ obsidian_path: "WizardingCode/Ecom/Marketplace/"
139
+ description: Complete marketplace package — governance + catalog + onboarding + order flow + payments + analytics + 90-day roadmap
@@ -0,0 +1,140 @@
1
+ id: saas-growth
2
+ name: SaaS Growth Plan
3
+ description: Stage-specific growth plan (seed / Series A / scale) with stage-appropriate metrics, channels, team allocation
4
+ department: saas
5
+ tier: enterprise
6
+ command: "/saas growth"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Growth Brief
14
+ description: Define current stage, ARR, growth rate, runway, target stage end-state
15
+ agents:
16
+ - agent_id: saas-strategist-tiago
17
+ role: Frame current stage, ARR, growth rate, runway, end-state
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms stage context and target
21
+
22
+ - id: stage-diagnosis
23
+ name: Stage Diagnosis
24
+ description: Diagnose where the SaaS actually is (vs claims) — seed (PMF search), Series A (PMF + scale prep), scale (efficient growth)
25
+ agents:
26
+ - agent_id: saas-strategist-tiago
27
+ role: Stage diagnosis with evidence (PMF signals, expansion math, sales motion maturity)
28
+ - agent_id: strategy-director-tomas
29
+ role: Strategic context — category position, competitive intensity
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves stage diagnosis
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/SaaS/Growth/Diagnosis/"
38
+ description: Stage diagnosis with PMF evidence and stage-shift criteria
39
+
40
+ - id: stage-metrics
41
+ name: Stage-Appropriate Metrics
42
+ description: Define the 3-5 metrics that matter at THIS stage (different per stage)
43
+ agents:
44
+ - agent_id: saas-strategist-tiago
45
+ role: Stage-specific metric set with target per metric
46
+ - agent_id: cfo-helena
47
+ role: Financial metric integration (Magic Number, Net Burn Multiple, CAC payback)
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User approves metric set
52
+
53
+ - id: motion-channel-fit
54
+ name: Motion × Channel Fit (Stage-Adjusted)
55
+ description: Pick GTM motion + channels appropriate to stage (seed = focused, A = scaled-up, scale = portfolio)
56
+ agents:
57
+ - agent_id: saas-strategist-tiago
58
+ role: Motion + channel selection with stage rationale
59
+ - agent_id: marketing-director-luna
60
+ role: Channel-feasibility validation
61
+ parallel: true
62
+ gate:
63
+ type: user_approval
64
+ description: User approves motion + channels
65
+
66
+ - id: team-allocation
67
+ name: Team Allocation
68
+ description: How team headcount maps to the growth plan — first hires per stage, when to hire what
69
+ agents:
70
+ - agent_id: saas-strategist-tiago
71
+ role: Team allocation with hire-when-X triggers
72
+ - agent_id: coo-sofia
73
+ role: Org design — when to add second-line management
74
+ parallel: true
75
+ gate:
76
+ type: user_approval
77
+ description: User approves team allocation
78
+
79
+ - id: budget-runway
80
+ name: Budget × Runway
81
+ description: 12-month budget split across hire / paid / tools / experiments with runway impact
82
+ agents:
83
+ - agent_id: saas-strategist-tiago
84
+ role: Budget allocation with monthly burn
85
+ - agent_id: cfo-helena
86
+ role: Runway impact + worst-case scenario
87
+ parallel: true
88
+ gate:
89
+ type: user_approval
90
+ description: User approves budget × runway plan
91
+
92
+ - id: experiment-portfolio
93
+ name: 90-Day Experiment Portfolio
94
+ description: 3-5 prioritised experiments — hypothesis, success criteria, kill-switch date
95
+ agents:
96
+ - agent_id: saas-strategist-tiago
97
+ role: Experiment portfolio with hypothesis + MDE + kill date per experiment
98
+ gate:
99
+ type: user_approval
100
+ description: User approves experiment portfolio
101
+
102
+ - id: self-critique
103
+ name: Self-Critique
104
+ description: Stress-test the plan — does stage diagnosis support motion choice? Does budget × runway × team math close?
105
+ agents:
106
+ - agent_id: saas-strategist-tiago
107
+ role: Coherence check across stage / motion / team / budget / experiments
108
+ gate:
109
+ type: auto
110
+
111
+ - id: quality-gate
112
+ name: Quality Gate
113
+ model_override: opus
114
+ description: Mandatory quality review
115
+ agents:
116
+ - agent_id: cqo-marta
117
+ role: Orchestrate quality review
118
+ - agent_id: copy-director-eduardo
119
+ role: Plan prose, stage diagnosis defensibility, no clichés
120
+ parallel: true
121
+ - agent_id: tech-director-francisca
122
+ role: Metric math, budget math, instrumentation feasibility
123
+ parallel: true
124
+ gate:
125
+ type: quality_gate
126
+ required_verdict: APPROVED
127
+
128
+ - id: delivery
129
+ name: Growth Plan Delivery
130
+ description: Compile the growth plan + executive summary + monthly checkpoint cadence
131
+ agents:
132
+ - agent_id: saas-strategist-tiago
133
+ role: Full growth plan + executive summary + monthly checkpoint schedule
134
+ gate:
135
+ type: auto
136
+ outputs:
137
+ - type: document
138
+ format: markdown
139
+ obsidian_path: "WizardingCode/SaaS/Growth/"
140
+ description: Complete growth plan — stage diagnosis + metrics + motion + team + budget + experiments + monthly checkpoints
@@ -0,0 +1,145 @@
1
+ id: saas-launch
2
+ name: SaaS Launch Checklist & Execution
3
+ description: SaaS launch checklist + execution plan — pre-launch / launch / post-launch with stage-appropriate distribution
4
+ department: saas
5
+ tier: enterprise
6
+ command: "/saas launch"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: Launch Brief
14
+ description: Define product, current beta state, target audience, success metric, launch type (public / private / soft / hard)
15
+ agents:
16
+ - agent_id: saas-strategist-tiago
17
+ role: Frame product, beta state, audience, success metric, launch type
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms launch brief
21
+
22
+ - id: readiness-audit
23
+ name: Launch Readiness Audit
24
+ description: Product readiness checklist — feature-complete, performance, billing, support, tracking, legal
25
+ agents:
26
+ - agent_id: saas-strategist-tiago
27
+ role: Readiness audit with pass/waiver per criterion
28
+ - agent_id: tech-director-francisca
29
+ role: Technical readiness (performance, billing, infra, security)
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves launch readiness (zero blockers or explicit waivers)
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/SaaS/Launches/Readiness/"
38
+ description: Readiness audit with checklist per dimension
39
+
40
+ - id: positioning-message
41
+ name: Positioning & Core Message
42
+ description: Confirm positioning (re-using GTM positioning if exists) + 3-tier message hierarchy
43
+ agents:
44
+ - agent_id: saas-strategist-tiago
45
+ role: Core message hierarchy (tagline / headline / value props)
46
+ - agent_id: brand-strategist-mateus
47
+ role: Onlyness validation + brand consistency check
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User approves message hierarchy
52
+
53
+ - id: launch-assets
54
+ name: Launch Assets Inventory
55
+ description: Asset inventory — landing page + email + social + product hunt + press kit + demo video + docs
56
+ agents:
57
+ - agent_id: saas-strategist-tiago
58
+ role: Asset inventory with delivery dates
59
+ - agent_id: conversion-strategist-ines
60
+ role: Landing page conversion spec
61
+ parallel: true
62
+ - agent_id: copy-director-eduardo
63
+ role: Copy briefs for all launch assets
64
+ parallel: true
65
+ gate:
66
+ type: user_approval
67
+ description: User approves asset list and delivery dates
68
+
69
+ - id: channel-sequence
70
+ name: Channel Sequence
71
+ description: Day-by-day channel activation — community → list → social → press → paid
72
+ agents:
73
+ - agent_id: saas-strategist-tiago
74
+ role: Channel sequence with day-by-day priorities
75
+ - agent_id: marketing-director-luna
76
+ role: Channel-specific tactics + paid ramp plan
77
+ parallel: true
78
+ gate:
79
+ type: user_approval
80
+ description: User approves channel sequence
81
+
82
+ - id: launch-day-runbook
83
+ name: Launch Day Runbook
84
+ description: Hour-by-hour launch day — owners, action items, escalation paths, decision gates
85
+ agents:
86
+ - agent_id: saas-strategist-tiago
87
+ role: Hour-by-hour runbook with named owners + decision gates
88
+ gate:
89
+ type: user_approval
90
+ description: User approves launch day runbook
91
+ outputs:
92
+ - type: document
93
+ format: markdown
94
+ obsidian_path: "WizardingCode/SaaS/Launches/Runbooks/"
95
+ description: Hour-by-hour launch day runbook
96
+
97
+ - id: post-launch-plan
98
+ name: Post-Launch Plan
99
+ description: Week-1 / Month-1 follow-up sequence — retention focus, support scaling, iteration based on real usage
100
+ agents:
101
+ - agent_id: saas-strategist-tiago
102
+ role: Week-1 + Month-1 post-launch plan with retention focus
103
+ gate:
104
+ type: user_approval
105
+ description: User approves post-launch plan
106
+
107
+ - id: self-critique
108
+ name: Self-Critique
109
+ description: Stress-test the launch — are readiness waivers acceptable? Does channel sequence match audience reality? Are decision gates actionable?
110
+ agents:
111
+ - agent_id: saas-strategist-tiago
112
+ role: Launch coherence + readiness defensibility check
113
+ gate:
114
+ type: auto
115
+
116
+ - id: quality-gate
117
+ name: Quality Gate
118
+ model_override: opus
119
+ description: Mandatory quality review
120
+ agents:
121
+ - agent_id: cqo-marta
122
+ role: Orchestrate quality review
123
+ - agent_id: copy-director-eduardo
124
+ role: All launch copy + message hierarchy + no over-promise
125
+ parallel: true
126
+ - agent_id: tech-director-francisca
127
+ role: Readiness audit accuracy + tracking + scalability
128
+ parallel: true
129
+ gate:
130
+ type: quality_gate
131
+ required_verdict: APPROVED
132
+
133
+ - id: delivery
134
+ name: Launch Package Delivery
135
+ description: Compile launch package — readiness + assets + channel sequence + runbook + post-launch plan
136
+ agents:
137
+ - agent_id: saas-strategist-tiago
138
+ role: Full launch package + 1-page executive summary
139
+ gate:
140
+ type: auto
141
+ outputs:
142
+ - type: document
143
+ format: markdown
144
+ obsidian_path: "WizardingCode/SaaS/Launches/"
145
+ description: Complete launch package — readiness + positioning + assets + channel sequence + launch day runbook + post-launch plan + exec summary
@@ -0,0 +1,139 @@
1
+ id: saas-plg
2
+ name: Product-Led Growth Setup
3
+ description: Product-Led Growth setup — freemium or trial model selection, activation event design, monetisation trigger, expansion mechanics
4
+ department: saas
5
+ tier: enterprise
6
+ command: "/saas plg"
7
+ requires_branch: false
8
+ requires_spec: false
9
+ quality_gate_required: true
10
+
11
+ phases:
12
+ - id: brief
13
+ name: PLG Brief
14
+ description: Define product, current ICP, current activation pattern, current monetisation
15
+ agents:
16
+ - agent_id: saas-strategist-tiago
17
+ role: Frame product fit-for-PLG, current activation, current monetisation, runway
18
+ gate:
19
+ type: user_approval
20
+ description: User confirms PLG context and fit assessment
21
+
22
+ - id: model-selection
23
+ name: Model Selection (Freemium vs Trial)
24
+ description: Pick freemium vs free-trial vs reverse-trial based on product DNA + ICP + CAC math
25
+ agents:
26
+ - agent_id: saas-strategist-tiago
27
+ role: Model selection with explicit trade-off table
28
+ - agent_id: cfo-helena
29
+ role: Unit economics check per model (LTV/CAC, payback)
30
+ parallel: true
31
+ gate:
32
+ type: user_approval
33
+ description: User approves PLG model
34
+ outputs:
35
+ - type: document
36
+ format: markdown
37
+ obsidian_path: "WizardingCode/SaaS/PLG/Model/"
38
+ description: Model selection rationale + economics
39
+
40
+ - id: activation-event
41
+ name: Activation Event Design
42
+ description: Define the activation event — the moment user gets first measurable value (Aha moment)
43
+ agents:
44
+ - agent_id: saas-strategist-tiago
45
+ role: Activation event definition with measurable success criteria
46
+ - agent_id: product-director-carolina
47
+ role: User journey to activation, time-to-first-value target
48
+ parallel: true
49
+ gate:
50
+ type: user_approval
51
+ description: User approves activation event definition
52
+
53
+ - id: onboarding-design
54
+ name: Onboarding Design
55
+ description: Onboarding flow optimised for activation — checklist, empty states, value signposts
56
+ agents:
57
+ - agent_id: saas-strategist-tiago
58
+ role: Onboarding flow with friction-vs-completion trade-off explicit
59
+ - agent_id: ux-designer-sofia-d
60
+ role: UX patterns with completion target per step
61
+ parallel: true
62
+ gate:
63
+ type: user_approval
64
+ description: User approves onboarding flow
65
+
66
+ - id: monetisation-trigger
67
+ name: Monetisation Trigger
68
+ description: When and how the user hits the paywall — usage limits, feature gates, team upgrades
69
+ agents:
70
+ - agent_id: saas-strategist-tiago
71
+ role: Monetisation trigger design — value-based, not arbitrary
72
+ - agent_id: cfo-helena
73
+ role: Trigger-to-conversion math
74
+ parallel: true
75
+ gate:
76
+ type: user_approval
77
+ description: User approves monetisation trigger
78
+
79
+ - id: expansion-mechanics
80
+ name: Expansion Mechanics
81
+ description: How accounts expand within the product — multi-seat, usage growth, feature upsell, NRR > 110% target
82
+ agents:
83
+ - agent_id: saas-strategist-tiago
84
+ role: Expansion levers with NRR > 110% math
85
+ gate:
86
+ type: user_approval
87
+ description: User approves expansion mechanics
88
+
89
+ - id: instrumentation
90
+ name: Instrumentation
91
+ description: Tracking events for activation, monetisation triggers, expansion — full funnel telemetry
92
+ agents:
93
+ - agent_id: saas-strategist-tiago
94
+ role: Event schema with per-funnel-step tracking
95
+ - agent_id: tech-director-francisca
96
+ role: Implementation feasibility
97
+ parallel: true
98
+ gate:
99
+ type: auto
100
+
101
+ - id: self-critique
102
+ name: Self-Critique
103
+ description: Stress-test — does activation event predict retention? Does monetisation trigger feel earned? Does expansion math close?
104
+ agents:
105
+ - agent_id: saas-strategist-tiago
106
+ role: PLG coherence check
107
+ gate:
108
+ type: auto
109
+
110
+ - id: quality-gate
111
+ name: Quality Gate
112
+ model_override: opus
113
+ description: Mandatory quality review
114
+ agents:
115
+ - agent_id: cqo-marta
116
+ role: Orchestrate quality review
117
+ - agent_id: copy-director-eduardo
118
+ role: Onboarding copy, paywall framing, no aggressive monetisation prose
119
+ parallel: true
120
+ - agent_id: tech-director-francisca
121
+ role: Instrumentation correctness, event schema integrity
122
+ parallel: true
123
+ gate:
124
+ type: quality_gate
125
+ required_verdict: APPROVED
126
+
127
+ - id: delivery
128
+ name: PLG Package Delivery
129
+ description: Compile the PLG package — model + activation + onboarding + monetisation + expansion + instrumentation
130
+ agents:
131
+ - agent_id: saas-strategist-tiago
132
+ role: Full PLG package + 1-page executive summary
133
+ gate:
134
+ type: auto
135
+ outputs:
136
+ - type: document
137
+ format: markdown
138
+ obsidian_path: "WizardingCode/SaaS/PLG/"
139
+ description: Complete PLG package — model + activation + onboarding + monetisation + expansion + instrumentation + exec summary
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "arkaos",
3
- "version": "2.58.0",
3
+ "version": "2.60.0",
4
4
  "description": "The Operating System for AI Agent Teams",
5
5
  "type": "module",
6
6
  "bin": {
package/pyproject.toml CHANGED
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "arkaos-core"
3
- version = "2.58.0"
3
+ version = "2.60.0"
4
4
  description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
5
5
  readme = "README.md"
6
6
  license = {text = "MIT"}