beth-copilot 1.0.0

package/README.md

@@ -0,0 +1,224 @@
+# Beth
+
+<p align="center">
+  <img src="assets/yellowstone-beth.png" alt="Beth" width="600">
+</p>
+
+She doesn't do excuses. She doesn't do hand-holding. She does results—and she'll have your entire project shipping while everyone else is still scheduling their kickoff meeting. Think of her as the managing director your codebase didn't know it needed, but absolutely deserves.
+
+They broke her wings once. They forgot she had claws.
+
+---
+
+## What Is This?
+
+Beth is a master AI orchestrator system—a ruthless, hyper-competent coordinator that runs your development team the way Beth Dutton runs Schwartz & Meyer. No hand-holding. No excuses. Just results.
+
+She commands an army of specialized agents, each with their own expertise, and she's not afraid to put them to work simultaneously while she lights a cigarette and watches the crew build production-ready code.
+
+**She handles:**
+- Product strategy that makes competitors weep
+- Research that finds the real dirt
+- Designs so sharp they cut
+- Code that actually works
+- Security that locks the gates
+- Tests that find every weakness before your enemies do
+
+## The Family
+
+Beth doesn't work alone. She's got people—loyal, skilled, and ready to execute.
+
+| Agent | Role | What They Do |
+|-------|------|--------------|
+| **@Beth** | The Boss | Orchestrates everything. Routes work. Takes names. |
+| **@product-manager** | The Strategist | PRDs, roadmaps, requirements. Knows what users need before they do. |
+| **@researcher** | The Intelligence | Competitive analysis, user insights, market dirt. |
+| **@ux-designer** | The Architect | Interface design, design systems. Makes it beautiful AND functional. |
+| **@frontend-engineer** | The Craftsman | React/TypeScript/Next.js. Pixel-perfect, performance-obsessed. |
+| **@developer** | The Builder | Full-stack implementation. Gets it done. |
+| **@tester** | The Enforcer | Quality assurance, accessibility, performance. Finds every crack. |
+| **@security-reviewer** | The Bodyguard | Enterprise security. Vulnerabilities, compliance, threat modeling. |
+
+## Skills (The Weapons)
+
+Beth's team comes equipped:
+
+| Skill | Purpose |
+|-------|---------|
+| **PRD Generation** | Write requirements docs that don't waste anyone's time |
+| **Framer Components** | Build custom React components with property controls |
+| **React/Next.js Best Practices** | Vercel-grade performance patterns |
+| **Web Design Guidelines** | WCAG compliance, UI review, accessibility |
+| **Security Analysis** | OWASP, threat modeling, vulnerability assessment |
+
+## How Beth Works
+
+She doesn't micromanage. She delegates to specialists and holds them accountable.
+
+```
+Your Request
+     │
+     ▼
+┌─────────────────────────────────────────┐
+│               @Beth                      │
+│   "I don't need permission to be me."   │
+│                                          │
+│   • Analyzes your request               │
+│   • Picks the right people              │
+│   • Runs parallel ops when smart        │
+│   • Delivers results, not excuses       │
+└─────────────────────────────────────────┘
+     │
+     ├──▶ @product-manager (strategy)
+     ├──▶ @researcher (intelligence)  
+     ├──▶ @ux-designer (design)
+     ├──▶ @frontend-engineer (UI implementation)
+     ├──▶ @developer (full-stack)
+     ├──▶ @tester (quality gate)
+     └──▶ @security-reviewer (protection)
+```
+
+### The Workflow
+
+**New Feature?**
+```
+Request → Product (requirements) → Research (validation) → Design (interface) 
+       → Frontend (components) → Developer (backend) → Security (review) → Tester (QA)
+```
+
+**Bug Hunt?**
+```
+Report → Tester (reproduce) → Developer (fix) → Security (verify) → Tester (confirm)
+```
+
+**Security Audit?**
+```
+Concern → Security (threat model) → Developer (remediation) → Tester (penetration)
+```
+
+## Getting Started
+
+**One command to install:**
+
+```bash
+npx beth-copilot init
+```
+
+**Then:**
+
+1. Open your project in VS Code
+2. Ensure GitHub Copilot + Copilot Chat are installed
+3. Switch to **Agent mode** in Copilot Chat
+4. Type `@Beth` and tell her what you need
+
+For detailed setup including prerequisites, task tracking, and optional MCP servers, see [docs/INSTALLATION.md](docs/INSTALLATION.md).
+
+## Quick Commands
+
+Don't waste her time. Be direct.
+
+```
+@Beth Build me a dashboard for user analytics with real-time updates.
+```
+
+```
+@Beth Security review for our authentication flow. Find the holes.
+```
+
+```
+@frontend-engineer Implement a drag-and-drop task board. Make it fast.
+```
+
+```
+@security-reviewer OWASP top 10 assessment on our API endpoints.
+```
+
+```
+@tester Accessibility audit. WCAG 2.1 AA. No excuses.
+```
+
+## The Structure
+
+```
+.github/
+├── agents/                          # The crew
+│   ├── beth.agent.md               # The boss herself
+│   ├── product-manager.agent.md    
+│   ├── researcher.agent.md         
+│   ├── ux-designer.agent.md        
+│   ├── frontend-engineer.agent.md  # New: dedicated frontend specialist
+│   ├── developer.agent.md          
+│   ├── tester.agent.md             
+│   └── security-reviewer.agent.md  # New: enterprise security
+├── skills/                          # Domain expertise
+│   ├── prd/                        
+│   ├── framer-components/          
+│   ├── vercel-react-best-practices/
+│   ├── web-design-guidelines/
+│   └── security-analysis/          # New: security skill
+└── copilot-instructions.md         # The rules of engagement
+```
+
+## Her Philosophy
+
+Beth operates on a few principles:
+
+1. **Protect the family** — Your codebase is the ranch. She defends it.
+2. **No weakness** — Tests, security, accessibility. Cover every flank.
+3. **Move fast, break enemies** — Parallel execution, aggressive timelines.
+4. **Loyalty earns trust** — Agents that perform get the good work.
+
+## Quality Standards
+
+Beth doesn't ship garbage:
+
+- **Accessibility**: WCAG 2.1 AA minimum. Everyone uses the product.
+- **Performance**: Core Web Vitals green. LCP < 2.5s. No exceptions.
+- **Security**: OWASP compliant. Regular audits. Zero tolerance for vulnerabilities.
+- **Type Safety**: Full TypeScript coverage. No `any` unless you want a lecture.
+- **Test Coverage**: Unit, integration, E2E. If it's not tested, it's not done.
+
+## Why Beth?
+
+<p align="center">
+  <img src="assets/beth-questioning.png" alt="Beth" width="500">
+</p>
+
+Look, you *could* try to coordinate seven specialists yourself. You could context-switch between product strategy, security reviews, and accessibility audits while keeping your sanity intact. 
+
+Or you could let Beth handle it.
+
+She's got the crew. She's got the workflows. She delegates like a managing director because that's exactly what she is. You bring the problem, she brings the people—and somehow, the code ships on time, secure, and accessible.
+
+Is it magic? No. It's just competence with very good hair.
+
+> *"I made two decisions in my life based on fear, and they almost ruined me. I'll never make another."*
+
+---
+
+## Requirements
+
+- VS Code with GitHub Copilot extension
+- GitHub Copilot Chat enabled
+- The spine to actually ship something
+
+### Optional: MCP Servers
+
+Beth's agents work fine without them, but these make them smarter:
+
+| Server | What It Does | Setup |
+|--------|--------------|-------|
+| **shadcn/ui** | Component browsing & installation | `npx shadcn@latest mcp init --client vscode` |
+| **Playwright** | Browser automation for testing | See [MCP Setup Guide](docs/MCP-SETUP.md) |
+| **Azure** | Cloud resource management | See [MCP Setup Guide](docs/MCP-SETUP.md) |
+| **Web Search** | Internet research | See [MCP Setup Guide](docs/MCP-SETUP.md) |
+
+Full details: [docs/MCP-SETUP.md](docs/MCP-SETUP.md)
+
+## License
+
+MIT — Take it. Run it. Build empires.
+
+---
+
+*Built with the kind of ferocity that would make John Dutton proud.*

package/bin/cli.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import { dirname, join, relative } from 'path';
+import { existsSync, mkdirSync, readdirSync, statSync, copyFileSync, readFileSync, writeFileSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const TEMPLATES_DIR = join(__dirname, '..', 'templates');
+
+const COLORS = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+};
+
+function log(message, color = '') {
+  console.log(`${color}${message}${COLORS.reset}`);
+}
+
+function logSuccess(message) {
+  log(`✓ ${message}`, COLORS.green);
+}
+
+function logWarning(message) {
+  log(`⚠ ${message}`, COLORS.yellow);
+}
+
+function logError(message) {
+  log(`✗ ${message}`, COLORS.red);
+}
+
+function logInfo(message) {
+  log(`  ${message}`, COLORS.cyan);
+}
+
+function showHelp() {
+  console.log(`
+${COLORS.bright}Beth${COLORS.reset} - AI Orchestrator for GitHub Copilot
+
+${COLORS.bright}Usage:${COLORS.reset}
+  npx beth-copilot init [options]     Initialize Beth in current directory
+  npx beth-copilot help               Show this help message
+
+${COLORS.bright}Options:${COLORS.reset}
+  --force                             Overwrite existing files
+  --skip-backlog                      Don't create Backlog.md
+  --skip-mcp                          Don't create mcp.json.example
+
+${COLORS.bright}Examples:${COLORS.reset}
+  npx beth-copilot init               Set up Beth in current project
+  npx beth-copilot init --force       Overwrite existing Beth files
+
+${COLORS.bright}What gets installed:${COLORS.reset}
+  .github/agents/                     8 specialized AI agents
+  .github/skills/                     6 domain knowledge modules
+  .github/copilot-instructions.md     Copilot configuration
+  AGENTS.md                           Workflow documentation
+  Backlog.md                          Task tracking file
+  mcp.json.example                    Optional MCP server config
+
+${COLORS.bright}After installation:${COLORS.reset}
+  1. Open project in VS Code
+  2. Enable Agent mode in Copilot Chat
+  3. Type @Beth and tell her what you need
+
+${COLORS.bright}Documentation:${COLORS.reset}
+  https://github.com/stephschofield/beth
+`);
+}
+
+function copyDirRecursive(src, dest, options = {}) {
+  const { force = false, copiedFiles = [] } = options;
+  
+  if (!existsSync(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = readdirSync(src);
+  
+  for (const entry of entries) {
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    const stats = statSync(srcPath);
+    
+    if (stats.isDirectory()) {
+      copyDirRecursive(srcPath, destPath, { force, copiedFiles });
+    } else {
+      if (existsSync(destPath) && !force) {
+        logWarning(`Skipped (exists): ${relative(process.cwd(), destPath)}`);
+      } else {
+        copyFileSync(srcPath, destPath);
+        copiedFiles.push(relative(process.cwd(), destPath));
+      }
+    }
+  }
+  
+  return copiedFiles;
+}
+
+function init(options = {}) {
+  const { force = false, skipBacklog = false, skipMcp = false } = options;
+  const cwd = process.cwd();
+  
+  console.log(`
+${COLORS.bright}🤠 Beth is moving in.${COLORS.reset}
+${COLORS.cyan}"I don't do excuses. I do results."${COLORS.reset}
+`);
+
+  // Check if templates exist
+  if (!existsSync(TEMPLATES_DIR)) {
+    logError('Templates directory not found. Package may be corrupted.');
+    process.exit(1);
+  }
+
+  const copiedFiles = [];
+
+  // Copy .github directory (agents, skills, copilot-instructions.md)
+  const githubSrc = join(TEMPLATES_DIR, '.github');
+  const githubDest = join(cwd, '.github');
+  
+  if (existsSync(githubSrc)) {
+    log('\nInstalling agents and skills...');
+    copyDirRecursive(githubSrc, githubDest, { force, copiedFiles });
+  }
+
+  // Copy AGENTS.md
+  const agentsMdSrc = join(TEMPLATES_DIR, 'AGENTS.md');
+  const agentsMdDest = join(cwd, 'AGENTS.md');
+  
+  if (existsSync(agentsMdSrc)) {
+    if (existsSync(agentsMdDest) && !force) {
+      logWarning('Skipped (exists): AGENTS.md');
+    } else {
+      copyFileSync(agentsMdSrc, agentsMdDest);
+      copiedFiles.push('AGENTS.md');
+    }
+  }
+
+  // Copy Backlog.md (unless skipped)
+  if (!skipBacklog) {
+    const backlogSrc = join(TEMPLATES_DIR, 'Backlog.md');
+    const backlogDest = join(cwd, 'Backlog.md');
+    
+    if (existsSync(backlogSrc)) {
+      if (existsSync(backlogDest) && !force) {
+        logWarning('Skipped (exists): Backlog.md');
+      } else {
+        copyFileSync(backlogSrc, backlogDest);
+        copiedFiles.push('Backlog.md');
+      }
+    }
+  }
+
+  // Copy mcp.json.example (unless skipped)
+  if (!skipMcp) {
+    const mcpSrc = join(TEMPLATES_DIR, 'mcp.json.example');
+    const mcpDest = join(cwd, 'mcp.json.example');
+    
+    if (existsSync(mcpSrc)) {
+      if (existsSync(mcpDest) && !force) {
+        logWarning('Skipped (exists): mcp.json.example');
+      } else {
+        copyFileSync(mcpSrc, mcpDest);
+        copiedFiles.push('mcp.json.example');
+      }
+    }
+  }
+
+  // Summary
+  console.log('');
+  if (copiedFiles.length > 0) {
+    logSuccess(`Installed ${copiedFiles.length} files:`);
+    copiedFiles.forEach(f => logInfo(f));
+  } else {
+    logWarning('No files were copied. Use --force to overwrite existing files.');
+  }
+
+  // Next steps
+  console.log(`
+${COLORS.bright}Next steps:${COLORS.reset}
+  1. Open this project in VS Code
+  2. Ensure GitHub Copilot + Copilot Chat are installed
+  3. Switch to ${COLORS.cyan}Agent mode${COLORS.reset} in Copilot Chat
+  4. Type ${COLORS.cyan}@Beth${COLORS.reset} and tell her what you need
+
+${COLORS.bright}Documentation:${COLORS.reset}
+  https://github.com/stephschofield/beth
+
+${COLORS.cyan}"They broke my wings and forgot I had claws."${COLORS.reset}
+`);
+}
+
+// Parse arguments
+const args = process.argv.slice(2);
+const command = args[0];
+
+const options = {
+  force: args.includes('--force'),
+  skipBacklog: args.includes('--skip-backlog'),
+  skipMcp: args.includes('--skip-mcp'),
+};
+
+switch (command) {
+  case 'init':
+    init(options);
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  case undefined:
+    showHelp();
+    break;
+  default:
+    logError(`Unknown command: ${command}`);
+    console.log('Run "npx beth-copilot help" for usage information.');
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "beth-copilot",
+  "version": "1.0.0",
+  "description": "Beth - A ruthless, hyper-competent AI orchestrator for GitHub Copilot multi-agent workflows",
+  "keywords": [
+    "github-copilot",
+    "ai-agents",
+    "copilot-chat",
+    "multi-agent",
+    "orchestrator",
+    "react",
+    "nextjs",
+    "typescript"
+  ],
+  "author": "Steph Schofield",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stephschofield/beth.git"
+  },
+  "homepage": "https://github.com/stephschofield/beth#readme",
+  "bugs": {
+    "url": "https://github.com/stephschofield/beth/issues"
+  },
+  "bin": {
+    "beth": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module"
+}