arkaos 2.49.0 → 2.51.0

package/VERSION

@@ -1 +1 @@
-2.49.0
+2.51.0

package/departments/brand/skills/design-system/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: brand/design-system
 description: >
-  Design system specification: tokens, atoms, molecules, organisms, templates.
+  Production design system specification: tokens, atoms, molecules, organisms,
+  templates, and pages — with WCAG AA conformance and Storybook export contract.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
@@ -21,12 +22,183 @@ does not replace the vault.
 
 # Design System — `/brand design-system`
 
-> **Agent:** Sofia D. (UX Designer) | **Framework:** Atomic Design (Brad Frost) + Design Tokens
+> **Lead:** Sofia D. (UX Designer) + Isabel (Visual Designer) | **Framework:** Atomic Design (Brad Frost) + Design Tokens + WCAG 2.2 AA
 
-## What It Does
+## What ships
 
-Design system specification: tokens, atoms, molecules, organisms, templates.
+A production design system in 5 deliverables:
 
-## Output
+1. **`design-tokens.json`** — semantic token layer
+2. **Component catalog** — atoms → molecules → organisms → templates → pages
+3. **WCAG 2.2 AA conformance report** — pass / waiver per component
+4. **Storybook story stubs** — one story per component, ready to drop into Storybook
+5. **Integration guide** — how to wire the system into a Vue/React/Vanilla project
 
-Design system spec with token definitions, component catalog, and usage guidelines
+## Token JSON schema
+
+The token system has a **two-layer architecture**: raw primitives + semantic aliases. Semantic tokens reference primitives; surfaces reference semantic tokens. Never reference primitives directly in components.
+
+```json
+{
+  "$schema": "https://design-tokens.github.io/community-group/format/",
+  "primitive": {
+    "color": {
+      "neutral": {
+        "0":   { "$value": "#FFFFFF",  "$type": "color" },
+        "50":  { "$value": "#FAFAFA",  "$type": "color" },
+        "100": { "$value": "#F4F4F5",  "$type": "color" },
+        "900": { "$value": "#18181B",  "$type": "color" },
+        "1000":{ "$value": "#0A0A0A",  "$type": "color" }
+      },
+      "accent": {
+        "500": { "$value": "#00FF88",  "$type": "color" }
+      }
+    },
+    "size": {
+      "0": { "$value": "0",    "$type": "dimension" },
+      "1": { "$value": "4px",  "$type": "dimension" },
+      "2": { "$value": "8px",  "$type": "dimension" },
+      "4": { "$value": "16px", "$type": "dimension" }
+    }
+  },
+  "semantic": {
+    "color": {
+      "background": { "$value": "{primitive.color.neutral.1000}", "$type": "color" },
+      "surface":    { "$value": "{primitive.color.neutral.900}",  "$type": "color" },
+      "text":       { "$value": "{primitive.color.neutral.50}",   "$type": "color" },
+      "accent":     { "$value": "{primitive.color.accent.500}",   "$type": "color" }
+    },
+    "space": {
+      "compact":  { "$value": "{primitive.size.2}",  "$type": "dimension" },
+      "default":  { "$value": "{primitive.size.4}",  "$type": "dimension" },
+      "generous": { "$value": "{primitive.size.6}",  "$type": "dimension" }
+    },
+    "radius": { "$value": "{primitive.size.2}", "$type": "dimension" },
+    "motion": {
+      "duration": {
+        "fast":   { "$value": "150ms",  "$type": "duration" },
+        "base":   { "$value": "250ms",  "$type": "duration" },
+        "slow":   { "$value": "400ms",  "$type": "duration" }
+      },
+      "easing": {
+        "standard": { "$value": "cubic-bezier(0.4, 0, 0.2, 1)", "$type": "cubicBezier" }
+      }
+    }
+  }
+}
+```
+
+Required token groups: `color`, `space`, `typography`, `radius`, `elevation`, `motion`, `border`. Each group must have at minimum 3 semantic tokens. Primitives are reusable; semantics are intentional.
+
+## Atomic Design 5-Level Component Manifest
+
+Each component is documented with: name, level, props, slots, accessibility notes, Storybook story stub.
+
+### Level 1 — Atoms (10-15 required)
+Indivisible UI primitives. Examples:
+
+| Component | Props | A11y notes |
+|---|---|---|
+| Button | `variant` (primary/secondary/ghost), `size`, `disabled`, `loading` | role=button, aria-busy on loading, keyboard-actionable |
+| Input | `type`, `value`, `placeholder`, `disabled`, `invalid` | aria-invalid on invalid, aria-describedby for error |
+| Label | `htmlFor`, `required` | explicit for association required |
+| Icon | `name`, `size`, `decorative` | role=img + aria-label OR aria-hidden when decorative |
+| Avatar | `src`, `alt`, `fallback`, `size` | alt required unless decorative |
+| Badge | `variant`, `count` | aria-live polite when count changes |
+| Spinner | `size`, `label` | role=status + aria-label |
+| Switch | `checked`, `disabled` | role=switch + aria-checked |
+| Checkbox | `checked`, `indeterminate`, `disabled` | aria-checked tri-state support |
+| Link | `href`, `external`, `variant` | rel=noopener for external |
+
+### Level 2 — Molecules (8-12 required)
+Composed pairs of atoms with one task focus. Examples:
+
+| Component | Composes | A11y notes |
+|---|---|---|
+| FormField | Label + Input + ErrorMessage | aria-describedby chain |
+| SearchBar | Input + Button + Icon | role=search, aria-label on form |
+| Card | Heading + Body + optional Footer | semantic landmark when standalone |
+| NavItem | Icon + Label + (Badge) | aria-current when active |
+| Tab | Label + (Icon) + (Badge) | role=tab, aria-selected |
+| Toast | Icon + Body + DismissButton | role=status or alert, dismissible |
+| Tooltip | Anchor + Content | aria-describedby on anchor |
+| Breadcrumb | Link[] + separator | nav landmark, aria-current on last |
+
+### Level 3 — Organisms (6-10 required)
+Complete sections of UI. Examples:
+
+| Component | Composes | A11y notes |
+|---|---|---|
+| NavBar | Logo + NavItem[] + Avatar | nav landmark, skip-link target |
+| HeroSection | Heading + Body + CTA + (Media) | one h1 per page rule |
+| CardGrid | Card[] with layout | role=list when semantic, gap-aware |
+| Dialog | Header + Body + Footer + FocusTrap | role=dialog, aria-labelledby, focus trap |
+| DataTable | Header + Row[] with sort/filter | proper th scope, aria-sort |
+| Sidebar | NavItem[] + collapse | nav landmark, persisted state |
+| EmptyState | Icon + Heading + Body + (CTA) | role=region |
+
+### Level 4 — Templates (3-5 required)
+Page-level layouts with content slots. Examples: DashboardTemplate, ContentTemplate, MarketingTemplate, AuthTemplate, SettingsTemplate.
+
+### Level 5 — Pages (2-3 required, production examples)
+Production-ready pages with real content. Examples: LandingPage, DashboardHome, SettingsAccount.
+
+## WCAG 2.2 AA Gates
+
+Every component must pass:
+
+| Criterion | Check | Tool |
+|---|---|---|
+| 1.4.3 Contrast (Minimum) | Body text ≥ 4.5:1 against background; large text ≥ 3:1 | manual + axe |
+| 1.4.11 Non-text Contrast | UI components and graphical objects ≥ 3:1 against adjacent colors | manual + axe |
+| 2.1.1 Keyboard | All functionality available via keyboard | manual |
+| 2.4.7 Focus Visible | Visible focus indicator on all interactive elements | manual |
+| 2.5.8 Target Size (Minimum) | Pointer targets ≥ 24×24 CSS pixels | manual |
+| 4.1.2 Name, Role, Value | All UI components expose accessible name and role to AT | axe + screen reader |
+| 4.1.3 Status Messages | Status updates announced without focus change | screen reader |
+
+Components failing any criterion either remediate or document a **permanent waiver** with concrete user-impact rationale. Waivers require Quality Gate approval.
+
+## Storybook Export Contract
+
+Each component must ship one `.stories.{ts,mdx}` file with:
+
+- **Default** story — props at defaults, single state visible
+- **AllVariants** story — every variant prop combination
+- **Interactive** story — controls (Storybook args) exposed for every prop
+- **A11y** story — screen-reader narration sample + keyboard nav sequence
+
+Story stubs use the CSF3 format:
+
+```typescript
+import type { Meta, StoryObj } from '@storybook/react';
+import { Button } from './Button';
+
+const meta: Meta<typeof Button> = {
+  component: Button,
+  parameters: { a11y: { test: 'error' } },
+  argTypes: {
+    variant: { control: 'select', options: ['primary', 'secondary', 'ghost'] },
+    size: { control: 'select', options: ['sm', 'md', 'lg'] },
+    disabled: { control: 'boolean' },
+  },
+};
+export default meta;
+
+type Story = StoryObj<typeof Button>;
+export const Default: Story = { args: { variant: 'primary', size: 'md' } };
+export const AllVariants: Story = { /* render all variants in a grid */ };
+```
+
+## Integration Guide (delivery artifact)
+
+A standalone markdown explaining:
+- How to install token files (CSS variables / JSON / Tailwind config)
+- How to import components in Vue / React / Vanilla
+- How to extend the system (adding tokens, adding components, namespacing)
+- How to run the WCAG audit locally (`npx axe-core --tags wcag2aa`)
+- How to update Storybook stories when components change
+
+## Output → Obsidian: `WizardingCode/Brand/DesignSystems/<project>-<date>/`
+
+Delivers: `design-tokens.json` + component catalog (markdown with screenshots / mermaid hierarchy) + WCAG report + Storybook stubs + integration guide.

package/departments/brand/skills/primal-audit/SKILL.md

@@ -40,12 +40,51 @@ does not replace the vault.
 
 1. **Gather** — Collect all brand assets: website, social, packaging, internal docs
 2. **Map** — Fill each of the 7 elements with what currently exists
-3. **Score** — Rate each element: Strong (3), Present (2), Weak (1), Missing (0)
-4. **Gaps** — Identify missing or weak elements
-5. **Recommend** — Specific actions to strengthen each weak element
-6. **Benchmark** — Compare against competitors' Primal Codes
+3. **Score** — Apply the per-element rubric below (3 points each across 7 elements = 21 total)
+4. **Gaps** — Identify weak elements and the specific sub-criterion that failed
+5. **Recommend** — Specific remediation per gap, ranked by leverage
+6. **Benchmark** — Compare against 3-5 competitors' Primal Codes
 
-## Scoring
+## Per-Element Scoring Rubric (3 sub-criteria each)
+
+Each element is scored 0-3. Mark each sub-criterion present (1) or absent (0); sum to the element score.
+
+### 1. Creation Story (max 3)
+- [ ] **Origin moment is named** — a specific event, year, person, or pain point that triggered the brand
+- [ ] **Consistency across surfaces** — the same story appears on About page, founder bio, key talks
+- [ ] **Emotional anchor present** — a stakes-laden tension the founder needed to resolve
+
+### 2. Creed (max 3)
+- [ ] **Belief is stated, not implied** — explicit "we believe…" or "we exist because…" sentence
+- [ ] **Belief has a counter-position** — the creed names what it rejects, not just what it affirms
+- [ ] **Belief shapes product decisions** — at least one shipped feature can be traced to the creed
+
+### 3. Icons (max 3)
+- [ ] **Symbol is consistent** — same logo / mark across all primary surfaces
+- [ ] **Symbol carries meaning** — the mark is decoded by users (Apple = bite, Nike = motion)
+- [ ] **Sub-icons reinforce** — secondary visual language (palette, type, photography style) supports the primary symbol
+
+### 4. Rituals (max 3)
+- [ ] **Repeated user action defines the brand** — unboxing, onboarding, daily check-in, signature gesture
+- [ ] **The ritual is named or recognizable** — users can describe the ritual back without prompting
+- [ ] **The ritual is protected** — the brand resists altering it; the ritual has loadbearing weight
+
+### 5. Non-Adherents (max 3)
+- [ ] **Opposition is named** — competitors, mindsets, or status-quo positions explicitly called out
+- [ ] **Identity is sharpened by contrast** — what the brand REFUSES is as clear as what it offers
+- [ ] **Tribal lines are visible to outsiders** — adopting the brand signals belonging in a recognizable in-group
+
+### 6. Sacred Lexicon (max 3)
+- [ ] **3+ proprietary terms in active use** — words coined or claimed by the brand that customers repeat
+- [ ] **Vocabulary is taught** — onboarding, docs, or messaging explicitly introduce the lexicon
+- [ ] **Outsiders cannot fake fluency** — using the lexicon correctly signals real adherence
+
+### 7. Leader (max 3)
+- [ ] **A named human embodies the brand** — founder, CEO, public face with personal voice
+- [ ] **Leader carries the creed** — public statements consistently align with the brand's belief
+- [ ] **Leader is accessible** — direct contact channel exists (writing, podcast, social presence, AMAs)
+
+## 21-Point Index
 
 | Score | Rating | Meaning |
 |-------|--------|---------|
@@ -54,4 +93,38 @@ does not replace the vault.
 | 10-13 | Developing | Foundation exists, significant gaps |
 | 0-9 | Underdeveloped | Major brand building needed |
 
+## Evidence Citation Contract
+
+Every per-criterion score MUST cite specific asset evidence. Format:
+
+```
+Creation Story (2/3)
+  ✓ Origin moment named — "Founded 2018 in a coffee shop after the third
+    failed deploy" (About page, 2nd paragraph)
+  ✓ Consistency across surfaces — same story on About + founder LinkedIn
+    + S2 podcast appearance
+  ✗ Emotional anchor present — origin reads as biography, no stakes-laden
+    tension. Suggested remediation: rewrite to surface the cost of the
+    problem (what was at risk if this didn't exist).
+```
+
+A score without evidence is a score without weight. Self-critique phase rejects any unjustified marks.
+
+## Competitor Benchmark Template
+
+For each of 3-5 competitors, complete the same 21-point rubric and compute relative position:
+
+```
+| Brand | Creation | Creed | Icons | Rituals | Non-Adherents | Lexicon | Leader | Total |
+|-------|----------|-------|-------|---------|---------------|---------|--------|-------|
+| Ours  |   2      |   3   |   2   |   1     |   0           |   2     |   3    | 13/21 |
+| CompA |   3      |   3   |   3   |   3     |   2           |   3     |   2    | 19/21 |
+| CompB |   1      |   2   |   2   |   1     |   1           |   1     |   1    |  9/21 |
+| CompC |   2      |   2   |   3   |   2     |   2           |   2     |   1    | 14/21 |
+```
+
+Output **strategic gaps** (where we trail the leader) vs **deliberate non-positions** (where we choose not to compete). Mark each gap with leverage rating: high / medium / low — to be ranked into the remediation plan.
+
 ## Output → Obsidian: `WizardingCode/Brand/Audits/PRIMAL-AUDIT-<brand>-<date>.md`
+
+Includes: per-element scoring with citations, 21-point index, competitor benchmark, ranked remediation plan with leverage ratings, and concrete next-7-days actions for the top 3 gaps.

package/departments/brand/workflows/audit.yaml

@@ -0,0 +1,118 @@
+id: brand-audit
+name: Brand Audit
+description: Diagnose an existing brand against the 7 Primal Code elements with competitor benchmark
+department: brand
+tier: enterprise
+command: "/brand audit"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Audit Brief
+    description: Define brand under audit, audience, competitors to benchmark against
+    agents:
+      - agent_id: brand-director-valentina
+        role: Frame audit scope, identify the 3-5 competitor brands for benchmark
+    gate:
+      type: user_approval
+      description: User confirms brand-under-audit and competitor set
+
+  - id: asset-gather
+    name: Asset Gathering
+    description: Collect all live brand assets (logo, palette, type, voice samples, taglines, web/social proof points)
+    agents:
+      - agent_id: brand-director-valentina
+        role: Catalog the brand surface area, flag missing assets
+      - agent_id: visual-designer-isabel
+        role: Extract visual tokens from existing materials
+        parallel: true
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Brand/Audits/Assets/"
+        description: Asset inventory with file references
+
+  - id: seven-element-mapping
+    name: Primal 7-Element Mapping
+    description: Score each Primal element (Creation Story, Creed, Icons, Rituals, Sacred Words, Non-Believers, Leader) against evidence
+    agents:
+      - agent_id: brand-strategist-mateus
+        role: Score Creation Story, Creed, Sacred Words, Non-Believers, Leader against asset evidence
+        parallel: true
+      - agent_id: ux-designer-sofia-d
+        role: Score Icons and Rituals against UI/interaction evidence
+        parallel: true
+    gate:
+      type: auto
+
+  - id: scoring
+    name: 21-Point Scoring
+    description: Aggregate per-element scores into a 21-point Primal Code Index (3 points per element across 7 elements)
+    agents:
+      - agent_id: brand-strategist-mateus
+        role: Compute the 21-point Primal Code Index, identify gaps
+    gate:
+      type: user_approval
+      description: User reviews the 21-point scoring before benchmark phase
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Brand/Audits/Scoring/"
+        description: 21-point Primal Code Index with per-element evidence
+
+  - id: competitor-benchmark
+    name: Competitor Benchmark
+    description: Run the same 21-point scoring on 3-5 competitor brands; compute relative position
+    agents:
+      - agent_id: brand-strategist-mateus
+        role: Benchmark competitor scores, compute relative position
+      - agent_id: strategy-director-tomas
+        role: Strategic context — which gaps are wins to close, which are deliberate non-positions
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves the benchmark results before remediation ranking
+
+  - id: self-critique
+    name: Self-Critique
+    description: Stress-test the audit — are scores defensible by evidence? Are gaps actionable?
+    agents:
+      - agent_id: brand-director-valentina
+        role: Verify each score has a concrete asset citation, each gap has a measurable target
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    model_override: opus
+    description: Mandatory quality review
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: Audit prose quality, no clichés, defensible scoring language
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Visual evidence completeness, accessibility findings, file format integrity
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Audit Report & Recommendations
+    description: Compile audit report with ranked remediation recommendations
+    agents:
+      - agent_id: brand-director-valentina
+        role: Compile audit report — 21-point index, gap analysis, ranked remediation plan
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Brand/Audits/"
+        description: Complete brand audit with 21-point index + competitor benchmark + ranked recommendations

package/departments/brand/workflows/design-system.yaml

@@ -0,0 +1,122 @@
+id: brand-design-system
+name: Design System Specification
+description: Production design system from tokens to Storybook components (Atomic Design + WCAG AA)
+department: brand
+tier: enterprise
+command: "/brand design-system"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Design System Brief
+    description: Define product surface, platforms, accessibility floor, integration target
+    agents:
+      - agent_id: brand-director-valentina
+        role: Frame system scope (web / mobile / multi-product), confirm accessibility floor (WCAG AA minimum)
+    gate:
+      type: user_approval
+      description: User confirms scope, platforms, and accessibility floor
+
+  - id: token-design
+    name: Token Design
+    description: Define design tokens (color, typography, spacing, radius, elevation, motion) as JSON
+    agents:
+      - agent_id: visual-designer-isabel
+        role: Color palette with semantic tokens, typography scale, spacing rhythm, radius/elevation/motion tokens
+    gate:
+      type: user_approval
+      description: User approves the token system before component build
+    outputs:
+      - type: document
+        format: json
+        obsidian_path: "WizardingCode/Brand/DesignSystems/Tokens/"
+        description: design-tokens.json with full semantic layer
+
+  - id: atom-molecule-organism
+    name: Atom, Molecule, Organism
+    description: Build the lower three Atomic Design levels — primitives, composed pairs, complete sections
+    agents:
+      - agent_id: ux-designer-sofia-d
+        role: Atoms (button, input, label, icon), molecules (form field, card header, nav item)
+        parallel: true
+      - agent_id: visual-designer-isabel
+        role: Organisms (nav bar, hero, card grid, dialog) with token application
+        parallel: true
+    gate:
+      type: auto
+
+  - id: template-page
+    name: Templates & Pages
+    description: Complete Atomic Design — page templates with content placeholders, plus 2-3 production page examples
+    agents:
+      - agent_id: ux-designer-sofia-d
+        role: Page templates (landing, dashboard, settings, empty state)
+      - agent_id: visual-designer-isabel
+        role: Production page examples with real content
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves the template set before accessibility audit
+
+  - id: accessibility-audit
+    name: WCAG AA Audit
+    description: Full WCAG 2.2 AA audit on every component — contrast, focus, semantics, ARIA, keyboard
+    agents:
+      - agent_id: wcag-auditor
+        role: WCAG 2.2 AA conformance audit on every atom/molecule/organism/template
+      - agent_id: ux-designer-sofia-d
+        role: Remediate failures, document permanent waivers with rationale
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves the conformance report (zero AA failures required)
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Brand/DesignSystems/Accessibility/"
+        description: WCAG AA conformance report — every component pass/waiver
+
+  - id: self-critique
+    name: Self-Critique
+    description: Stress-test the system — naming consistency, token coverage, scale integrity, edge-case components
+    agents:
+      - agent_id: brand-director-valentina
+        role: Verify naming consistency, token coverage, scale integrity, edge-case components
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    model_override: opus
+    description: Mandatory quality review
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: Component naming, prop names, docstring clarity, no AI clichés in copy
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Token schema integrity, accessibility compliance, Storybook contract correctness
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Design System Delivery
+    description: Compile the design system — tokens JSON + component catalog + WCAG report + Storybook story stubs
+    agents:
+      - agent_id: brand-director-valentina
+        role: Compile the design system package and write the integration guide
+      - agent_id: shadcn-padronizer
+        role: Optional shadcn/ui alignment for code-side parity
+        optional: true
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Brand/DesignSystems/"
+        description: Complete design system — design-tokens.json + component catalog + accessibility report + Storybook stubs + integration guide

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

@@ -1,7 +1,9 @@
 ---
 name: saas/gtm-strategy
 description: >
-  Go-to-market strategy for SaaS: motion selection, ICP, channel mix, launch plan.
+  Cross-departmental go-to-market strategy: ICP, positioning, motion selection,
+  channel mix, 90-day execution plan. Orchestrates SaaS + Strategy + Marketing
+  + Sales + Landing.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
@@ -19,14 +21,138 @@ treat them as your default source. External research supplements, it
 does not replace the vault.
 <!-- arka:kb-first-prefix end -->
 
-# Gtm Strategy — `/saas gtm <product>`
+# GTM Strategy — `/saas gtm <product>`
 
-> **Agent:** Tiago (SaaS Strategist) | **Framework:** MOVE Framework (Sangram Vajre) + 6 GTM Motions
+> **Lead:** Tiago (SaaS Strategist) | **Cross-dept:** Tomas (Strategy) + Mateus (Brand) + Luna (Marketing) + Miguel (Sales) + Ines (Landing) | **Framework:** MOVE (Sangram Vajre) + Onlyness + AARRR
 
-## What It Does
+## What ships
 
-Go-to-market strategy for SaaS: motion selection, ICP, channel mix, launch plan.
+A production GTM package in 6 deliverables, each with a named owner and a measurable target:
 
-## Output
+1. **ICP profile** — firmographics + persona + pain triggers + buying signal
+2. **Positioning statement** — Onlyness frame + competitive contrast table
+3. **Motion selection** — primary + assist motion with feasibility math
+4. **Channel mix** — budget allocation across channels with AARRR baseline
+5. **90-day execution plan** — week-by-week with owners + checkpoints
+6. **Executive summary** — 1-page printable to align stakeholders
 
-GTM strategy doc with motion, ICP, channels, and 90-day execution plan
+## ICP Template (firmographic + persona + pain + signal)
+
+Every ICP profile must carry these four blocks. Vagueness in any block invalidates the rest of the GTM stack.
+
+### Firmographics (the company shape)
+- Company size (employees, ARR range)
+- Industry vertical (with NAICS / SIC code if relevant)
+- Geo (countries, regulatory regions)
+- Tech stack signal (what they already pay for that signals readiness)
+- Funding stage (bootstrapped / seed / Series A+ / public)
+
+### Persona (the human inside the company)
+- Title and seniority
+- Primary KPI they own
+- Tools they use daily
+- Information diet (newsletters, podcasts, communities)
+- Decision authority (sole / committee / approval)
+
+### Pain Triggers (the moment they realise they need this)
+- The specific event that surfaces the pain (new hire, missed quarter, audit, regulation change)
+- The cost of not solving it (revenue at risk, hours wasted, compliance exposure)
+- The status quo workaround (Excel, agencies, internal builds)
+
+### Buying Signal (how you find them in the wild)
+- Observable behavior in the open web (job postings with specific keywords, tool reviews, talks at specific conferences)
+- Account-level data signal (vendor footprint, hiring pattern, public infrastructure)
+- Conversational signal (specific Slack/Discord communities, specific subreddits)
+
+## Onlyness Statement (positioning frame)
+
+The Onlyness frame forces a single defensible sentence:
+
+> **We are the only [category] that [unique mechanism] for [ICP] who want [outcome].**
+
+Worked example:
+> "We are the only AI agent orchestration system that ships behavioral compliance telemetry baked into the runtime for technical founders who want measurable governance instead of vibes-based discipline."
+
+The statement must pass three tests:
+1. **Substitution test** — replace your name with a competitor's. Does the sentence still hold? If yes, the positioning isn't defensible.
+2. **Customer-articulation test** — would a current customer say this sentence back unprompted in roughly these words?
+3. **Mechanism test** — is "unique mechanism" a verifiable specific (a feature, a method, a metric) or marketing prose (an adjective, a vibe)?
+
+## 6 GTM Motions (pick primary + assist)
+
+Each motion has a default ICP shape and a default channel mix. Mixing motions without understanding the constraints below produces zero-momentum GTM.
+
+| Motion | Default ICP | Default Channels | Velocity | Typical CAC payback |
+|---|---|---|---|---|
+| **Product-Led (PLG)** | High-volume, low-ticket, self-serve adoption pattern | SEO + integrations + viral loops + product itself | Fast (weeks to first value) | 6-12 months |
+| **Sales-Led (SLG)** | Enterprise, committee buying, regulated industries | Outbound + content + events + partner channel | Slow (months to close) | 12-18 months |
+| **Community-Led** | High-affinity practitioners, identity-driven adoption | Owned community + open source + advocate program | Medium (compounds quarterly) | Variable (community creates own loop) |
+| **Partner-Led** | Vertical specialists, complex installs, system integrator channel | Channel partnerships + reseller program + co-marketing | Slow start, faster scale | 9-18 months |
+| **Inbound** | Information-seeking buyers researching solutions | SEO + content marketing + comparison content + reviews | Medium (3-6 month ramp) | 6-12 months |
+| **Outbound** | Identified buyer set, account-based targeting | Cold email + cold call + LinkedIn + ABM | Fast pipeline, slow trust | 12-24 months |
+
+The MOVE framework (Sangram Vajre): **M**arkets (who you're selling into), **O**perations (your repeatable engine), **V**elocity (deal cycle + expansion math), **E**xpansion (NRR > 110% target).
+
+## Channel-Motion Matrix
+
+```
+                  Content/SEO   Paid   Community   Partner   Event   Outbound
+Product-Led          ✓✓✓         ✓✓     ✓✓✓          ✓        ✓       —
+Sales-Led            ✓✓          ✓✓     ✓            ✓✓✓      ✓✓✓     ✓✓✓
+Community-Led        ✓✓✓         —      ✓✓✓✓         ✓✓       ✓✓      —
+Partner-Led          ✓           ✓      ✓            ✓✓✓✓     ✓✓✓     ✓✓
+Inbound              ✓✓✓✓        ✓✓✓    ✓✓           ✓        ✓✓      —
+Outbound             ✓✓          ✓      ✓            ✓✓       ✓✓      ✓✓✓✓
+```
+
+Pick exactly ONE primary channel that gets 50%+ of budget. Add at most TWO assist channels. More channels = no channel.
+
+## 90-Day Execution Plan Template
+
+Plan structure (every plan must follow this shape):
+
+```
+Week 1-2: Foundation
+  - [Owner] ICP doc validated with 5 customer conversations
+  - [Owner] Positioning statement live on homepage
+  - [Owner] Tracking baseline measured (current AARRR rates)
+
+Week 3-4: Channel Activation (primary)
+  - [Owner] First 4 [channel-native content units] published
+  - [Owner] Conversion tracking live, first signals captured
+  - [Owner] Sales playbook v1 written for inbound responses
+
+Week 5-8: Iteration
+  - [Owner] Top-funnel CAC measured, channel ROI computed
+  - [Owner] Pricing test A/B started
+  - [Owner] First 10 customer interviews completed and tagged
+  - [Owner] Assist channels activated based on primary signal
+
+Week 9-12: Scale Decision
+  - [Owner] Channel-mix review — double down or pivot
+  - [Owner] First retention cohort analysis (D7, D30)
+  - [Owner] Next-90-day plan written based on real data
+```
+
+Every line must have: owner name, measurable output, due date.
+
+## Executive Summary (1-page, mandatory output)
+
+The full GTM package is dense. The 1-page exec summary captures:
+
+```
+Product:             [name]
+ICP:                 [one sentence: who, where, what pain]
+Positioning:         [Onlyness sentence]
+Primary Motion:      [name + why this one]
+Primary Channel:     [name + 90-day budget]
+North Star Metric:   [the one number that, if it moves, the strategy works]
+Day-90 Target:       [specific number tied to North Star Metric]
+Top Risk:            [what would invalidate this strategy + mitigation]
+```
+
+If the executive summary doesn't fit on one printable page, the strategy is overcomplicated.
+
+## Output → Obsidian: `WizardingCode/GTM/<product>-<date>/`
+
+Delivers: ICP profile + positioning statement + motion selection + channel mix + 90-day plan + executive summary. Plus the cross-departmental review trail (Strategy + Brand + Marketing + Sales + Landing signatures from each phase gate).

package/departments/saas/workflows/gtm-strategy.yaml

@@ -0,0 +1,144 @@
+id: saas-gtm-strategy
+name: GTM Strategy (Cross-Departmental)
+description: Full go-to-market strategy from ICP to 90-day execution plan, orchestrating SaaS + Strategy + Marketing + Sales + Landing
+department: saas
+tier: enterprise
+command: "/saas gtm"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: GTM Brief
+    description: Define product, current stage, available budget/runway, and success metric
+    agents:
+      - agent_id: saas-strategist-tiago
+        role: Frame product context, current ARR/MRR, runway, win condition for the launch
+    gate:
+      type: user_approval
+      description: User confirms product context, budget, and success metric
+
+  - id: icp-discovery
+    name: ICP Discovery
+    description: Define Ideal Customer Profile from existing user data and competitor analysis
+    agents:
+      - agent_id: strategy-director-tomas
+        role: ICP framework — firmographics, technographics, pain triggers, buying committee
+        parallel: true
+      - agent_id: saas-strategist-tiago
+        role: Current-user pattern extraction, look-alike modeling, willingness-to-pay signals
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves the ICP (firmographics + persona + pain triggers + buying signal)
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/GTM/ICP/"
+        description: ICP profile with persona card, pain triggers, buying signals
+
+  - id: positioning
+    name: Positioning Statement
+    description: Position the product in the ICP's mental category using Ries/Trout template + Onlyness frame
+    agents:
+      - agent_id: brand-strategist-mateus
+        role: Onlyness statement (only X that Y for Z), category creation vs category capture analysis
+      - agent_id: strategy-director-tomas
+        role: Competitive contrast — 3-5 direct competitors with relative positioning
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves positioning (one-sentence + competitive contrast)
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/GTM/Positioning/"
+        description: Positioning statement + competitive contrast table
+
+  - id: motion-selection
+    name: GTM Motion Selection
+    description: Pick the primary motion (PLG / SLG / community / partner / inbound / outbound) and the assist motion
+    agents:
+      - agent_id: saas-strategist-tiago
+        role: Apply Sangram Vajre's MOVE framework — Markets, Operations, Velocity, Expansion
+      - agent_id: sales-director-miguel
+        role: Sales motion feasibility — pipeline math, CAC payback, win-rate baseline
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves primary motion + assist motion + 90-day target velocity
+
+  - id: channel-mix
+    name: Channel Mix
+    description: Map motion to channels — content / paid / community / partnerships / events / outbound — with budget allocation
+    agents:
+      - agent_id: marketing-director-luna
+        role: Channel mix design with AARRR baseline, growth loop selection
+      - agent_id: conversion-strategist-ines
+        role: Landing surface design per channel (one URL per channel intent)
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves channel allocation and budget split
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/GTM/Channels/"
+        description: Channel mix with budget allocation and AARRR baseline
+
+  - id: ninety-day-plan
+    name: 90-Day Execution Plan
+    description: Concrete week-by-week deliverables, owners, success metrics — first 90 days
+    agents:
+      - agent_id: saas-strategist-tiago
+        role: Week-by-week deliverable plan with named owners and weekly checkpoints
+      - agent_id: marketing-director-luna
+        role: Marketing-side deliverables (content cadence, paid ramp, community)
+        parallel: true
+      - agent_id: sales-director-miguel
+        role: Sales-side deliverables (outbound cadence, demo book rate target)
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves the 90-day plan before Quality Gate
+
+  - id: self-critique
+    name: Self-Critique
+    description: Stress-test the plan — is the motion-channel-budget triple internally consistent? Are weekly checkpoints measurable?
+    agents:
+      - agent_id: strategy-director-tomas
+        role: Strategic coherence check — motion ↔ ICP ↔ positioning ↔ channels alignment
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    model_override: opus
+    description: Mandatory quality review
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: ICP language, positioning prose, plan readability — no clichés
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Plan executability — every action has an owner, a date, a metric
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: GTM Package Delivery
+    description: Compile the full GTM package and produce the 1-page executive summary
+    agents:
+      - agent_id: saas-strategist-tiago
+        role: Full GTM package compilation + 1-page executive summary
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/GTM/"
+        description: Complete GTM package — ICP + positioning + motion + channel mix + 90-day plan + executive summary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "2.49.0",
+  "version": "2.51.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "2.49.0"
+version = "2.51.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}