organtic 1.3.0 → 3.0.0

package/README.md

@@ -1,149 +1,174 @@
 # Organtic
 
-> Most founders fail not from bad ideas, but from the gap between knowing what to build and actually building it. Organtic closes that gap.
+**The AI-native organization. 25 experts from idea to launch.**
 
-**25 specialized AI agents organized into 8 independent plugins** that work alone or chain together into a complete idea-to-execution pipeline. Each agent brings deep framework expertise — not generic advice, but proven methodologies that top strategists and builders actually use.
+Organtic plugs a team of specialized AI agents into [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Each agent applies named frameworks — Osterwalder VPC, Hormozi Value Equation, Reforge Growth Loops — not generic advice. Run them individually, as coordinated Agent Teams, or chain them into a full strategy pipeline.
 
-## The Problem
-
-You have an idea. Now what?
+```
+npx organtic
+```
 
-Validation needs value proposition mapping and jobs-to-be-done analysis. Product strategy needs growth loops and product operating models. Go-to-market needs offer design, conversion copywriting, funnel architecture, and paid media planning. Then you still need to build the landing page, write the pitch deck, design the slides, and record the demo.
+```
+EXPLORE                                        EXPLOIT
+validate  >  build  >  launch                  craft  document  present  studio
+3 experts    5 experts   7 experts             4 agents  2 agents  1 agent  3 agents
+```
 
-That's 23 different disciplines. No solo founder or small team has all of them.
+---
 
-## The Solution
+## Install
 
-```
+```bash
+# Interactive installer (recommended)
 npx organtic
+
+# Or add the marketplace directly in Claude Code
+/plugin marketplace add Adanmohh/organtic
 ```
 
-One command. Pick the plugins you need. Each one works independently — or chain them all together.
+Then start Claude Code. Plugins auto-install on first launch.
 
-```
-STRATEGY PIPELINE                              EXECUTION PLUGINS
-validate  >  build  >  launch                  craft | document | present | studio
-3 experts    4 experts   7 experts              4 agents  2 agents   1 agent   3 agents
-```
+## Usage
+
+```bash
+# Single expert
+/value-mapper AI tool that helps nurses track patient vitals
 
-**Install one plugin** when you need a specific expert.
-**Install all eight** when you want the full pipeline from idea to shipped product.
+# Full Agent Team (experts run as parallel Claude Code instances)
+/validate:full-team My SaaS idea for project management
 
-## Strategy Pipeline
+# Full pipeline (chains all 15 explore experts)
+/pipeline:run BurnoutLab - AI-powered burnout recovery courses
+```
 
-Three plugins that chain together. Each builds on the previous phase's findings.
+---
 
-### validate — Is this idea worth building?
+## Explore: Strategy Pipeline
 
-3 experts that pressure-test your idea before you write a line of code.
+Three plugins that chain together. Each phase builds on previous findings.
 
-| Expert | What they do | Output |
-|--------|-------------|--------|
-| **Value Mapper** | Maps value propositions against customer jobs, pains, and gains | Value proposition canvas, customer segments |
-| **Business Modeler** | Designs revenue models, competitive positioning, and pricing strategy | Business model canvas, pricing model, blue ocean map |
-| **Experiment Designer** | Designs and prioritizes validation experiments | Prioritized experiment backlog, test designs |
+### validate — Is this worth building?
 
-### build — What exactly should we ship?
+| Expert | Frameworks | Output |
+|--------|-----------|--------|
+| Value Mapper | Osterwalder VPC, Jobs-to-be-Done | Value proposition canvas, customer segments |
+| Business Modeler | Business Model Canvas, Blue Ocean Strategy | Revenue model, competitive positioning |
+| Experiment Designer | Strategyzer Testing, ICE/RICE | Prioritized experiment backlog |
 
-4 experts that turn a validated idea into a buildable product spec.
+### build — What are we shipping?
 
-| Expert | What they do | Output |
-|--------|-------------|--------|
-| **Product Strategist** | Defines product strategy, growth loops, and operating model | Product strategy doc, growth model |
-| **Growth Designer** | Designs retention loops, engagement triggers, and product-led growth | Habit loops, activation flows, retention curves |
-| **Spec Writer** | Shapes buildable specs with clear appetite and scope | Shaped pitches, fat-marker sketches, scope tables |
-| **Product Designer** | Creates accessible UI/UX driven by user jobs and AI interaction patterns | Wireframes, interaction design, component specs |
+| Expert | Frameworks | Output |
+|--------|-----------|--------|
+| Product Strategist | Reforge, Cagan's Transformed | Product strategy, growth loops |
+| Brand Strategist | Neumeier Brand Gap, Design Tokens | Brand identity system |
+| Growth Designer | Torres Discovery, Hooked Model, PLG | Retention loops, activation flows |
+| Spec Writer | Shape Up methodology | Shaped pitches, scope tables |
+| Product Designer | Don Norman, JTBD UX, AI UX Patterns | Wireframes, interaction design |
 
 ### launch — How do we get customers?
 
-7 experts that build your complete go-to-market engine. Runs in three waves: strategy first, coherence audit, then execution.
+| Expert | Frameworks | Output |
+|--------|-----------|--------|
+| Offer Designer | Hormozi Value Equation, Grand Slam Offer | Offer stack, pricing tiers |
+| Copywriter | Copyhackers, Ogilvy, Gary Vee | Landing page copy, email sequences |
+| Funnel Architect | Brunson Value Ladder, Suby 8-Phase | Funnel blueprint, lead magnets |
+| Growth Auditor | Reforge Racecar, Channel-Model Fit | Gap analysis, prioritized roadmap |
+| Media Planner | Dennis Yu Dollar-a-Day, 3x3 Grid | Channel plan, budget allocation |
+| SEO Strategist | CXL Technical SEO, Search Intent Mapping | Keyword map, content clusters |
+| AI Search Optimizer | CXL Entity SEO, LLM Visibility | Entity map, citation strategy |
 
-| Expert | What they do | Output |
-|--------|-------------|--------|
-| **Offer Designer** | Designs irresistible offers with pricing, guarantees, and bonuses | Offer stack, value equation score, pricing tiers |
-| **Copywriter** | Writes conversion copy from voice-of-customer research | Landing page copy, email sequences, ad copy |
-| **Funnel Architect** | Architects conversion funnels with AI-native qualification | Funnel blueprint, lead magnets, email flows |
-| **Growth Auditor** | Audits all strategies for coherence and prioritizes actions | Gap analysis, prioritized roadmap, growth loop map |
-| **Media Planner** | Plans paid media with budget allocation and creative testing | Channel plan, budget splits, ad creative briefs |
-| **SEO Strategist** | Designs search strategy with technical SEO and content architecture | Keyword map, content clusters, technical audit |
-| **AI Search Optimizer** | Optimizes visibility in AI-powered search and assistants | Entity map, structured data plan, citation strategy |
+---
 
-## Execution Plugins
+## Exploit: Execution Plugins
 
-Four plugins that turn strategy into tangible deliverables. Each works standalone.
+Four standalone plugins that turn strategy into deliverables.
 
 ### craft — Build it
 
-| Agent | What it produces |
-|-------|-----------------|
-| **Landing Page Builder** | Deployable, conversion-optimized landing pages (React/HTML) |
-| **MVP Scaffolder** | Full-stack prototypes with auth, database, API, deployment |
-| **Component Designer** | Production-grade UI components with variants and accessibility |
-| **Tester** | Strategy-informed testing with Playwright (persona-based QA) |
+| Agent | Output |
+|-------|--------|
+| Landing Page Builder | Conversion-optimized pages (React/HTML) |
+| MVP Scaffolder | Full-stack prototype with auth, DB, API |
+| Component Designer | Production UI components (React + Tailwind) |
+| Tester | Persona-based QA with Playwright |
 
 ### document — Write it
 
-| Agent | What it produces |
-|-------|-----------------|
-| **Business Writer** | Business plans, SOPs, case studies, executive summaries |
-| **Pitch Deck Writer** | Investor pitch decks, sales proposals (Marp to PDF/PPTX) |
+| Agent | Output |
+|-------|--------|
+| Business Writer | Business plans, SOPs, case studies |
+| Pitch Deck Writer | Investor decks, sales proposals (Marp to PDF) |
 
 ### present — Show it
 
-| Agent | What it produces |
-|-------|-----------------|
-| **Slide Designer** | Professional presentations from any strategy output (Marp markdown) |
+| Agent | Output |
+|-------|--------|
+| Slide Designer | Professional decks from strategy outputs |
 
 ### studio — Film it
 
-| Agent | What it produces |
-|-------|-----------------|
-| **Demo Producer** | Full product demo videos (browser recording + voiceover + composition) |
-| **Clip Maker** | Short social clips for Instagram Reels, TikTok, YouTube Shorts, LinkedIn |
-| **Content Creator** | Branded social media images and short-form videos |
+| Agent | Output |
+|-------|--------|
+| Demo Producer | Product demo videos (Playwright + ElevenLabs + Remotion) |
+| Clip Maker | Social clips for Reels, TikTok, Shorts, LinkedIn |
+| Content Creator | Branded social images and short-form video |
 
-## Orchestration
+---
 
-The **pipeline** plugin chains the strategy plugins into an automated workflow. Start it with `/run My business idea` and it walks you through all 14 strategy experts, each building on previous findings.
+## Pipeline
 
-You can also run any single expert directly:
+The pipeline orchestrator chains all 15 explore experts automatically:
 
 ```
-/value-mapper AI tool that helps nurses track patient vitals
-/copywriter Write landing page copy for our course launch
-/landing-page Build from our strategy outputs
-/pitch-deck Create an investor pitch deck
-/product-demo Record a walkthrough of our web app
+Phase 1: validate         3 experts    Is this worth building?
+Phase 2: build            5 experts    What are we shipping?
+Phase 3: launch-strategy  3 experts    Offer + copy + funnels
+Phase 4: launch-audit     1 expert     Coherence check across all outputs
+Phase 5: launch-execution 3 experts    Media + SEO + AI search
 ```
 
-## Install
+```bash
+/pipeline:run MyProject - description of the idea
+/pipeline:run MyProject --start-phase build    # Resume from a phase
+/pipeline:run MyProject --autonomous           # Research-first mode
+/pipeline:status                               # Check progress
+/pipeline:cancel                               # Stop
+```
+
+---
 
-### Interactive (recommended)
+## Agent Teams
+
+Commands ending in `:full-team` spawn multiple Claude Code instances that coordinate through shared task lists and message each other directly.
 
 ```bash
-npx organtic
+/validate:full-team My idea
+/build:full-team Continue from validation
+/launch:full-team Go to market
 ```
 
-### Direct plugin install
+Requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in `~/.claude/settings.json`.
 
-```bash
-# Everything
-claude plugin install organtic@Adanmohh/organtic
+---
+
+## Cross-Session Memory
 
-# Just what you need
-claude plugin install validate@Adanmohh/organtic
-claude plugin install launch@Adanmohh/organtic
-claude plugin install craft@Adanmohh/organtic
+Each expert outputs project-scoped tags auto-captured by [claude-mem](https://github.com/thedotmack/claude-mem). Later phases search memory by project name to build on earlier findings — no manual copy-pasting between sessions.
+
+```bash
+/plugin install claude-mem@thedotmack
 ```
 
+---
+
 ## Requirements
 
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
-- Optional: [claude-mem](https://github.com/nicobailon/claude-mem) for cross-session memory
-- For studio plugin: Node.js, Playwright, Remotion, ffmpeg, ElevenLabs API key
+- Optional: [claude-mem](https://github.com/thedotmack/claude-mem) for cross-session memory
+- For studio: Node.js, Playwright, Remotion, ffmpeg, ElevenLabs API key
 
 ## Links
 
-- [GitHub](https://github.com/Adanmohh/organtic) | [Issues](https://github.com/Adanmohh/organtic/issues)
+[GitHub](https://github.com/Adanmohh/organtic) | [Issues](https://github.com/Adanmohh/organtic/issues)
 
 MIT License

package/index.mjs

@@ -1,14 +1,12 @@
 #!/usr/bin/env node
 
-import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync, readdirSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 import { createInterface } from "readline";
-import { execSync } from "child_process";
 
 const MARKETPLACE_REPO = "Adanmohh/organtic";
 const MARKETPLACE_NAME = "organtic";
-const GITHUB_URL = `https://github.com/${MARKETPLACE_REPO}.git`;
 
 const PLUGINS = [
   {
@@ -149,161 +147,31 @@ function box(chalk, lines, { title = "", width = 48, borderColor = null } = {})
 }
 
 // ---------------------------------------------------------------------------
-// Path helpers
+// Settings.json management
 // ---------------------------------------------------------------------------
 
-function getClaudeDir() {
-  return join(homedir(), ".claude");
-}
-
-function getPluginsDir() {
-  return join(getClaudeDir(), "plugins");
-}
-
 function getSettingsPath() {
-  return join(getClaudeDir(), "settings.json");
+  return join(homedir(), ".claude", "settings.json");
 }
 
-function getKnownMarketplacesPath() {
-  return join(getPluginsDir(), "known_marketplaces.json");
-}
-
-function getInstalledPluginsPath() {
-  return join(getPluginsDir(), "installed_plugins.json");
-}
-
-function getMarketplacePath() {
-  return join(getPluginsDir(), "marketplaces", MARKETPLACE_NAME);
-}
-
-function getCachePath() {
-  return join(getPluginsDir(), "cache", MARKETPLACE_NAME);
-}
-
-// ---------------------------------------------------------------------------
-// JSON file helpers
-// ---------------------------------------------------------------------------
-
-function readJson(path) {
-  if (!existsSync(path)) return null;
+function readSettings() {
+  const path = getSettingsPath();
+  if (!existsSync(path)) return {};
   try {
     return JSON.parse(readFileSync(path, "utf-8"));
   } catch {
-    return null;
+    return {};
   }
 }
 
-function writeJson(path, data) {
-  const dir = join(path, "..");
+function writeSettings(settings) {
+  const dir = join(homedir(), ".claude");
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
-}
-
-// ---------------------------------------------------------------------------
-// Installation logic
-// ---------------------------------------------------------------------------
-
-function cloneMarketplace() {
-  const marketplacePath = getMarketplacePath();
-
-  if (existsSync(marketplacePath)) {
-    // Pull latest
-    try {
-      execSync("git pull --ff-only", { cwd: marketplacePath, stdio: "pipe" });
-    } catch {
-      // If pull fails, remove and re-clone
-      execSync(`rm -rf "${marketplacePath}"`, { stdio: "pipe" });
-      mkdirSync(join(getPluginsDir(), "marketplaces"), { recursive: true });
-      execSync(`git clone "${GITHUB_URL}" "${marketplacePath}"`, { stdio: "pipe" });
-    }
-  } else {
-    mkdirSync(join(getPluginsDir(), "marketplaces"), { recursive: true });
-    execSync(`git clone "${GITHUB_URL}" "${marketplacePath}"`, { stdio: "pipe" });
-  }
-
-  // Get commit SHA
-  const sha = execSync("git rev-parse HEAD", { cwd: marketplacePath, encoding: "utf-8" }).trim();
-  return sha;
-}
-
-function getPluginVersion(pluginDir) {
-  const manifestPath = join(pluginDir, ".claude-plugin", "plugin.json");
-  const manifest = readJson(manifestPath);
-  return manifest?.version || "1.0.0";
+  writeFileSync(getSettingsPath(), JSON.stringify(settings, null, 2) + "\n");
 }
 
-function cachePlugins(selected, commitSha) {
-  const marketplacePath = getMarketplacePath();
-  const cachePath = getCachePath();
-  const results = [];
-
-  for (const plugin of selected) {
-    const srcDir = join(marketplacePath, "plugins", plugin.name);
-    const version = getPluginVersion(srcDir);
-    const versionSlug = commitSha.substring(0, 12);
-    const destDir = join(cachePath, plugin.name, versionSlug);
-
-    mkdirSync(destDir, { recursive: true });
-    cpSync(srcDir, destDir, { recursive: true });
-
-    results.push({
-      name: plugin.name,
-      version,
-      versionSlug,
-      installPath: destDir,
-      commitSha,
-    });
-  }
-
-  return results;
-}
-
-function updateKnownMarketplaces() {
-  const path = getKnownMarketplacesPath();
-  const data = readJson(path) || {};
-
-  data[MARKETPLACE_NAME] = {
-    source: {
-      source: "github",
-      repo: MARKETPLACE_REPO,
-    },
-    installLocation: getMarketplacePath().replace(/\//g, "\\"),
-    lastUpdated: new Date().toISOString(),
-  };
-
-  writeJson(path, data);
-}
-
-function updateInstalledPlugins(cachedPlugins) {
-  const path = getInstalledPluginsPath();
-  const data = readJson(path) || { version: 2, plugins: {} };
-
-  if (!data.plugins) data.plugins = {};
-  if (!data.version) data.version = 2;
-
-  const now = new Date().toISOString();
-  const projectPath = homedir();
-
-  for (const plugin of cachedPlugins) {
-    const key = `${plugin.name}@${MARKETPLACE_NAME}`;
-    data.plugins[key] = [
-      {
-        scope: "project",
-        installPath: plugin.installPath.replace(/\//g, "\\"),
-        version: plugin.version,
-        installedAt: now,
-        lastUpdated: now,
-        gitCommitSha: plugin.commitSha,
-        projectPath: projectPath.replace(/\//g, "\\"),
-      },
-    ];
-  }
-
-  writeJson(path, data);
-}
-
-function updateSettings(selected) {
-  const settings = readJson(getSettingsPath()) || {};
+function installPlugins(selected, enableAgentTeams = false) {
+  const settings = readSettings();
 
   // Add marketplace
   if (!settings.extraKnownMarketplaces) {
@@ -324,25 +192,15 @@ function updateSettings(selected) {
     settings.enabledPlugins[`${plugin.name}@${MARKETPLACE_NAME}`] = true;
   }
 
-  writeJson(getSettingsPath(), settings);
-}
-
-function installPlugins(selected) {
-  // 1. Clone/update marketplace repo
-  const commitSha = cloneMarketplace();
-
-  // 2. Cache plugin files
-  const cachedPlugins = cachePlugins(selected, commitSha);
-
-  // 3. Register marketplace in known_marketplaces.json
-  updateKnownMarketplaces();
-
-  // 4. Register plugins in installed_plugins.json
-  updateInstalledPlugins(cachedPlugins);
-
-  // 5. Update settings.json (enabledPlugins + extraKnownMarketplaces)
-  updateSettings(selected);
+  // Enable Agent Teams
+  if (enableAgentTeams) {
+    if (!settings.env) {
+      settings.env = {};
+    }
+    settings.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1";
+  }
 
+  writeSettings(settings);
   return true;
 }
 
@@ -460,17 +318,43 @@ async function main() {
 
   console.log();
 
+  // ── Agent Teams ─────────────────────────────────────────────────────
+
+  let enableAgentTeams = false;
+  const currentSettings = readSettings();
+  const alreadyEnabled = currentSettings.env?.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1";
+
+  if (alreadyEnabled) {
+    console.log(`  ${green("\u2713")} ${dim("Agent Teams already enabled")}`);
+    console.log();
+  } else {
+    console.log(`  ${bold("Agent Teams")} ${dim("lets experts run as parallel Claude Code")}`);
+    console.log(`  ${dim("instances that coordinate and message each other.")}`);
+    console.log(`  ${dim("Required for")} ${bold(":full-team")} ${dim("commands (e.g. /validate:full-team).")}`);
+    console.log();
+
+    const rl2 = createInterface({ input: process.stdin, output: process.stdout });
+    const teamsChoice = await new Promise((resolve) => {
+      rl2.question(`  ${cyan("\u276f")} Enable Agent Teams? (Y/n): `, resolve);
+    });
+    rl2.close();
+
+    const tc = teamsChoice.trim().toLowerCase();
+    enableAgentTeams = tc === "" || tc === "y" || tc === "yes";
+    console.log();
+  }
+
   // ── Install ───────────────────────────────────────────────────────────
 
   const spinner = ora({
-    text: `Cloning marketplace and installing ${selected.length} plugin${selected.length > 1 ? "s" : ""}...`,
+    text: `Registering ${selected.length} plugin${selected.length > 1 ? "s" : ""} in ~/.claude/settings.json...`,
     color: "cyan",
   }).start();
 
   try {
-    installPlugins(selected);
+    installPlugins(selected, enableAgentTeams);
     spinner.succeed(
-      `${bold(`${selected.length} plugins`)} ${dim("installed to")} ${dim("~/.claude/")}`
+      `${bold(`${selected.length} plugins`)} ${dim("registered in")} ${dim("~/.claude/settings.json")}`
     );
   } catch (err) {
     spinner.fail(red(`Failed: ${err.message}`));
@@ -491,6 +375,10 @@ async function main() {
     console.log(`  ${green("\u2713")} ${bold(plugin.name)} ${dim(`\u2014 ${label}`)}`);
   }
 
+  if (enableAgentTeams) {
+    console.log(`  ${green("\u2713")} ${bold("Agent Teams")} ${dim("\u2014 enabled")}`);
+  }
+
   console.log();
 
   // ── Getting Started Card ──────────────────────────────────────────────
@@ -504,8 +392,8 @@ async function main() {
     `  ${dim("Autonomous mode:")}       ${bold("--autonomous")}`,
     `  ${dim("Single expert:")}         ${bold("/value-mapper")} ${dim("Idea")}`,
     "",
-    `  ${dim("Cross-session memory:")}`,
-    `  ${bold("/plugin install claude-mem@thedotmack")}`,
+    `  ${dim("Claude Code will auto-install plugins")}`,
+    `  ${dim("on first startup after registration.")}`,
     "",
   ], { title: "Getting Started", width: W, borderColor: cyanBorder }));
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "organtic",
-  "version": "1.3.0",
-  "description": "The AI-native organization. 25 experts from idea to launch. Strategy pipeline (validate > build > launch) + execution plugins (craft, document, present, studio). Claude Code plugin ecosystem.",
+  "version": "3.0.0",
+  "description": "The AI-native organization. 25 experts from idea to launch. Agentic pipeline (vision > validate > build > launch > craft) with constitutional Brief enforcement, conditional routing, and organizational memory. Claude Code plugin ecosystem.",
   "bin": {
     "organtic": "./index.mjs"
   },