claude-code-orchestrator-kit 1.0.0

package/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * Claude Code Orchestrator Kit
+ *
+ * Main entry point for the npm package.
+ * This file provides programmatic access to the kit's utilities.
+ */
+
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Read package.json for version info
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, 'package.json'), 'utf-8')
+);
+
+/**
+ * Get the version of the orchestrator kit
+ */
+export function getVersion() {
+  return packageJson.version;
+}
+
+/**
+ * Get the installation directory path
+ */
+export function getInstallPath() {
+  return __dirname;
+}
+
+/**
+ * Get paths to key directories
+ */
+export function getPaths() {
+  return {
+    root: __dirname,
+    claude: join(__dirname, '.claude'),
+    agents: join(__dirname, '.claude', 'agents'),
+    commands: join(__dirname, '.claude', 'commands'),
+    skills: join(__dirname, '.claude', 'skills'),
+    mcp: join(__dirname, 'mcp'),
+    docs: join(__dirname, 'docs'),
+  };
+}
+
+/**
+ * Display welcome message
+ */
+export function welcome() {
+  console.log(`
+╔════════════════════════════════════════════════════════════════╗
+║                                                                ║
+║   🎼 Claude Code Orchestrator Kit v${packageJson.version}                 ║
+║                                                                ║
+║   Professional automation and orchestration system             ║
+║                                                                ║
+╚════════════════════════════════════════════════════════════════╝
+
+📦 Package installed successfully!
+
+🚀 Next Steps:
+
+1. Set up environment variables:
+   cp .env.example .env.local
+   # Edit .env.local with your credentials
+
+2. Choose MCP configuration:
+   npm run setup
+   # Or: bash switch-mcp.sh
+
+3. Restart Claude Code to apply changes
+
+📚 Documentation: ${packageJson.homepage}
+💬 Issues: ${packageJson.bugs.url}
+
+Happy coding with Claude! 🤖
+`);
+}
+
+// If run directly from command line
+if (process.argv[1] === __filename) {
+  welcome();
+}
+
+// Export all utilities
+export default {
+  getVersion,
+  getInstallPath,
+  getPaths,
+  welcome,
+};

package/mcp/.mcp.base.json

@@ -0,0 +1,21 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    }
+  }
+}

package/mcp/.mcp.frontend.json

@@ -0,0 +1,29 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"]
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": ["shadcn@latest", "mcp"]
+    }
+  }
+}

package/mcp/.mcp.full.json

@@ -0,0 +1,67 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    },
+    "supabase": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_PROJECT_REF}"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    },
+    "supabase-legacy": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_LEGACY_PROJECT_REF}"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    },
+    "n8n-workflows": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://gitmcp.io/Zie619/n8n-workflows"]
+    },
+    "n8n-mcp": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "--init",
+        "-e",
+        "MCP_MODE=stdio",
+        "-e",
+        "LOG_LEVEL=error",
+        "-e",
+        "DISABLE_CONSOLE_OUTPUT=true",
+        "-e",
+        "N8N_API_URL=${N8N_API_URL}",
+        "-e",
+        "N8N_API_KEY=${N8N_API_KEY}",
+        "ghcr.io/czlonkowski/n8n-mcp:latest"
+      ]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest"]
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": ["shadcn@latest", "mcp"]
+    }
+  }
+}

package/mcp/.mcp.local.example.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "description": "Local MCP configuration template - copy to .mcp.local.json and configure in .env.local",
+  "github_token": "${GITHUB_TOKEN}",
+  "n8n_api_key": "${N8N_API_KEY}",
+  "github_pat": "${GITHUB_PAT}"
+}

package/mcp/.mcp.local.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "description": "Local MCP configuration - sensitive values stored in .env.local",
+  "github_token": "${GITHUB_TOKEN}",
+  "n8n_api_key": "${N8N_API_KEY}",
+  "github_pat": "${GITHUB_PAT}"
+}

package/mcp/.mcp.n8n.json

@@ -0,0 +1,45 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    },
+    "n8n-workflows": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://gitmcp.io/Zie619/n8n-workflows"]
+    },
+    "n8n-mcp": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "--init",
+        "-e",
+        "MCP_MODE=stdio",
+        "-e",
+        "LOG_LEVEL=error",
+        "-e",
+        "DISABLE_CONSOLE_OUTPUT=true",
+        "-e",
+        "N8N_API_URL=${N8N_API_URL}",
+        "-e",
+        "N8N_API_KEY=${N8N_API_KEY}",
+        "ghcr.io/czlonkowski/n8n-mcp:latest"
+      ]
+    }
+  }
+}

package/mcp/.mcp.supabase-full.json

@@ -0,0 +1,35 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    },
+    "supabase": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_PROJECT_REF}"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    },
+    "supabase-legacy": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_LEGACY_PROJECT_REF}"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    }
+  }
+}

package/mcp/.mcp.supabase-only.json

@@ -0,0 +1,28 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp@latest"]
+    },
+    "server-sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@smithery/cli@latest",
+        "run",
+        "@smithery-ai/server-sequential-thinking"
+      ],
+      "env": {
+        "SMITHERY_API_KEY": "${SEQUENTIAL_THINKING_KEY}",
+        "SMITHERY_PROFILE": "${SEQUENTIAL_THINKING_PROFILE}"
+      }
+    },
+    "supabase": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_PROJECT_REF}"],
+      "env": {
+        "SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "claude-code-orchestrator-kit",
+  "version": "1.0.0",
+  "description": "Complete automation and orchestration system for Claude Code with 33+ AI agents, quality gates, health monitoring, and workflow automation",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "postinstall": "node postinstall.js",
+    "setup": "bash switch-mcp.sh",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "agents",
+    "orchestration",
+    "automation",
+    "workflow",
+    "mcp",
+    "model-context-protocol",
+    "supabase",
+    "code-quality",
+    "health-monitoring",
+    "devtools",
+    "productivity",
+    "ci-cd",
+    "quality-gates",
+    "bug-detection",
+    "security-scanning",
+    "dependency-management",
+    "speckit"
+  ],
+  "author": {
+    "name": "Igor Maslennikov",
+    "email": "maslennikov-ig@users.noreply.github.com",
+    "url": "https://github.com/maslennikov-ig"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maslennikov-ig/claude-code-orchestrator-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/maslennikov-ig/claude-code-orchestrator-kit/issues"
+  },
+  "homepage": "https://github.com/maslennikov-ig/claude-code-orchestrator-kit#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "files": [
+    ".claude/",
+    "mcp/",
+    "docs/",
+    ".github/",
+    "switch-mcp.sh",
+    "CLAUDE.md",
+    "README.md",
+    "LICENSE",
+    ".env.example",
+    ".gitignore",
+    "postinstall.js",
+    "index.js"
+  ],
+  "bin": {
+    "claude-orchestrator": "./switch-mcp.sh"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/postinstall.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for Claude Code Orchestrator Kit
+ *
+ * This script runs automatically after npm install and helps users
+ * set up the kit properly.
+ */
+
+import { welcome } from './index.js';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Check if required files exist
+ */
+function checkInstallation() {
+  const requiredPaths = [
+    '.claude',
+    '.claude/agents',
+    '.claude/commands',
+    '.claude/skills',
+    'mcp',
+    'CLAUDE.md',
+    'README.md',
+  ];
+
+  const missing = requiredPaths.filter(
+    path => !existsSync(join(__dirname, path))
+  );
+
+  if (missing.length > 0) {
+    console.error('❌ Installation incomplete. Missing files:');
+    missing.forEach(path => console.error(`   - ${path}`));
+    process.exit(1);
+  }
+
+  return true;
+}
+
+/**
+ * Main post-install routine
+ */
+async function main() {
+  try {
+    // Check installation integrity
+    checkInstallation();
+
+    // Display welcome message with setup instructions
+    welcome();
+
+    // Check if .env.local exists
+    if (!existsSync(join(__dirname, '.env.local'))) {
+      console.log('\n⚠️  Remember to create .env.local from .env.example\n');
+    }
+
+    // Success
+    process.exit(0);
+  } catch (error) {
+    console.error('❌ Post-install failed:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run post-install
+main();

package/switch-mcp.sh

@@ -0,0 +1,101 @@
+#!/bin/bash
+# ===================================================================
+# MCP Configuration Switcher
+# ===================================================================
+# Switches between different MCP server configurations
+# All configurations are stored in ./mcp/ directory
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$REPO_ROOT"
+
+# Color codes for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# MCP configurations directory
+MCP_DIR="mcp"
+
+echo -e "${BLUE}═══════════════════════════════════════════════════${NC}"
+echo -e "${BLUE}  MCP Configuration Switcher${NC}"
+echo -e "${BLUE}═══════════════════════════════════════════════════${NC}"
+echo ""
+echo "Select MCP configuration:"
+echo ""
+echo -e "${GREEN}1${NC} - BASE             (Context7 + Sequential Thinking)      ~600 tokens"
+echo -e "${GREEN}2${NC} - SUPABASE         (Base + Supabase MegaCampusAI)        ~2500 tokens"
+echo -e "${GREEN}3${NC} - SUPABASE + LEGACY (Base + Supabase + Legacy project)   ~3000 tokens"
+echo -e "${GREEN}4${NC} - N8N              (Base + n8n-workflows + n8n-mcp)      ~2500 tokens"
+echo -e "${GREEN}5${NC} - FRONTEND         (Base + Playwright + ShadCN)          ~2000 tokens"
+echo -e "${GREEN}6${NC} - FULL             (All servers)                         ~5000 tokens"
+echo ""
+echo -e "${YELLOW}0${NC} - STATUS           (Show current configuration)"
+echo ""
+read -p "Your choice (0-6): " choice
+
+case "$choice" in
+  1)
+    config="base"
+    desc="BASE (Context7 + Sequential Thinking)"
+    ;;
+  2)
+    config="supabase-only"
+    desc="SUPABASE (MegaCampusAI only)"
+    ;;
+  3)
+    config="supabase-full"
+    desc="SUPABASE + LEGACY (Both projects)"
+    ;;
+  4)
+    config="n8n"
+    desc="N8N (Workflow automation)"
+    ;;
+  5)
+    config="frontend"
+    desc="FRONTEND (Playwright + ShadCN)"
+    ;;
+  6)
+    config="full"
+    desc="FULL (All servers)"
+    ;;
+  0)
+    echo ""
+    echo -e "${BLUE}Current configuration:${NC}"
+    if [ -f .mcp.json ]; then
+      servers=$(grep -oP '"[^"]+"\s*:\s*\{' .mcp.json | sed 's/"//g' | sed 's/://' | tr '\n' ', ' | sed 's/,$//')
+      echo -e "  Active servers: ${GREEN}$servers${NC}"
+    else
+      echo -e "  ${RED}.mcp.json file not found${NC}"
+    fi
+    echo ""
+    echo "Available configurations:"
+    [ -f "$MCP_DIR/.mcp.base.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.base.json"
+    [ -f "$MCP_DIR/.mcp.supabase-only.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.supabase-only.json"
+    [ -f "$MCP_DIR/.mcp.supabase-full.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.supabase-full.json"
+    [ -f "$MCP_DIR/.mcp.n8n.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.n8n.json"
+    [ -f "$MCP_DIR/.mcp.frontend.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.frontend.json"
+    [ -f "$MCP_DIR/.mcp.full.json" ] && echo -e "  ✓ $MCP_DIR/.mcp.full.json"
+    exit 0
+    ;;
+  *)
+    echo -e "${RED}Invalid choice. Use numbers 0-6.${NC}"
+    exit 1
+    ;;
+esac
+
+# Copy configuration from mcp/ directory to root
+SOURCE_FILE="$MCP_DIR/.mcp.$config.json"
+if [ -f "$SOURCE_FILE" ]; then
+  cp "$SOURCE_FILE" .mcp.json
+  echo ""
+  echo -e "${GREEN}✅ Switched to: $desc${NC}"
+  echo -e "   Source: ${BLUE}$SOURCE_FILE${NC}"
+  echo ""
+  echo -e "${YELLOW}⚠️  IMPORTANT: Restart Claude Code to apply changes!${NC}"
+  echo ""
+else
+  echo -e "${RED}❌ File $SOURCE_FILE not found${NC}"
+  exit 1
+fi