arkaos 2.0.0-alpha.1

package/departments/saas/skills/benchmark-compare/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/benchmark-compare
+description: >
+  Benchmark comparison: compare your metrics against industry quartiles.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Benchmark Compare — `/saas benchmark`
+
+> **Agent:** Rita S. (Metrics Analyst) | **Framework:** KeyBanc + Meritech SaaS Benchmarks
+
+## What It Does
+
+Benchmark comparison: compare your metrics against industry quartiles.
+
+## Output
+
+Benchmark report with traffic-light indicators and improvement priorities

package/departments/saas/skills/churn-analysis/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/churn-analysis
+description: >
+  Churn analysis: cohort breakdown, retention curves, churn reasons, prevention plan.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Churn Analysis — `/saas churn`
+
+> **Agent:** Rita S. (Metrics Analyst) | **Framework:** Cohort Analysis + Retention Curves
+
+## What It Does
+
+Churn analysis: cohort breakdown, retention curves, churn reasons, prevention plan.
+
+## Output
+
+Churn report with cohort data, root causes, and intervention recommendations

package/departments/saas/skills/customer-success/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/customer-success
+description: >
+  Customer success playbook: onboard, adopt, expand, renew, advocate.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Customer Success — `/saas cs <account>`
+
+> **Agent:** Patricia (CS Manager) | **Framework:** Customer Success Lifecycle (Lincoln Murphy)
+
+## What It Does
+
+Customer success playbook: onboard, adopt, expand, renew, advocate.
+
+## Output
+
+CS playbook with health score model, touchpoint cadence, and expansion plays

package/departments/saas/skills/growth-plan/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/growth-plan
+description: >
+  Growth plan by stage: seed (PMF), A (repeatable), B (scale), C (dominate).
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Growth Plan — `/saas growth <stage>`
+
+> **Agent:** Andre S. (Growth Engineer) | **Framework:** T2D3 + Growth Loops
+
+## What It Does
+
+Growth plan by stage: seed (PMF), A (repeatable), B (scale), C (dominate).
+
+## Output
+
+Stage-appropriate growth plan with metrics, channels, and team needs

package/departments/saas/skills/gtm-strategy/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/gtm-strategy
+description: >
+  Go-to-market strategy for SaaS: motion selection, ICP, channel mix, launch plan.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Gtm Strategy — `/saas gtm <product>`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** MOVE Framework (Sangram Vajre) + 6 GTM Motions
+
+## What It Does
+
+Go-to-market strategy for SaaS: motion selection, ICP, channel mix, launch plan.
+
+## Output
+
+GTM strategy doc with motion, ICP, channels, and 90-day execution plan

package/departments/saas/skills/launch-execute/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/launch-execute
+description: >
+  SaaS launch execution: pre-launch, launch, post-launch with PLG or SLG motion.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Launch Execute — `/saas launch`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** 90-Day Launch Plan + PLG
+
+## What It Does
+
+SaaS launch execution: pre-launch, launch, post-launch with PLG or SLG motion.
+
+## Output
+
+Launch checklist with timeline, channels, and success criteria

package/departments/saas/skills/metrics-dashboard/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/metrics-dashboard
+description: >
+  Set up SaaS metrics tracking: define KPIs, data sources, dashboard layout.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Metrics Dashboard — `/saas metrics-setup`
+
+> **Agent:** Rita S. (Metrics Analyst) | **Framework:** SaaS Metrics Stack (Janz)
+
+## What It Does
+
+Set up SaaS metrics tracking: define KPIs, data sources, dashboard layout.
+
+## Output
+
+Metrics dashboard spec with KPI definitions, targets, and alert thresholds

package/departments/saas/skills/micro-saas-stack/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/micro-saas-stack
+description: >
+  Micro-SaaS portfolio strategy: stack multiple small products for diversified revenue.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Micro Saas Stack — `/saas stack`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** Micro-SaaS Stacking (Walling)
+
+## What It Does
+
+Micro-SaaS portfolio strategy: stack multiple small products for diversified revenue.
+
+## Output
+
+Stacking strategy with portfolio map, synergies, and revenue targets

package/departments/saas/skills/mvp-build/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/mvp-build
+description: >
+  MVP scope definition: core features, activation metric, time-to-value target.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Mvp Build — `/saas mvp <product>`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** MVP Scoping + Activation Metrics
+
+## What It Does
+
+MVP scope definition: core features, activation metric, time-to-value target.
+
+## Output
+
+MVP spec with feature set, acceptance criteria, and activation definition

package/departments/saas/skills/niche-evaluate/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/niche-evaluate
+description: >
+  Niche evaluation: audience reachability, willingness to pay, competition, growth.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Niche Evaluate — `/saas niche <market>`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** Micro-SaaS Niche Evaluation (Walling)
+
+## What It Does
+
+Niche evaluation: audience reachability, willingness to pay, competition, growth.
+
+## Output
+
+Niche scorecard with go/no-go recommendation

package/departments/saas/skills/onboarding-optimize/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: saas/onboarding-optimize
+description: >
+  Onboarding optimization: time-to-value, activation metric, drop-off analysis.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Onboarding Optimize — `/saas onboard <product>`
+
+> **Agent:** Andre S. (Growth Engineer) | **Framework:** PLG Activation (Wes Bush)
+
+## What It Does
+
+Onboarding optimization: time-to-value, activation metric, drop-off analysis.
+
+## Output
+
+Onboarding improvement plan with activation targets and experiment backlog

package/departments/saas/skills/plg-setup/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: saas/plg-setup
+description: >
+  Product-Led Growth setup: freemium/trial model selection, activation metrics,
+  onboarding flow, PQL definition. Framework: Wes Bush PLG Flywheel.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# PLG Setup — `/saas plg <product>`
+
+> **Agent:** Tiago + Andre S. (Growth Engineer) | **Framework:** PLG (Wes Bush)
+
+## PLG Model Selection
+
+| Model | Best For | Conversion Target |
+|-------|----------|-------------------|
+| Freemium | High volume, low marginal cost, network effects | Free→Paid: 3-5% |
+| Free Trial (14 day) | Need full experience to see value | Trial→Paid: 15-25% |
+| Reverse Trial | Show premium, then downgrade to free | Reverse→Paid: 8-15% |
+| Open Core | Dev tools, open-source community | Community→Enterprise: 1-3% |
+
+## PLG Flywheel Design
+
+```
+User signs up (self-serve)
+  → Onboarding (time-to-value < 5 min)
+    → Activation (aha moment)
+      → Engagement (habit formation)
+        → Expansion (invite team, upgrade)
+          → Advocacy (refer others)
+            → New users sign up → REPEAT
+```
+
+## Key Metrics to Define
+
+| Metric | Definition | Target |
+|--------|-----------|--------|
+| Time to Value (TTV) | Signup → first value | < 5 minutes |
+| Activation Rate | Users who reach aha moment / total signups | > 40% in 7 days |
+| PQL (Product Qualified Lead) | User behavior that predicts conversion | Define threshold |
+| Free-to-Paid Conversion | Free users who upgrade | 3-5% (freemium) |
+| NRR | Net Revenue Retention | > 110% |
+| Natural Rate of Growth | Organic + viral (no paid) | Track monthly |
+
+## Onboarding Flow Design
+1. **Welcome screen** — One sentence: what you'll accomplish
+2. **Setup steps** — Maximum 3 steps to first value
+3. **Aha moment trigger** — The specific action that hooks the user
+4. **Empty states** — Show what success looks like, not blank screens
+5. **Progress indicator** — Show how far along they are
+6. **Celebration** — Acknowledge when they complete activation
+
+## Output → Obsidian: `WizardingCode/SaaS/PLG/PLG-<slug>.md`

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

@@ -0,0 +1,48 @@
+---
+name: saas/pricing-strategy
+description: >
+  SaaS pricing strategy using value-based pricing (Patrick Campbell), Van Westendorp
+  sensitivity analysis, and competitive positioning. Outputs pricing page structure.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# SaaS Pricing Strategy — `/saas pricing <product>`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** Value-Based Pricing (Campbell)
+
+## Pricing Process
+
+### Step 1: Value Metric Identification
+- What unit of value does the customer pay for?
+- Good value metrics: users, transactions, storage, API calls
+- Bad value metrics: flat fee per company (no expansion), features only
+
+### Step 2: Willingness to Pay (Van Westendorp)
+4 questions to ask target customers:
+1. At what price is this too expensive? (won't consider)
+2. At what price is this expensive but worth it? (would consider)
+3. At what price is this a bargain? (great deal)
+4. At what price is this too cheap? (suspect quality)
+
+### Step 3: Competitive Positioning
+| Position | Strategy | When |
+|----------|----------|------|
+| Premium | 2-3x market price | Superior features, brand, support |
+| Competitive | Market average | Similar features, compete on UX |
+| Penetration | Below market | New entrant, grab share fast |
+| Freemium | Free core + paid premium | PLG, high volume, low marginal cost |
+
+### Step 4: Tier Structure
+Standard 3-tier model:
+- **Free/Starter:** Hook users, demonstrate value, capture leads
+- **Pro:** Most popular, solves the full problem, best value
+- **Business/Enterprise:** Team features, SSO, SLA, priority support
+
+### Step 5: Pricing Page Rules
+- Highlight the recommended plan (usually middle)
+- Annual pricing default (show monthly savings)
+- Feature comparison table with clear differentiators
+- Social proof on pricing page (logos, testimonials)
+- FAQ section addressing common objections
+
+## Output → Obsidian: `WizardingCode/SaaS/Pricing/PRICING-<slug>.md`

package/departments/saas/skills/saas-scaffold/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: saas/saas-scaffold
+description: >
+  Scaffold a production-ready SaaS project with auth, database, billing,
+  API routes, and dashboard. Generates file tree, schema, and env config.
+  Technical scaffolding — for strategy use saas/mvp-build.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
+---
+
+# SaaS Scaffold — `/saas scaffold <stack>`
+
+> **Agent:** Tiago (SaaS Lead) | **Frameworks:** Micro-SaaS Playbook, PLG
+
+## Input
+
+| Field | Options | Default |
+|-------|---------|---------|
+| Product | name | required |
+| Description | 1-3 sentences | required |
+| Auth | nextauth, clerk, supabase | nextauth |
+| Database | neondb, supabase, planetscale | neondb |
+| Payments | stripe, lemonsqueezy, none | stripe |
+| Features | comma-separated list | -- |
+
+## File Tree (Next.js + App Router)
+
+```
+my-saas/
+├── app/
+│   ├── (auth)/login/page.tsx, register/page.tsx, layout.tsx
+│   ├── (dashboard)/dashboard/page.tsx, settings/page.tsx, billing/page.tsx, layout.tsx
+│   ├── (marketing)/page.tsx, pricing/page.tsx, layout.tsx
+│   └── api/auth/[...nextauth]/route.ts, webhooks/stripe/route.ts,
+│         billing/checkout/route.ts, billing/portal/route.ts
+├── components/ui/, auth/, dashboard/, marketing/, billing/
+├── lib/auth.ts, db.ts, stripe.ts, validations.ts, utils.ts
+├── db/schema.ts, migrations/
+├── hooks/use-subscription.ts, use-user.ts
+├── types/index.ts
+├── middleware.ts
+├── .env.example
+├── drizzle.config.ts
+└── next.config.ts
+```
+
+## Scaffold Phases
+
+### Phase 1 — Foundation
+- [ ] Next.js initialized (TypeScript + App Router)
+- [ ] Tailwind CSS configured with custom theme
+- [ ] shadcn/ui installed and configured
+- [ ] ESLint + Prettier configured
+- [ ] `.env.example` created with all variables
+- **Validate:** `npm run build` passes with zero errors
+
+### Phase 2 — Database
+- [ ] Drizzle ORM installed and configured
+- [ ] Schema: users, accounts, sessions, verification_tokens
+- [ ] Initial migration generated and applied
+- [ ] DB client singleton in `lib/db.ts`
+- **Validate:** `db.select().from(users)` returns empty array
+
+### Phase 3 — Authentication
+- [ ] Auth provider installed (NextAuth / Clerk / Supabase)
+- [ ] OAuth provider configured (Google / GitHub)
+- [ ] Session callback adds user ID + subscription status
+- [ ] Middleware protects dashboard routes
+- [ ] Login/register pages with error states
+- **Validate:** Sign in via OAuth, session has `id` + `subscriptionStatus`
+
+### Phase 4 — Payments
+- [ ] Stripe client initialized with TypeScript types
+- [ ] Checkout session route created
+- [ ] Customer portal route created
+- [ ] Webhook handler with signature verification
+- [ ] Webhook updates subscription status idempotently
+- **Validate:** Test checkout with `4242 4242 4242 4242`, verify DB write
+
+### Phase 5 — UI
+- [ ] Landing page: hero, features, pricing sections
+- [ ] Dashboard layout: sidebar + responsive header
+- [ ] Billing page: current plan + upgrade options
+- [ ] Settings page: profile update form
+- **Validate:** `npm run build` passes, all routes render correctly
+
+## Environment Variables
+
+`NEXT_PUBLIC_APP_URL`, `DATABASE_URL` (with `?sslmode=require`), `NEXTAUTH_SECRET`, `NEXTAUTH_URL`, `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY`, `STRIPE_PRO_PRICE_ID`
+
+## Common Pitfalls
+
+| Problem | Fix |
+|---------|-----|
+| Missing `NEXTAUTH_SECRET` in prod | Set and keep consistent across deploys |
+| Webhook signature mismatch | Use `stripe listen --forward-to` locally |
+| Edge runtime + Drizzle conflict | Use Node runtime for DB routes |
+| Unextended session types | Add `declare module "next-auth"` |
+| Dev vs prod migration drift | Use `drizzle-kit push` (dev), `drizzle-kit migrate` (prod) |
+
+## Proactive Triggers
+
+Surface these issues WITHOUT being asked:
+
+- No .env.example file → flag team setup friction
+- Missing health check endpoint → flag monitoring gap
+- No database migration strategy → flag deployment chaos
+
+## Output
+
+```markdown
+## SaaS Scaffold — [Product Name]
+
+**Stack:** Next.js + [Auth] + [DB] + [Payments]
+**Features:** [list]
+
+### Generated Files
+[file tree with descriptions]
+
+### Phase Checklist
+[5 phases with validation gates]
+
+### Environment Setup
+[.env.example contents]
+
+### Next Steps
+1. [immediate action items]
+```

package/departments/saas/skills/validate-idea/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: saas/validate-idea
+description: >
+  30-day SaaS idea validation using Rob Walling's Micro-SaaS playbook.
+  Market check, niche evaluation, competitor analysis, unit economics projection.
+allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
+---
+
+# SaaS Idea Validation — `/saas validate <idea>`
+
+> **Agent:** Tiago (SaaS Strategist) | **Framework:** Micro-SaaS Playbook (Rob Walling)
+
+## Validation Framework (30-Day)
+
+### Week 1: Problem Validation
+1. **Problem statement** — Define the exact problem (who has it, how painful, how frequent)
+2. **Niche evaluation** — Score the niche:
+   - Audience reachable? (online communities, forums, subreddits)
+   - Willing to pay? (existing paid solutions = proof)
+   - Growing or shrinking? (Google Trends, industry reports)
+3. **Staircase stage** — Where does this fit?
+   - Step 1: $0-$50K ARR (solo, micro-SaaS)
+   - Step 2: $50K-$500K ARR (small team)
+   - Step 3: $500K-$3M ARR (growing team)
+
+### Week 2: Market Validation
+4. **TAM/SAM/SOM** — Market sizing (top-down + bottom-up)
+5. **Competitor landscape** — Who else solves this? How? Pricing?
+6. **Positioning gap** — What's missing? What can we do differently?
+7. **5 customer interviews** — Talk to people with the problem (Mom Test rules)
+
+### Week 3: Business Model
+8. **Revenue model** — Subscription (monthly/annual), usage-based, freemium?
+9. **Pricing** — Van Westendorp survey or willingness-to-pay analysis
+10. **Unit economics projection** — CAC, LTV, payback period, Rule of 40
+11. **PLG vs SLG decision** — Product-led or sales-led? Based on ACV
+
+### Week 4: MVP Scope
+12. **Core feature set** — What's the minimum to deliver first value?
+13. **Activation metric** — What action = "aha moment"?
+14. **Time-to-value target** — How fast can user get value? (target: < 5 min)
+15. **Go/No-Go decision** — Pass all criteria? → Build. Fail? → Pivot or kill.
+
+## Go/No-Go Criteria
+
+| Criterion | Pass | Fail |
+|-----------|------|------|
+| Problem severity | People actively seek solutions | Nice-to-have |
+| Market size | SOM > $1M | SOM < $500K |
+| Competition | Gaps exist, room to differentiate | Saturated, dominant player |
+| Unit economics | LTV:CAC > 3:1 projected | LTV:CAC < 2:1 |
+| Activation | Clear aha moment identified | Unclear value proposition |
+| Build complexity | MVP in 4-8 weeks | MVP > 3 months |
+
+## Output → Obsidian: `WizardingCode/SaaS/Validation/VALIDATE-<slug>.md`

package/departments/saas/squad.yaml

@@ -0,0 +1,37 @@
+id: saas-squad
+name: SaaS & Micro-SaaS Squad
+description: SaaS validation, metrics, PLG, pricing, customer success, growth
+department: saas
+squad_type: department
+topology: stream-aligned
+
+skills_prefix: "/saas"
+obsidian_path: "WizardingCode/SaaS/"
+quality_gate_required: true
+max_size: 5
+
+members:
+  - agent_id: saas-strategist-tiago
+    role: SaaS strategy, metrics, benchmarking, PLG design
+    is_lead: true
+  - agent_id: growth-engineer-andre-s
+    role: Growth experiments, activation, onboarding optimization
+  - agent_id: cs-manager-patricia
+    role: Customer success lifecycle, churn prevention, NRR
+
+workflows:
+  - workflow_id: saas-validate
+    trigger_command: "/saas validate"
+    tier: enterprise
+  - workflow_id: saas-metrics
+    trigger_command: "/saas metrics"
+    tier: focused
+  - workflow_id: saas-pricing
+    trigger_command: "/saas pricing"
+    tier: focused
+  - workflow_id: saas-plg
+    trigger_command: "/saas plg"
+    tier: enterprise
+  - workflow_id: saas-launch
+    trigger_command: "/saas launch"
+    tier: enterprise

package/departments/saas/workflows/metrics.yaml

@@ -0,0 +1,58 @@
+id: saas-metrics
+name: SaaS Metrics Dashboard
+description: Set up or review SaaS metrics with benchmarks
+department: saas
+tier: focused
+command: "/saas metrics"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: collect
+    name: Data Collection
+    description: Gather current metrics from the product/business
+    agents:
+      - agent_id: metrics-analyst-rita-s
+        role: Collect MRR, churn, CAC, LTV, NRR, and supporting data
+    gate:
+      type: auto
+
+  - id: analyze
+    name: Analysis & Benchmarking
+    description: Calculate all metrics and compare to industry benchmarks
+    agents:
+      - agent_id: metrics-analyst-rita-s
+        role: Calculate metrics, benchmark against KeyBanc/Meritech
+      - agent_id: saas-strategist-tiago
+        role: Strategic interpretation and recommendations
+        parallel: true
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Validate data accuracy
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate review
+      - agent_id: tech-director-francisca
+        role: Data accuracy and calculation verification
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Metrics dashboard with traffic lights and recommendations
+    agents:
+      - agent_id: saas-strategist-tiago
+        role: Final metrics report with action items
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/SaaS/Metrics/"
+        description: SaaS metrics dashboard