arkaos 2.0.0-alpha.1

package/departments/strategy/skills/growth-strategy/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: strat/growth-strategy
+description: >
+  Growth strategy: market penetration, development, product development, diversification.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Growth Strategy — `/strat growth <business>`
+
+> **Agent:** Tomas (Chief Strategist) | **Framework:** Ansoff Matrix + Adjacencies
+
+## What It Does
+
+Growth strategy: market penetration, development, product development, diversification.
+
+## Output
+
+Growth roadmap with Ansoff quadrant, risk assessment, and resource requirements

package/departments/strategy/skills/moat-analysis/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: strat/moat-analysis
+description: >
+  Competitive moat analysis: which of the 7 Powers applies and how durable.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Moat Analysis — `/strat moat <company>`
+
+> **Agent:** Tomas (Chief Strategist) | **Framework:** 7 Powers (Hamilton Helmer)
+
+## What It Does
+
+Competitive moat analysis: which of the 7 Powers applies and how durable.
+
+## Output
+
+Moat assessment with power type, durability score, and strengthening actions

package/departments/strategy/skills/position/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: strat/position
+description: >
+  Competitive positioning: alternatives, unique capabilities, value, target, category.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Position — `/strat position <product>`
+
+> **Agent:** Tomas (Chief Strategist) | **Framework:** Positioning (Ries/Trout) + April Dunford
+
+## What It Does
+
+Competitive positioning: alternatives, unique capabilities, value, target, category.
+
+## Output
+
+Positioning statement + perceptual map + competitive differentiation

package/departments/strategy/skills/scenario-plan/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: strat/scenario-plan
+description: >
+  Scenario planning: 3-5 plausible futures with strategies for each.
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
+---
+
+# Scenario Plan — `/strat scenario <context>`
+
+> **Agent:** Lucas (Market Analyst) | **Framework:** Scenario Planning + PESTLE
+
+## What It Does
+
+Scenario planning: 3-5 plausible futures with strategies for each.
+
+## Output
+
+Scenario matrix with base/optimistic/pessimistic/black swan + action plans

package/departments/strategy/squad.yaml

@@ -0,0 +1,37 @@
+id: strategy-squad
+name: Strategy & Innovation Squad
+description: Competitive analysis, positioning, business model design, scenario planning
+department: strategy
+squad_type: department
+topology: stream-aligned
+
+skills_prefix: "/strat"
+obsidian_path: "WizardingCode/Strategy/"
+quality_gate_required: true
+max_size: 4
+
+members:
+  - agent_id: strategy-director-tomas
+    role: Strategic vision, competitive positioning, market entry
+    is_lead: true
+  - agent_id: market-analyst-lucas
+    role: Market sizing, competitive intelligence, trend analysis
+  - agent_id: business-model-designer-marta-s
+    role: Business model design, value proposition, revenue models
+
+workflows:
+  - workflow_id: strat-analyze
+    trigger_command: "/strat analyze"
+    tier: enterprise
+  - workflow_id: strat-swot
+    trigger_command: "/strat swot"
+    tier: focused
+  - workflow_id: strat-blue-ocean
+    trigger_command: "/strat blue-ocean"
+    tier: enterprise
+  - workflow_id: strat-bmc
+    trigger_command: "/strat bmc"
+    tier: focused
+  - workflow_id: strat-position
+    trigger_command: "/strat position"
+    tier: focused

package/departments/strategy/workflows/analysis.yaml

@@ -0,0 +1,90 @@
+id: strat-analyze
+name: Strategic Analysis
+description: Comprehensive strategic analysis using Porter, Blue Ocean, Wardley, and 7 Powers
+department: strategy
+tier: enterprise
+command: "/strat analyze"
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+
+phases:
+  - id: brief
+    name: Analysis Brief
+    description: Define scope, market, competitors, and key questions
+    agents:
+      - agent_id: strategy-director-tomas
+        role: Frame the strategic question and analysis scope
+    gate:
+      type: user_approval
+      description: User confirms analysis scope
+
+  - id: research
+    name: Multi-Framework Research
+    description: 5 parallel analysis agents each applying a different framework
+    agents:
+      - agent_id: market-analyst-lucas
+        role: "Porter's Five Forces + TAM/SAM/SOM"
+        parallel: true
+      - agent_id: business-model-designer-marta-s
+        role: "Business Model Canvas + Value Proposition Canvas"
+        parallel: true
+      - agent_id: strategy-director-tomas
+        role: "Blue Ocean Strategy Canvas + ERRC Grid"
+        parallel: true
+    gate:
+      type: auto
+
+  - id: synthesis
+    name: Strategic Synthesis
+    description: Synthesize all frameworks into unified strategic picture
+    agents:
+      - agent_id: strategy-director-tomas
+        role: Synthesize findings, identify key strategic moves
+    gate:
+      type: user_approval
+      description: User reviews synthesis and strategic recommendations
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Strategy/Analysis/"
+        description: Strategic Analysis report
+
+  - id: self-critique
+    name: Self-Critique
+    description: Devil's advocate review of strategic recommendations
+    agents:
+      - agent_id: market-analyst-lucas
+        role: Challenge assumptions, identify blind spots, stress-test
+    gate:
+      type: auto
+
+  - id: quality-gate
+    name: Quality Gate
+    description: Quality review of analysis quality and accuracy
+    agents:
+      - agent_id: cqo-marta
+        role: Orchestrate quality review
+      - agent_id: copy-director-eduardo
+        role: Report clarity, language quality
+        parallel: true
+      - agent_id: tech-director-francisca
+        role: Data accuracy, logical consistency
+        parallel: true
+    gate:
+      type: quality_gate
+      required_verdict: APPROVED
+
+  - id: delivery
+    name: Delivery
+    description: Save to Obsidian with actionable recommendations
+    agents:
+      - agent_id: strategy-director-tomas
+        role: Final strategic report delivery
+    gate:
+      type: auto
+    outputs:
+      - type: document
+        format: markdown
+        obsidian_path: "WizardingCode/Strategy/"
+        description: Strategic Analysis with recommendations

package/departments/strategy/workflows/swot.yaml

@@ -0,0 +1,47 @@
+id: strat-swot
+name: SWOT Analysis
+department: strategy
+tier: focused
+command: /strat swot
+requires_branch: false
+requires_spec: false
+quality_gate_required: true
+description: 'SWOT analysis: Strengths, Weaknesses, Opportunities, Threats'
+phases:
+- id: brief
+  name: Analysis Brief
+  agents:
+  - agent_id: strategy-director-tomas
+    role: Define scope and context
+  gate:
+    type: user_approval
+    description: User confirms scope
+- id: analyze
+  name: SWOT Analysis
+  agents:
+  - agent_id: market-analyst-lucas
+    role: Internal (S/W) and external (O/T) analysis
+  gate:
+    type: auto
+- id: quality-gate
+  name: Quality Gate
+  agents:
+  - agent_id: cqo-marta
+    role: Orchestrate review
+  - agent_id: tech-director-francisca
+    role: Data accuracy and logic
+    parallel: true
+  gate:
+    type: quality_gate
+    required_verdict: APPROVED
+- id: delivery
+  name: Delivery
+  agents:
+  - agent_id: strategy-director-tomas
+    role: SWOT report with strategic implications
+  gate:
+    type: auto
+  outputs:
+  - type: document
+    format: markdown
+    obsidian_path: WizardingCode/Strategy/SWOT/

package/installer/adapters/claude-code.js

@@ -0,0 +1,73 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+export default {
+  configureHooks(config, installDir) {
+    const settingsPath = config.settingsFile;
+
+    // Ensure settings directory exists
+    mkdirSync(dirname(settingsPath), { recursive: true });
+
+    // Load existing settings (merge, don't overwrite)
+    let settings = {};
+    if (existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+      } catch {
+        // Backup corrupted settings
+        const backup = settingsPath + ".bak";
+        try { writeFileSync(backup, readFileSync(settingsPath)); } catch {}
+        settings = {};
+      }
+    }
+
+    const hooksDir = join(installDir, "config", "hooks");
+
+    // Configure hooks (ArkaOS hooks only — preserve user's other hooks)
+    if (!settings.hooks) {
+      settings.hooks = {};
+    }
+
+    // UserPromptSubmit — Synapse v2 context injection
+    settings.hooks.UserPromptSubmit = [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: join(hooksDir, "user-prompt-submit.sh"),
+            timeout: 10,
+          },
+        ],
+      },
+    ];
+
+    // PostToolUse — Error tracking
+    settings.hooks.PostToolUse = [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: join(hooksDir, "post-tool-use.sh"),
+            timeout: 5,
+          },
+        ],
+      },
+    ];
+
+    // PreCompact — Session digest
+    settings.hooks.PreCompact = [
+      {
+        hooks: [
+          {
+            type: "command",
+            command: join(hooksDir, "pre-compact.sh"),
+            timeout: 30,
+          },
+        ],
+      },
+    ];
+
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    console.log("         Claude Code hooks configured.");
+  },
+};

package/installer/adapters/codex-cli.js

@@ -0,0 +1,34 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+
+export default {
+  configureHooks(config, installDir) {
+    // Codex CLI uses AGENTS.md for instructions
+    const agentsPath = join(config.configDir, "AGENTS.md");
+
+    // Create reference to ArkaOS instructions
+    const arkaosRef = `# ArkaOS v2 Configuration
+
+> Auto-generated by ArkaOS installer. Do not edit manually.
+
+## System Instructions
+
+ArkaOS is installed at: ${installDir}
+Load instructions from: ${join(installDir, "config", "codex-instructions.md")}
+
+## Available Commands
+
+Use natural language or prefix commands:
+- /do <description> — Universal orchestrator
+- /dev, /mkt, /fin, /strat, /brand, /ops, /ecom, /kb, /saas, /landing, /community, /content
+
+## Hooks
+
+Codex CLI does not support native hooks. Context is injected via instruction files.
+`;
+
+    mkdirSync(config.configDir, { recursive: true });
+    writeFileSync(agentsPath, arkaosRef);
+    console.log("         Codex CLI AGENTS.md configured.");
+  },
+};

package/installer/adapters/cursor.js

@@ -0,0 +1,34 @@
+import { existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+
+export default {
+  configureHooks(config, installDir) {
+    // Cursor uses .cursorrules for project-level instructions
+    // and .cursor/rules for global rules
+    const rulesDir = join(config.configDir, "rules");
+    mkdirSync(rulesDir, { recursive: true });
+
+    const arkaosRule = `# ArkaOS v2 Configuration
+
+ArkaOS is installed at: ${installDir}
+
+## Instructions
+
+You are running inside ArkaOS — The Operating System for AI Agent Teams.
+Load full instructions from: ${join(installDir, "config", "cursor-instructions.md")}
+
+## Available Commands
+
+Use natural language or prefix commands:
+- /do <description> — Universal orchestrator
+- /dev, /mkt, /fin, /strat, /brand, /ops, /ecom, /kb, /saas, /landing, /community, /content
+
+## Agent System
+
+ArkaOS has 62 specialized agents across 16 departments. Each request is routed to the appropriate squad.
+`;
+
+    writeFileSync(join(rulesDir, "arkaos.md"), arkaosRule);
+    console.log("         Cursor rules configured.");
+  },
+};

package/installer/adapters/gemini-cli.js

@@ -0,0 +1,37 @@
+import { existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+
+export default {
+  configureHooks(config, installDir) {
+    // Gemini CLI uses GEMINI.md for instructions
+    const geminiMdPath = join(config.configDir, "GEMINI.md");
+
+    const arkaosRef = `# ArkaOS v2 Configuration
+
+> Auto-generated by ArkaOS installer. Do not edit manually.
+
+## System Instructions
+
+ArkaOS is installed at: ${installDir}
+Load instructions from: ${join(installDir, "config", "gemini-instructions.md")}
+
+## Available Commands
+
+Use natural language or prefix commands:
+- /do <description> — Universal orchestrator
+- /dev, /mkt, /fin, /strat, /brand, /ops, /ecom, /kb, /saas, /landing, /community, /content
+
+## Tool Mapping
+
+Gemini CLI tools map to ArkaOS tools:
+- activate_skill → Skill invocation
+- read_file → Read
+- edit_file → Edit
+- run_command → Bash
+`;
+
+    mkdirSync(config.configDir, { recursive: true });
+    writeFileSync(geminiMdPath, arkaosRef);
+    console.log("         Gemini CLI GEMINI.md configured.");
+  },
+};

package/installer/cli.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+import { parseArgs } from "node:util";
+import { install } from "./index.js";
+import { detectRuntime } from "./detect-runtime.js";
+
+const { values, positionals } = parseArgs({
+  options: {
+    help: { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" },
+    runtime: { type: "string", short: "r" },
+    path: { type: "string", short: "p" },
+    force: { type: "boolean", short: "f" },
+  },
+  allowPositionals: true,
+  strict: false,
+});
+
+const VERSION = "2.0.0-alpha.1";
+const command = positionals[0] || "install";
+
+if (values.version) {
+  console.log(`ArkaOS v${VERSION}`);
+  process.exit(0);
+}
+
+if (values.help || command === "help") {
+  console.log(`
+ArkaOS v${VERSION} — The Operating System for AI Agent Teams
+
+Usage:
+  npx arkaos install          Install ArkaOS in current environment
+  npx arkaos install --runtime <runtime>  Install for specific runtime
+  npx arkaos doctor           Run health checks
+  npx arkaos update           Update to latest version
+  npx arkaos uninstall        Remove ArkaOS
+
+Options:
+  -r, --runtime <name>   Target runtime: claude-code, codex, gemini, cursor
+  -p, --path <dir>       Installation directory (default: auto-detect)
+  -f, --force            Force reinstall, overwriting existing files
+  -v, --version          Show version
+  -h, --help             Show this help
+
+Runtimes:
+  claude-code    Anthropic Claude Code CLI
+  codex          OpenAI Codex CLI
+  gemini         Google Gemini CLI
+  cursor         Cursor AI IDE
+
+Examples:
+  npx arkaos install                    Auto-detect runtime and install
+  npx arkaos install --runtime codex    Install for Codex CLI specifically
+  npx arkaos doctor                     Verify installation health
+`);
+  process.exit(0);
+}
+
+async function main() {
+  switch (command) {
+    case "install":
+      const runtime = values.runtime || await detectRuntime();
+      await install({ runtime, path: values.path, force: values.force });
+      break;
+
+    case "doctor":
+      const { doctor } = await import("./doctor.js");
+      await doctor();
+      break;
+
+    case "update":
+      const { update } = await import("./update.js");
+      await update();
+      break;
+
+    case "uninstall":
+      const { uninstall } = await import("./uninstall.js");
+      await uninstall();
+      break;
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      console.error('Run "npx arkaos help" for usage information.');
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error("Error:", err.message);
+  process.exit(1);
+});

package/installer/detect-runtime.js

@@ -0,0 +1,122 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+const RUNTIMES = [
+  {
+    id: "claude-code",
+    name: "Claude Code",
+    detect: () => {
+      try {
+        execSync("claude --version", { stdio: "pipe" });
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    configDir: () => join(homedir(), ".claude"),
+    skillsDir: () => join(homedir(), ".claude", "skills"),
+    settingsFile: () => join(homedir(), ".claude", "settings.json"),
+  },
+  {
+    id: "codex",
+    name: "Codex CLI",
+    detect: () => {
+      try {
+        execSync("codex --version", { stdio: "pipe" });
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    configDir: () => join(homedir(), ".codex"),
+    skillsDir: () => join(homedir(), ".codex", "skills"),
+    settingsFile: () => join(homedir(), ".codex", "settings.json"),
+  },
+  {
+    id: "gemini",
+    name: "Gemini CLI",
+    detect: () => {
+      try {
+        execSync("gemini --version", { stdio: "pipe" });
+        return true;
+      } catch {
+        return existsSync(join(homedir(), ".gemini"));
+      }
+    },
+    configDir: () => join(homedir(), ".gemini"),
+    skillsDir: () => join(homedir(), ".gemini", "skills"),
+    settingsFile: () => join(homedir(), ".gemini", "settings.json"),
+  },
+  {
+    id: "cursor",
+    name: "Cursor",
+    detect: () => {
+      try {
+        execSync("cursor --version", { stdio: "pipe" });
+        return true;
+      } catch {
+        const cursorPaths = [
+          join(homedir(), ".cursor"),
+          "/Applications/Cursor.app",
+          join(homedir(), "AppData", "Local", "Programs", "cursor"),
+        ];
+        return cursorPaths.some((p) => existsSync(p));
+      }
+    },
+    configDir: () => join(homedir(), ".cursor"),
+    skillsDir: () => join(homedir(), ".cursor", "skills"),
+    settingsFile: () => join(homedir(), ".cursor", "settings.json"),
+  },
+];
+
+export async function detectRuntime() {
+  console.log("Detecting AI runtime...\n");
+
+  const detected = [];
+  for (const runtime of RUNTIMES) {
+    if (runtime.detect()) {
+      detected.push(runtime);
+      console.log(`  Found: ${runtime.name}`);
+    }
+  }
+
+  if (detected.length === 0) {
+    console.error(
+      "\nNo supported AI runtime detected.\n" +
+        "Install one of: Claude Code, Codex CLI, Gemini CLI, or Cursor\n" +
+        "Or specify manually: npx arkaos install --runtime claude-code"
+    );
+    process.exit(1);
+  }
+
+  if (detected.length === 1) {
+    console.log(`\nUsing: ${detected[0].name}\n`);
+    return detected[0].id;
+  }
+
+  console.log(`\nMultiple runtimes found. Using: ${detected[0].name}`);
+  console.log(
+    `To install for a different runtime: npx arkaos install --runtime <name>\n`
+  );
+  return detected[0].id;
+}
+
+export function getRuntimeConfig(runtimeId) {
+  const runtime = RUNTIMES.find((r) => r.id === runtimeId);
+  if (!runtime) {
+    throw new Error(
+      `Unknown runtime: ${runtimeId}. Supported: ${RUNTIMES.map((r) => r.id).join(", ")}`
+    );
+  }
+  return {
+    id: runtime.id,
+    name: runtime.name,
+    configDir: runtime.configDir(),
+    skillsDir: runtime.skillsDir(),
+    settingsFile: runtime.settingsFile(),
+  };
+}
+
+export { RUNTIMES };