arkaos 2.0.0-alpha.1

package/departments/marketing/skills/programmatic-seo/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: mkt/programmatic-seo
+description: >
+  Build SEO-optimized pages at scale using templates and data.
+  12 playbooks: Templates, Curation, Conversions, Comparisons, Examples,
+  Locations, Personas, Integrations, Glossary, Translations, Directory, Profiles.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Programmatic SEO — `/mkt programmatic-seo <niche>`
+
+> **Agent:** Luna (Marketing Lead) | **Frameworks:** Programmatic SEO, Topic Clusters, E-E-A-T
+
+## The 12 Playbooks
+
+| Playbook | Keyword Pattern | Example |
+|----------|----------------|---------|
+| Templates | "[type] template" | "resume template" |
+| Curation | "best [category]" | "best website builders" |
+| Conversions | "[X] to [Y]" | "$10 USD to GBP" |
+| Comparisons | "[X] vs [Y]" | "webflow vs wordpress" |
+| Examples | "[type] examples" | "landing page examples" |
+| Locations | "[service] in [location]" | "dentists in austin" |
+| Personas | "[product] for [audience]" | "crm for real estate" |
+| Integrations | "[A] + [B] integration" | "slack asana integration" |
+| Glossary | "what is [term]" | "what is pSEO" |
+| Translations | Content in multiple languages | Localized pages |
+| Directory | "[category] tools" | "ai copywriting tools" |
+| Profiles | "[entity name]" | "stripe ceo" |
+
+## Playbook Selection
+
+| If You Have... | Use Playbook |
+|----------------|--------------|
+| Proprietary data | Directories, Profiles |
+| Product with integrations | Integrations |
+| Design/creative product | Templates, Examples |
+| Multi-segment audience | Personas |
+| Local presence | Locations |
+| Tool or utility product | Conversions |
+| Content/expertise | Glossary, Curation |
+| Competitor landscape | Comparisons |
+
+## Data Defensibility Hierarchy
+
+1. **Proprietary** — you created it (strongest)
+2. **Product-derived** — from your users
+3. **User-generated** — your community
+4. **Licensed** — exclusive access
+5. **Public** — anyone can use (weakest, thin-content risk)
+
+## Implementation Steps
+
+1. **Keyword pattern research** — identify repeating structure, variables, volume distribution
+2. **Validate demand** — aggregate volume, head vs long-tail, trend direction
+3. **Data source audit** — first-party, scraped, licensed, public? Update frequency?
+4. **Template design** — unique intro per page, conditional content, original insights
+5. **Internal linking** — hub-and-spoke model, breadcrumbs, no orphan pages
+6. **Indexation strategy** — prioritize high-volume, noindex thin variations, separate sitemaps
+7. **Launch and monitor** — track indexation rate, rankings, traffic, conversions
+
+## Template Page Structure
+
+- [ ] Header with target keyword naturally placed
+- [ ] Unique intro (not just variable-swapped boilerplate)
+- [ ] Data-driven sections with conditional content
+- [ ] Related pages / internal cross-links
+- [ ] CTAs appropriate to search intent
+- [ ] Schema markup (FAQ, Product, LocalBusiness as relevant)
+
+## Pre-Launch Checklist
+
+- [ ] Each page provides unique value beyond variable substitution
+- [ ] Unique title tags and meta descriptions per page
+- [ ] Proper heading hierarchy (H1 > H2 > H3)
+- [ ] Schema markup implemented
+- [ ] Pages connected to site architecture (no orphans)
+- [ ] XML sitemap generated and submitted
+- [ ] Core Web Vitals passing (LCP < 2.5s, CLS < 0.1)
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Thin content (just swapping city names) | Add unique data/insights per page |
+| Keyword cannibalization | One primary keyword per page, clear hierarchy |
+| Over-generation (no search demand) | Validate volume before building |
+| Poor data quality | Automate data freshness checks |
+| Ignoring UX (pages for Google, not users) | Test with real users before scaling |
+
+## Proactive Triggers
+
+Surface these issues WITHOUT being asked:
+
+- <50 pages generated → flag insufficient scale for SEO impact
+- No canonical tags → flag duplicate content penalty risk
+- Thin content pages (<300 words) → flag quality penalty risk
+
+## Output
+
+```markdown
+## Programmatic SEO Strategy — [Niche]
+
+**Playbook:** [Selected playbook]
+**Keyword pattern:** [pattern] | **Estimated pages:** [N]
+**Data source:** [type] | **Defensibility:** [tier]
+
+### Opportunity Analysis
+| Pattern | Est. Volume | Data Source | Difficulty |
+|---------|-------------|-------------|------------|
+
+### Page Template Spec
+- URL: /[hub]/[variable]/
+- Title: [template]
+- Meta: [template]
+- Content blocks: [list]
+
+### Pre-Launch Checklist
+[checkbox items]
+
+### Monitoring Plan
+| Metric | Tool | Threshold | Review Cadence |
+```

package/departments/marketing/skills/seo-audit/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: mkt/seo-audit
+description: >
+  Full SEO audit covering technical SEO, on-page, content gaps, and link profile.
+  Uses Pillar-Cluster model, E-E-A-T, and Core Web Vitals.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# SEO Audit — `/mkt seo audit <url>`
+
+> **Agent:** Ana (SEO Specialist) | **Frameworks:** Pillar-Cluster, E-E-A-T, CWV
+
+## Audit Sections
+
+### 1. Technical SEO
+- [ ] Core Web Vitals (LCP < 2.5s, INP < 200ms, CLS < 0.1)
+- [ ] Mobile-first responsive
+- [ ] XML sitemap present and submitted
+- [ ] robots.txt correctly configured
+- [ ] HTTPS everywhere (no mixed content)
+- [ ] Canonical tags on all pages
+- [ ] Structured data (Schema.org) on key pages
+- [ ] No broken links (404s)
+- [ ] Crawl budget efficient (no infinite pagination, no duplicate)
+
+### 2. On-Page SEO
+- [ ] Title tags: unique, under 60 chars, keyword in first half
+- [ ] Meta descriptions: unique, under 160 chars, includes CTA
+- [ ] H1: one per page, includes primary keyword
+- [ ] H2-H6: logical hierarchy, includes secondary keywords
+- [ ] Internal linking: 3-5 relevant internal links per page
+- [ ] Image alt text: descriptive, includes keyword where natural
+- [ ] URL structure: short, descriptive, kebab-case
+
+### 3. Content Strategy
+- [ ] Pillar pages identified for core topics
+- [ ] Cluster content links back to pillar
+- [ ] Content gaps: keywords competitors rank for but we don't
+- [ ] Content freshness: key pages updated in last 6 months
+- [ ] E-E-A-T: Experience, Expertise, Authoritativeness, Trustworthiness signals
+
+### 4. Link Profile
+- [ ] Domain authority/rating baseline
+- [ ] Top referring domains quality
+- [ ] Toxic backlink identification
+- [ ] Link building opportunities (Skyscraper candidates)
+
+## Output → Obsidian: `WizardingCode/Marketing/SEO/AUDIT-<domain>-<date>.md`

package/departments/marketing/skills/social-strategy/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: mkt/social-strategy
+description: >
+  Social media strategy: platform selection, content themes, posting cadence, engagement plan.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Social Strategy — `/mkt social <topic>`
+
+> **Agent:** Luna (Marketing Director) | **Framework:** STEPPS + Platform-Native Content
+
+## What It Does
+
+Social media strategy: platform selection, content themes, posting cadence, engagement plan.
+
+## Output
+
+Social strategy doc with content calendar, platform specs, and KPIs

package/departments/marketing/squad.yaml

@@ -0,0 +1,39 @@
+id: marketing-squad
+name: Marketing & Growth Squad
+description: Full-stack growth team with SEO, paid, content, and analytics capabilities
+department: marketing
+squad_type: department
+topology: stream-aligned
+
+skills_prefix: "/mkt"
+obsidian_path: "WizardingCode/Marketing/"
+quality_gate_required: true
+max_size: 6
+
+members:
+  - agent_id: marketing-director-luna
+    role: Growth strategy, channel mix, budget allocation
+    is_lead: true
+  - agent_id: seo-specialist-ana
+    role: Organic search, keyword strategy, technical SEO
+  - agent_id: paid-specialist-pedro
+    role: Paid acquisition, ROAS optimization, creative testing
+  - agent_id: content-marketer-mariana
+    role: Content strategy, blog, email, social content
+
+workflows:
+  - workflow_id: mkt-social
+    trigger_command: "/mkt social"
+    tier: focused
+  - workflow_id: mkt-seo-audit
+    trigger_command: "/mkt seo audit"
+    tier: focused
+  - workflow_id: mkt-campaign
+    trigger_command: "/mkt paid"
+    tier: enterprise
+  - workflow_id: mkt-email
+    trigger_command: "/mkt email sequence"
+    tier: focused
+  - workflow_id: mkt-content
+    trigger_command: "/mkt content"
+    tier: focused

package/departments/marketing/workflows/campaign.yaml

@@ -0,0 +1,112 @@
+id: mkt-campaign
+name: Marketing Campaign
+description: Full marketing campaign from brief to delivery
+department: marketing
+tier: enterprise
+command: "/mkt paid"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Campaign Brief
+    description: Clarify campaign goals, audience, budget, channels
+    agents:
+      - agent_id: marketing-director-luna
+        role: Define campaign strategy and success metrics
+    gate:
+      type: user_approval
+      description: User confirms campaign brief and budget
+
+  - id: research
+    name: Challenge & Research
+    description: Analyze competitors, audience data, channel performance
+    agents:
+      - agent_id: seo-specialist-ana
+        role: Organic opportunity analysis
+        parallel: true
+      - agent_id: paid-specialist-pedro
+        role: Paid channel benchmarks and budget allocation
+        parallel: true
+      - agent_id: strategy-director-tomas
+        role: Strategic positioning check
+        parallel: true
+    gate:
+      type: user_approval
+      description: User approves research findings and approach
+
+  - id: planning
+    name: Campaign Planning
+    description: Content calendar, ad creatives, email sequences, landing pages
+    agents:
+      - agent_id: marketing-director-luna
+        role: Overall campaign plan with timeline
+      - agent_id: content-marketer-mariana
+        role: Content calendar and copy briefs
+    gate:
+      type: auto
+
+  - id: execution
+    name: Campaign Execution
+    description: Create all campaign assets
+    agents:
+      - agent_id: content-marketer-mariana
+        role: Blog posts, social content, email copy
+        parallel: true
+      - agent_id: paid-specialist-pedro
+        role: Ad creatives, targeting, budget setup
+        parallel: true
+      - agent_id: seo-specialist-ana
+        role: SEO content and on-page optimization
+        parallel: true
+    gate:
+      type: auto
+
+  - id: self-critique
+    name: Self-Critique
+    description: Review all assets against AARRR metrics and brand voice
+    agents:
+      - agent_id: marketing-director-luna
+        role: Campaign coherence and metric alignment review
+    gate:
+      type: auto
+
+  - id: supervision
+    name: Supervision
+    description: Senior review of campaign strategy and assets
+    agents:
+      - agent_id: cto-marco
+        role: Technical feasibility check (if landing pages/tracking involved)
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Mandatory quality review before delivery
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: All copy quality, tone, grammar, AI pattern check
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Tracking setup, landing page UX, technical quality
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Save all assets to Obsidian, present campaign to user
+    agents:
+      - agent_id: marketing-director-luna
+        role: Final campaign package delivery
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Marketing/Campaigns/"
+        description: Complete campaign plan with all assets

package/departments/marketing/workflows/social.yaml

@@ -0,0 +1,56 @@
+id: mkt-social
+name: Social Media Content
+description: Create social media content with platform-native formatting
+department: marketing
+tier: focused
+command: "/mkt social"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Content Brief
+    description: Define topic, platforms, audience, tone
+    agents:
+      - agent_id: marketing-director-luna
+        role: Define content angle and platform selection
+    gate:
+      type: user_approval
+      description: User confirms topic and platforms
+
+  - id: create
+    name: Content Creation
+    description: Write platform-native content
+    agents:
+      - agent_id: content-marketer-mariana
+        role: Write posts adapted to each platform
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Review content quality
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate review
+      - agent_id: copy-director-eduardo
+        role: Copy quality, tone, grammar, no AI patterns
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Final content ready to publish
+    agents:
+      - agent_id: content-marketer-mariana
+        role: Deliver formatted posts per platform
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Marketing/Social/"
+        description: Social media content pack