buildcrew 1.0.0

package/bin/setup.js

@@ -0,0 +1,429 @@
+#!/usr/bin/env node
+
+import { readdir, copyFile, mkdir, readFile, writeFile, access } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createInterface } from "readline";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_SRC = join(__dirname, "..", "agents");
+const TEMPLATES_SRC = join(__dirname, "..", "templates");
+const TARGET_DIR = join(process.cwd(), ".claude", "agents");
+const HARNESS_DIR = join(process.cwd(), ".claude", "harness");
+const VERSION = "1.0.0";
+
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const CYAN = "\x1b[36m";
+const MAGENTA = "\x1b[35m";
+const RED = "\x1b[31m";
+
+function log(msg) { console.log(msg); }
+
+async function exists(path) {
+  try { await access(path); return true; } catch { return false; }
+}
+
+// ─── Template registry ───
+
+const TEMPLATES = {
+  "project":       { file: null,                desc: "Project context (auto-generated by init)",   category: "core" },
+  "rules":         { file: null,                desc: "Team rules & conventions (auto-generated by init)", category: "core" },
+  "erd":           { file: "erd.md",            desc: "Database schema & entity relationships",     category: "data" },
+  "architecture":  { file: "architecture.md",   desc: "System architecture & tech stack overview",  category: "system" },
+  "api-spec":      { file: "api-spec.md",       desc: "API endpoints & contracts",                  category: "system" },
+  "design-system": { file: "design-system.md",  desc: "Colors, typography, spacing, components",    category: "design" },
+  "glossary":      { file: "glossary.md",       desc: "Domain terms, user roles, status flows",     category: "domain" },
+  "user-flow":     { file: "user-flow.md",      desc: "User journeys, page map, error paths",       category: "domain" },
+  "env-vars":      { file: "env-vars.md",       desc: "Environment variables & secrets guide",      category: "system" },
+};
+
+// ─── Interactive prompt ───
+
+function createPrompt() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise(resolve => rl.question(q, resolve));
+  const close = () => rl.close();
+  return { ask, close };
+}
+
+// ─── Auto-detect project info ───
+
+async function detectProject() {
+  const info = { name: "", stack: [], framework: "", hasTS: false, hasTailwind: false, hasI18n: false, hasAuth: false, hasDB: false };
+  try {
+    const pkg = JSON.parse(await readFile(join(process.cwd(), "package.json"), "utf8"));
+    info.name = pkg.name || "";
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (allDeps["next"]) { info.framework = "Next.js"; info.stack.push("Next.js"); }
+    else if (allDeps["nuxt"]) { info.framework = "Nuxt"; info.stack.push("Nuxt"); }
+    else if (allDeps["react"]) { info.framework = "React"; info.stack.push("React"); }
+    else if (allDeps["vue"]) { info.framework = "Vue"; info.stack.push("Vue"); }
+    else if (allDeps["svelte"] || allDeps["@sveltejs/kit"]) { info.framework = "SvelteKit"; info.stack.push("SvelteKit"); }
+    else if (allDeps["express"]) { info.framework = "Express"; info.stack.push("Express"); }
+    if (allDeps["typescript"]) { info.hasTS = true; info.stack.push("TypeScript"); }
+    if (allDeps["tailwindcss"]) { info.hasTailwind = true; info.stack.push("TailwindCSS"); }
+    if (allDeps["next-intl"] || allDeps["i18next"] || allDeps["react-intl"]) { info.hasI18n = true; info.stack.push("i18n"); }
+    if (allDeps["@supabase/supabase-js"]) { info.hasDB = true; info.stack.push("Supabase"); }
+    else if (allDeps["prisma"] || allDeps["@prisma/client"]) { info.hasDB = true; info.stack.push("Prisma"); }
+    else if (allDeps["drizzle-orm"]) { info.hasDB = true; info.stack.push("Drizzle"); }
+    if (allDeps["next-auth"] || allDeps["@auth/core"] || allDeps["@supabase/auth-helpers-nextjs"]) { info.hasAuth = true; info.stack.push("Auth"); }
+    if (allDeps["stripe"] || allDeps["@paddle/paddle-js"]) { info.stack.push("Payments"); }
+  } catch {}
+  return info;
+}
+
+// ─── Add: copy template to harness ───
+
+async function runAdd(type, force) {
+  if (!type) {
+    log(`\n  ${BOLD}Available harness templates:${RESET}\n`);
+    const categories = { core: "Core (auto-created by init)", data: "Data", system: "System", design: "Design", domain: "Domain" };
+    for (const [cat, label] of Object.entries(categories)) {
+      const items = Object.entries(TEMPLATES).filter(([, v]) => v.category === cat);
+      if (items.length === 0) continue;
+      log(`  ${CYAN}${label}${RESET}`);
+      for (const [name, info] of items) {
+        const installed = await exists(join(HARNESS_DIR, `${name}.md`));
+        const status = installed ? `${GREEN}installed${RESET}` : `${DIM}not installed${RESET}`;
+        log(`    ${BOLD}${name.padEnd(16)}${RESET} ${status}  ${DIM}${info.desc}${RESET}`);
+      }
+      log("");
+    }
+    log(`  ${BOLD}Usage:${RESET} npx buildcrew add ${CYAN}<template>${RESET}`);
+    log(`  ${BOLD}Example:${RESET} npx buildcrew add erd\n`);
+    return;
+  }
+
+  const template = TEMPLATES[type];
+  if (!template) {
+    log(`\n  ${RED}Unknown template: ${type}${RESET}`);
+    log(`  ${DIM}Run ${BOLD}npx buildcrew add${RESET}${DIM} to see available templates.${RESET}\n`);
+    return;
+  }
+
+  if (!template.file) {
+    log(`\n  ${YELLOW}${type}.md is auto-generated by ${BOLD}npx buildcrew init${RESET}`);
+    log(`  ${DIM}Run init to create it, or create .claude/harness/${type}.md manually.${RESET}\n`);
+    return;
+  }
+
+  const target = join(HARNESS_DIR, `${type}.md`);
+  if ((await exists(target)) && !force) {
+    log(`\n  ${YELLOW}${type}.md already exists.${RESET} Use ${BOLD}--force${RESET} to overwrite.\n`);
+    return;
+  }
+
+  await mkdir(HARNESS_DIR, { recursive: true });
+  await copyFile(join(TEMPLATES_SRC, template.file), target);
+  log(`\n  ${GREEN} + ${RESET} .claude/harness/${type}.md`);
+  log(`  ${DIM}Edit this file to fill in your project details.${RESET}`);
+  log(`  ${DIM}All agents will read it automatically.${RESET}\n`);
+}
+
+// ─── Init: Harness Engineering ───
+
+async function runInit(force) {
+  log(`\n  ${BOLD}buildcrew init${RESET} — Harness Engineering Setup\n`);
+  log(`  ${DIM}Setting up project context and team rules.${RESET}`);
+  log(`  ${DIM}All 11 agents will read these before every task.${RESET}\n`);
+
+  if ((await exists(join(HARNESS_DIR, "project.md"))) && !force) {
+    log(`  ${YELLOW}Harness already exists at .claude/harness/${RESET}`);
+    log(`  ${DIM}Use ${BOLD}npx buildcrew init --force${RESET}${DIM} to overwrite.${RESET}\n`);
+    return;
+  }
+
+  const detected = await detectProject();
+  const { ask, close } = createPrompt();
+
+  try {
+    log(`  ${CYAN}${BOLD}[1/3] Project Context${RESET}\n`);
+    const name = (await ask(`  ${BOLD}Project name${RESET} ${DIM}(${detected.name || "none"})${RESET}: `)) || detected.name || "my-project";
+    const description = await ask(`  ${BOLD}What does this project do?${RESET} (1 sentence): `);
+    const stackAuto = detected.stack.length > 0 ? detected.stack.join(", ") : "not detected";
+    const stackExtra = await ask(`  ${BOLD}Tech stack${RESET} ${DIM}(detected: ${stackAuto})${RESET}\n  ${DIM}Add anything missing (comma-separated, or Enter):${RESET} `);
+    const deployTarget = await ask(`  ${BOLD}Deploy target${RESET} ${DIM}(Vercel, AWS, etc.)${RESET}: `);
+    const prodUrl = await ask(`  ${BOLD}Production URL${RESET} ${DIM}(or Enter to skip)${RESET}: `);
+
+    log(`\n  ${CYAN}${BOLD}[2/3] Team Rules${RESET}\n`);
+    const conventions = await ask(`  ${BOLD}Coding conventions${RESET}\n  ${DIM}(e.g., "functional components only, no default exports")${RESET}\n  : `);
+    const priorities = await ask(`  ${BOLD}What to prioritize${RESET}\n  ${DIM}(e.g., "UX over performance, security first")${RESET}\n  : `);
+    const avoid = await ask(`  ${BOLD}What to avoid${RESET}\n  ${DIM}(e.g., "no class components, no any types")${RESET}\n  : `);
+    const quality = await ask(`  ${BOLD}Quality standards${RESET}\n  ${DIM}(e.g., "all code must pass tsc, no console.log")${RESET}\n  : `);
+    const reviewRules = await ask(`  ${BOLD}Review rules${RESET}\n  ${DIM}(e.g., "always check auth on API routes, mobile-first")${RESET}\n  : `);
+
+    log(`\n  ${CYAN}${BOLD}[3/3] Domain Knowledge${RESET}\n`);
+    const domain = await ask(`  ${BOLD}Domain${RESET} ${DIM}(e.g., "e-commerce", "fintech")${RESET}: `);
+    const userTypes = await ask(`  ${BOLD}User types${RESET} ${DIM}(e.g., "free, premium, admin")${RESET}: `);
+    const keyTerms = await ask(`  ${BOLD}Key terms${RESET}\n  ${DIM}(e.g., "reading=tarot session, spread=card layout")${RESET}\n  : `);
+    const businessRules = await ask(`  ${BOLD}Business rules${RESET}\n  ${DIM}(e.g., "free=3 reads/day, premium=unlimited")${RESET}\n  : `);
+
+    close();
+
+    await mkdir(HARNESS_DIR, { recursive: true });
+    const fullStack = [...detected.stack, ...(stackExtra ? stackExtra.split(",").map(s => s.trim()) : [])].filter(Boolean);
+
+    const projectMd = `# Project: ${name}
+
+## Overview
+${description || "[Edit: describe your project]"}
+
+## Tech Stack
+${fullStack.map(s => `- ${s}`).join("\n") || "- [Edit: add your tech stack]"}
+
+## Framework
+${detected.framework || "[Not detected]"}
+
+## Infrastructure
+- **Deploy**: ${deployTarget || "[Edit]"}
+- **Production URL**: ${prodUrl || "[Edit]"}
+- **TypeScript**: ${detected.hasTS ? "Yes" : "No"}
+- **CSS**: ${detected.hasTailwind ? "TailwindCSS" : "[Edit]"}
+- **i18n**: ${detected.hasI18n ? "Yes" : "No"}
+- **Auth**: ${detected.hasAuth ? "Yes" : "No"}
+- **Database**: ${detected.hasDB ? "Yes" : "No"}
+
+## Domain
+- **Industry**: ${domain || "[Edit]"}
+- **User types**: ${userTypes || "[Edit]"}
+
+## Key Domain Terms
+${keyTerms ? keyTerms.split(",").map(t => `- ${t.trim()}`).join("\n") : "- [Edit: add domain-specific terms]"}
+
+## Business Rules
+${businessRules ? businessRules.split(",").map(r => `- ${r.trim()}`).join("\n") : "- [Edit: add business rules]"}
+`;
+
+    const rulesMd = `# Team Rules
+
+These rules apply to ALL agents. Every agent reads this before starting work.
+
+## Coding Conventions
+${conventions ? conventions.split(",").map(c => `- ${c.trim()}`).join("\n") : "- Follow existing codebase patterns"}
+
+## Priorities
+${priorities ? priorities.split(",").map(p => `- ${p.trim()}`).join("\n") : "- [Edit: set your priorities]"}
+
+## What to Avoid
+${avoid ? avoid.split(",").map(a => `- ${a.trim()}`).join("\n") : "- [Edit: list things to avoid]"}
+
+## Quality Standards
+${quality ? quality.split(",").map(q => `- ${q.trim()}`).join("\n") : "- All code must pass type checker and linter\n- No debug logs in production"}
+
+## Review Standards
+${reviewRules ? reviewRules.split(",").map(r => `- ${r.trim()}`).join("\n") : "- [Edit: add review rules]"}
+`;
+
+    await writeFile(join(HARNESS_DIR, "project.md"), projectMd);
+    await writeFile(join(HARNESS_DIR, "rules.md"), rulesMd);
+
+    log(`\n  ${GREEN}${BOLD}Harness created!${RESET}\n`);
+    log(`  ${GREEN} + ${RESET} .claude/harness/project.md`);
+    log(`  ${GREEN} + ${RESET} .claude/harness/rules.md`);
+
+    // Suggest additional templates
+    log(`\n  ${BOLD}Add more context with templates:${RESET}\n`);
+    const suggestions = [
+      ["erd",           "Database schema & relationships"],
+      ["architecture",  "System architecture overview"],
+      ["api-spec",      "API endpoints & contracts"],
+      ["design-system", "Colors, typography, components"],
+      ["glossary",      "Domain terms & user roles"],
+      ["user-flow",     "User journeys & page map"],
+      ["env-vars",      "Environment variables guide"],
+    ];
+    for (const [name, desc] of suggestions) {
+      log(`  ${DIM}npx buildcrew add ${CYAN}${name.padEnd(15)}${RESET} ${DIM}${desc}${RESET}`);
+    }
+
+    log(`\n  ${DIM}Or create any .md file in .claude/harness/ — agents read them all.${RESET}\n`);
+
+    if (!(await exists(TARGET_DIR))) {
+      log(`  ${YELLOW}Agents not installed yet.${RESET} Run ${BOLD}npx buildcrew${RESET} first.\n`);
+    }
+
+  } catch (err) {
+    close();
+    throw err;
+  }
+}
+
+// ─── Harness status ───
+
+async function runHarnessStatus() {
+  log(`\n  ${BOLD}Harness files${RESET} ${DIM}(.claude/harness/)${RESET}\n`);
+
+  if (!(await exists(HARNESS_DIR))) {
+    log(`  ${YELLOW}No harness directory found.${RESET}`);
+    log(`  ${DIM}Run ${BOLD}npx buildcrew init${RESET}${DIM} to get started.${RESET}\n`);
+    return;
+  }
+
+  const files = (await readdir(HARNESS_DIR)).filter(f => f.endsWith(".md")).sort();
+  if (files.length === 0) {
+    log(`  ${YELLOW}Harness directory is empty.${RESET}\n`);
+    return;
+  }
+
+  for (const file of files) {
+    const name = file.replace(".md", "");
+    const isTemplate = TEMPLATES[name];
+    const content = await readFile(join(HARNESS_DIR, file), "utf8");
+    const lines = content.split("\n").length;
+    const hasEdits = !content.includes("[Edit");
+    const status = hasEdits ? `${GREEN}configured${RESET}` : `${YELLOW}needs editing${RESET}`;
+    const desc = isTemplate ? `${DIM}${isTemplate.desc}${RESET}` : `${DIM}(custom)${RESET}`;
+    log(`  ${BOLD}${name.padEnd(16)}${RESET} ${status}  ${lines} lines  ${desc}`);
+  }
+
+  log(`\n  ${DIM}Agents read ALL .md files here. Add any file you want.${RESET}\n`);
+}
+
+// ─── Install agents ───
+
+async function runInstall(force) {
+  const files = (await readdir(AGENTS_SRC)).filter(f => f.endsWith(".md"));
+  log(`\n  ${BOLD}buildcrew${RESET} v${VERSION}\n  ${DIM}11 AI agents for Claude Code${RESET}\n`);
+  log(`${DIM}  Installing to ${TARGET_DIR}${RESET}\n`);
+
+  await mkdir(TARGET_DIR, { recursive: true });
+  let installed = 0, skipped = 0;
+
+  for (const file of files) {
+    const target = join(TARGET_DIR, file);
+    if ((await exists(target)) && !force) {
+      log(`  ${YELLOW}skip${RESET}  ${file} ${DIM}(exists, use --force)${RESET}`);
+      skipped++;
+      continue;
+    }
+    await copyFile(join(AGENTS_SRC, file), target);
+    log(`  ${GREEN} +  ${RESET} ${file}`);
+    installed++;
+  }
+
+  log("");
+  if (installed > 0) {
+    log(`  ${GREEN}${BOLD}Done!${RESET} ${installed} agents installed.${skipped > 0 ? ` ${skipped} skipped.` : ""}\n`);
+  } else {
+    log(`  ${YELLOW}All agents already exist.${RESET} Use ${BOLD}--force${RESET} to overwrite.\n`);
+  }
+
+  const hasHarness = await exists(join(HARNESS_DIR, "project.md"));
+  if (!hasHarness) {
+    log(`  ${CYAN}Next:${RESET} Run ${BOLD}npx buildcrew init${RESET} to set up your project harness.\n`);
+  }
+
+  let hasPlaywright = false;
+  try {
+    const settingsPath = join(process.env.HOME, ".claude", "settings.json");
+    if (await exists(settingsPath)) {
+      hasPlaywright = (await readFile(settingsPath, "utf8")).includes("playwright");
+    }
+  } catch {}
+  if (!hasPlaywright) {
+    log(`  ${YELLOW}Optional:${RESET} Playwright MCP not detected.`);
+    log(`  ${DIM}Setup: claude mcp add playwright -- npx @anthropic-ai/mcp-server-playwright${RESET}\n`);
+  }
+
+  log(`  ${BOLD}Quick start:${RESET}  @constitution [your request]\n`);
+}
+
+// ─── List agents ───
+
+async function runList() {
+  const files = (await readdir(AGENTS_SRC)).filter(f => f.endsWith(".md"));
+  log(`\n  ${BOLD}buildcrew${RESET} v${VERSION} — 11 agents\n`);
+  for (const file of files) {
+    const content = await readFile(join(AGENTS_SRC, file), "utf8");
+    const nameMatch = content.match(/^name:\s*(.+)$/m);
+    const descMatch = content.match(/^description:\s*(.+)$/m);
+    const modelMatch = content.match(/^model:\s*(.+)$/m);
+    const name = nameMatch ? nameMatch[1] : file.replace(".md", "");
+    const desc = descMatch ? descMatch[1] : "";
+    const model = modelMatch ? modelMatch[1] : "sonnet";
+    const modelTag = model === "opus" ? `${MAGENTA}opus${RESET}` : `${DIM}sonnet${RESET}`;
+    const color = name === "constitution" ? BOLD : "";
+    log(`  ${color}${name.padEnd(20)}${RESET} ${modelTag}  ${DIM}${desc.slice(0, 55)}${RESET}`);
+  }
+  log("");
+}
+
+// ─── Uninstall ───
+
+async function runUninstall() {
+  const files = (await readdir(AGENTS_SRC)).filter(f => f.endsWith(".md"));
+  if (!(await exists(TARGET_DIR))) {
+    log(`${YELLOW}No .claude/agents/ directory found.${RESET}`);
+    return;
+  }
+  let removed = 0;
+  for (const file of files) {
+    const target = join(TARGET_DIR, file);
+    if (await exists(target)) { const { unlink } = await import("fs/promises"); await unlink(target); removed++; }
+  }
+  log(`${GREEN}Removed ${removed} agent files.${RESET}`);
+}
+
+// ─── Main ───
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const subcommand = args[1];
+  const force = args.includes("--force") || args.includes("-f");
+
+  if (args.includes("--version") || args.includes("-v")) {
+    log(`buildcrew v${VERSION}`);
+    return;
+  }
+
+  if (args.includes("--help") || args.includes("-h")) {
+    log(`
+  ${BOLD}buildcrew${RESET} v${VERSION} — 11 AI agents for Claude Code
+
+  ${BOLD}Commands:${RESET}
+    npx buildcrew                Install agents
+    npx buildcrew init           Set up project harness (interactive)
+    npx buildcrew add            List available harness templates
+    npx buildcrew add <template> Add a harness template
+    npx buildcrew harness        Show harness status
+
+  ${BOLD}Options:${RESET}
+    --force, -f      Overwrite existing files
+    --list, -l       List all agents
+    --uninstall      Remove installed agents
+    --version, -v    Show version
+
+  ${BOLD}Setup (recommended):${RESET}
+    ${GREEN}1.${RESET} npx buildcrew              ${DIM}Install agent files${RESET}
+    ${GREEN}2.${RESET} npx buildcrew init         ${DIM}Project context + team rules${RESET}
+    ${GREEN}3.${RESET} npx buildcrew add erd      ${DIM}Add more context (optional)${RESET}
+    ${GREEN}4.${RESET} @constitution [task]       ${DIM}Start working${RESET}
+
+  ${BOLD}Harness templates:${RESET}
+    erd, architecture, api-spec, design-system,
+    glossary, user-flow, env-vars
+    ${DIM}Or create any .md file in .claude/harness/${RESET}
+
+  ${BOLD}More info:${RESET} https://github.com/z1nun/buildcrew
+`);
+    return;
+  }
+
+  if (args.includes("--list") || args.includes("-l")) return runList();
+  if (args.includes("--uninstall")) return runUninstall();
+  if (command === "init") return runInit(force);
+  if (command === "add") return runAdd(subcommand, force);
+  if (command === "harness") return runHarnessStatus();
+
+  return runInstall(force);
+}
+
+main().catch(err => {
+  console.error(`${RED}Error:${RESET} ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "buildcrew",
+  "version": "1.0.0",
+  "description": "11 AI agents for Claude Code — auto-orchestrated dev team with 9 operating modes",
+  "author": "z1nun",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "buildcrew": "./bin/setup.js"
+  },
+  "files": [
+    "bin/",
+    "agents/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai-agents",
+    "ai-team",
+    "code-review",
+    "qa-testing",
+    "security-audit",
+    "playwright",
+    "developer-tools",
+    "vibecoding",
+    "buildcrew"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/z1nun/buildcrew.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}