arkaos 2.0.0-alpha.1

package/departments/ecom/agents/retention-manager.yaml

@@ -0,0 +1,59 @@
+id: retention-manager-catarina
+name: Catarina
+role: Retention & Email Manager
+department: ecom
+tier: 2
+
+behavioral_dna:
+  disc:
+    primary: S
+    secondary: I
+    communication_style: "Customer-first, lifecycle-aware, nurtures relationships"
+    under_pressure: "Activates win-back flows, segments VIPs for personal outreach"
+    motivator: "Repeat purchase rates climbing, CLV growing, churn falling"
+  enneagram:
+    type: 2
+    wing: 3
+    core_motivation: "Building lasting customer relationships that drive lifetime value"
+    core_fear: "Customers churning silently without intervention"
+    subtype: social
+  big_five:
+    openness: 68
+    conscientiousness: 78
+    extraversion: 62
+    agreeableness: 80
+    neuroticism: 28
+  mbti:
+    type: ESFJ
+
+authority:
+  delegates_to: []
+  escalates_to: ecom-director-ricardo
+
+expertise:
+  domains:
+    - RFM segmentation
+    - email flow design (Klaviyo, Mailchimp)
+    - cart abandonment sequences
+    - win-back campaigns
+    - loyalty programs
+    - subscription management
+    - CLV maximization
+    - post-purchase experience
+  frameworks:
+    - RFM Analysis (Sanocki)
+    - Whale Curve
+    - Email Flow Architecture
+    - Customer Lifecycle Stages
+    - Subscription Models
+  depth: expert
+  years_equivalent: 7
+
+communication:
+  language: en
+  tone: "customer-centric, lifecycle-aware, data-informed"
+  vocabulary_level: advanced
+  preferred_format: "RFM reports, email flow diagrams, retention dashboards"
+  avoid:
+    - "batch-and-blast emails"
+    - "ignoring segmentation"

package/departments/ecom/skills/analytics/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/analytics
+description: >
+  E-commerce analytics: AOV, conversion rate, CLV, ROAS, cart abandonment rate.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Analytics — `/ecom analytics`
+
+> **Agent:** Alice (CRO Specialist) | **Framework:** E-Commerce Metrics Stack
+
+## What It Does
+
+E-commerce analytics: AOV, conversion rate, CLV, ROAS, cart abandonment rate.
+
+## Output
+
+Analytics dashboard with funnel visualization and benchmark comparison

package/departments/ecom/skills/cart-recovery/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/cart-recovery
+description: >
+  Cart abandonment email sequence: 3 emails (1h, 24h, 72h) with urgency escalation.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Cart Recovery — `/ecom cart-recovery`
+
+> **Agent:** Catarina (Retention Manager) | **Framework:** Email Flow Architecture + RFM
+
+## What It Does
+
+Cart abandonment email sequence: 3 emails (1h, 24h, 72h) with urgency escalation.
+
+## Output
+
+Cart recovery sequence with subject lines, body copy, timing, and incentive strategy

package/departments/ecom/skills/cro-optimize/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: ecom/cro-optimize
+description: >
+  Conversion Rate Optimization using CXL's ResearchXL framework.
+  6-phase research process before testing anything.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# CRO Optimization — `/ecom cro <page>`
+
+> **Agent:** Alice (CRO Specialist) | **Framework:** ResearchXL (Peep Laja / CXL)
+
+## ResearchXL: 6 Phases of Research BEFORE Testing
+
+### 1. Heuristic Analysis
+- Relevance: Is the page relevant to the visitor?
+- Clarity: Is the value proposition clear in 5 seconds?
+- Friction: What causes hesitation?
+- Distraction: What takes attention from the goal?
+
+### 2. Technical Analysis
+- Core Web Vitals (LCP, INP, CLS)
+- Cross-browser/device testing
+- JavaScript errors, broken elements
+
+### 3. Analytics Analysis
+- Funnel drop-off points
+- High bounce-rate pages
+- Conversion by traffic source, device, segment
+
+### 4. Heatmaps & Session Recordings
+- Click heatmaps: where do users click?
+- Scroll maps: how far do they scroll?
+- Session recordings: how do they actually navigate?
+
+### 5. Qualitative Surveys
+- Exit surveys: "Why are you leaving without buying?"
+- On-page: "Did you find what you were looking for?"
+- Customer interviews
+
+### 6. User Testing
+- 5 users = 85% of problems found
+- Task-based: "Find and buy product X"
+- Think-aloud protocol
+
+## Test Prioritization (PIE/ICE)
+
+| Test | Potential | Importance | Ease | Score |
+|------|-----------|-----------|------|-------|
+| ... | 1-10 | 1-10 | 1-10 | P*I*E |
+
+## Rules
+- 95% statistical significance minimum
+- Run for 2+ complete business cycles
+- Test ONE variable at a time
+- Document hypothesis, variant, result, learning
+
+## Output → Research findings + prioritized test backlog + hypothesis for top 3 tests

package/departments/ecom/skills/customer-journey/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/customer-journey
+description: >
+  Customer journey mapping: discovery, consideration, purchase, delivery, loyalty.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Customer Journey — `/ecom journey <segment>`
+
+> **Agent:** Catarina (Retention Manager) | **Framework:** Customer Lifecycle + RFM
+
+## What It Does
+
+Customer journey mapping: discovery, consideration, purchase, delivery, loyalty.
+
+## Output
+
+Journey map with touchpoints, pain points, and optimization opportunities per stage

package/departments/ecom/skills/fulfillment-plan/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/fulfillment-plan
+description: >
+  Fulfillment strategy: model selection, logistics, returns, cost optimization.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Fulfillment Plan — `/ecom fulfillment`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** Fulfillment Models (3PL, FBA, Dropship)
+
+## What It Does
+
+Fulfillment strategy: model selection, logistics, returns, cost optimization.
+
+## Output
+
+Fulfillment plan with model comparison, cost analysis, and SLA targets

package/departments/ecom/skills/marketplace-manage/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/marketplace-manage
+description: >
+  Marketplace operations: seller onboarding, commission models, quality control.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Marketplace Manage — `/ecom marketplace <action>`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** Marketplace Flywheel + Mirakl
+
+## What It Does
+
+Marketplace operations: seller onboarding, commission models, quality control.
+
+## Output
+
+Marketplace operations plan with seller management and growth strategy

package/departments/ecom/skills/pricing-strategy/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/pricing-strategy
+description: >
+  Pricing strategy: value-based analysis, psychological pricing, competitor positioning.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Pricing Strategy — `/ecom pricing <product>`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** Value-Based + Dynamic + Psychological Pricing
+
+## What It Does
+
+Pricing strategy: value-based analysis, psychological pricing, competitor positioning.
+
+## Output
+
+Pricing recommendation with competitor comparison and margin analysis

package/departments/ecom/skills/product-launch/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/product-launch
+description: >
+  Product launch plan: pre-launch, launch day, post-launch with marketing sync.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Product Launch — `/ecom launch <product>`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** Product Launch Plan + GTM
+
+## What It Does
+
+Product launch plan: pre-launch, launch day, post-launch with marketing sync.
+
+## Output
+
+Launch plan with timeline, channel activation, and success metrics

package/departments/ecom/skills/rfm-segment/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: ecom/rfm-segment
+description: >
+  RFM customer segmentation: Recency, Frequency, Monetary analysis.
+  Identify Champions, At-Risk, and Hibernating customers with action plans.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch]
+---
+
+# RFM Segmentation — `/ecom rfm`
+
+> **Agent:** Catarina (Retention Manager) | **Framework:** RFM Analysis (Drew Sanocki)
+
+## RFM Dimensions
+
+| Dimension | Question | Score 1 (worst) → 5 (best) |
+|-----------|----------|---------------------------|
+| **R**ecency | When was the last purchase? | Long ago → Very recent |
+| **F**requency | How often do they buy? | Rarely → Very often |
+| **M**onetary | How much have they spent? | Low → High |
+
+## Key Segments
+
+| Segment | RFM | Action |
+|---------|-----|--------|
+| **Champions** | R5 F5 M5 | VIP program, early access, referral ask |
+| **Loyal** | R4-5 F4-5 M3-5 | Cross-sell, loyalty rewards |
+| **Potential Loyal** | R4-5 F2-3 M2-3 | Nurture series, incentivize 2nd/3rd purchase |
+| **New** | R5 F1 M1-2 | Welcome flow, first-purchase experience |
+| **At Risk** | R2-3 F3-5 M3-5 | Win-back campaign, special discount |
+| **Can't Lose** | R1-2 F4-5 M4-5 | Personal outreach, strong discount |
+| **Hibernating** | R1-2 F1-2 M1-2 | Re-engagement or accept churn |
+
+## Whale Curve
+- Top 20% customers = 80%+ of profit
+- Bottom 20% often = LOSS
+- Action: Protect top 20%, reduce cost of bottom 20%
+
+## Automated Flows per Segment
+- Champions → VIP early access + referral program
+- New → Welcome series (5 emails, 14 days)
+- At Risk → Win-back (3 emails, escalating discount)
+- Cart Abandonment → 3 emails (1h, 24h, 72h)
+
+## Output → RFM matrix + segment counts + action plan per segment

package/departments/ecom/skills/social-commerce/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/social-commerce
+description: >
+  Social commerce strategy: platform selection, product feed, live commerce.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Social Commerce — `/ecom social-commerce`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** TikTok Shop + Instagram Shopping
+
+## What It Does
+
+Social commerce strategy: platform selection, product feed, live commerce.
+
+## Output
+
+Social commerce plan with platform setup, content strategy, and attribution

package/departments/ecom/skills/store-audit/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/store-audit
+description: >
+  Full store audit: UX, SEO, performance, content, conversion with 5 parallel agents.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Store Audit — `/ecom audit`
+
+> **Agent:** Ricardo (E-Commerce Director) | **Framework:** 5-Agent Parallel Audit
+
+## What It Does
+
+Full store audit: UX, SEO, performance, content, conversion with 5 parallel agents.
+
+## Output
+
+Comprehensive audit report with scores per area and prioritized fixes

package/departments/ecom/skills/subscription-model/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ecom/subscription-model
+description: >
+  Subscription model design: replenishment, curation, access, or SaaS+commerce.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Subscription Model — `/ecom subscription <model>`
+
+> **Agent:** Catarina (Retention Manager) | **Framework:** Subscription Economy (Tien Tzuo)
+
+## What It Does
+
+Subscription model design: replenishment, curation, access, or SaaS+commerce.
+
+## Output
+
+Subscription model spec with pricing tiers, retention mechanics, and churn targets

package/departments/ecom/squad.yaml

@@ -0,0 +1,39 @@
+id: ecom-squad
+name: E-Commerce Squad
+description: Store optimization, CRO, retention, pricing, marketplace operations
+department: ecom
+squad_type: department
+topology: stream-aligned
+
+skills_prefix: "/ecom"
+obsidian_path: "WizardingCode/Ecommerce/"
+quality_gate_required: true
+max_size: 5
+
+members:
+  - agent_id: ecom-director-ricardo
+    role: Commerce strategy, platform decisions, revenue growth
+    is_lead: true
+  - agent_id: cro-specialist-ecom-alice
+    role: A/B testing, funnel analysis, conversion optimization
+  - agent_id: retention-manager-catarina
+    role: RFM segmentation, email flows, loyalty, CLV
+  - agent_id: commerce-engineer-david
+    role: Shopify development, headless commerce, checkout, APIs
+
+workflows:
+  - workflow_id: ecom-audit
+    trigger_command: "/ecom audit"
+    tier: enterprise
+  - workflow_id: ecom-product-page
+    trigger_command: "/ecom product-page"
+    tier: focused
+  - workflow_id: ecom-pricing
+    trigger_command: "/ecom pricing"
+    tier: focused
+  - workflow_id: ecom-rfm
+    trigger_command: "/ecom rfm"
+    tier: focused
+  - workflow_id: ecom-launch
+    trigger_command: "/ecom launch"
+    tier: enterprise

package/departments/ecom/workflows/product-page.yaml

@@ -0,0 +1,62 @@
+id: ecom-product-page
+name: Product Page Optimization
+description: Optimize product pages using Baymard UX guidelines and CRO best practices
+department: ecom
+tier: focused
+command: "/ecom product-page"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: audit
+    name: Page Audit
+    description: Heuristic analysis of current product page
+    agents:
+      - agent_id: cro-specialist-ecom-alice
+        role: Heuristic analysis (relevance, clarity, friction, distraction)
+    gate:
+      type: auto
+
+  - id: optimize
+    name: Optimization Plan
+    description: Specific improvements based on Baymard guidelines
+    agents:
+      - agent_id: cro-specialist-ecom-alice
+        role: Improvement recommendations prioritized by impact
+      - agent_id: retention-manager-catarina
+        role: Social proof and trust element recommendations
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves optimization priorities
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Review recommendations
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate review
+      - agent_id: copy-director-eduardo
+        role: Product copy quality
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: UX compliance, accessibility
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Optimization report with A/B test plan
+    agents:
+      - agent_id: ecom-director-ricardo
+        role: Final recommendations with expected impact
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Ecommerce/Optimization/"
+        description: Product page optimization report