Skip to content

Beth is the ruthless, hyper-competent agent orchestrator who runs your dev team like a boss. Routes work to specialized agents, creates and tracks work with Backlog.md, and delivers results without excuses. Built for GitHub Copilot.

Notifications You must be signed in to change notification settings

stephschofield/beth

 
 

Repository files navigation

Beth

Beth

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

Getting Started

Project scope:

npx beth-copilot init

Global install:

npm i -g beth-copilot
beth init

Then open VS Code, switch Copilot Chat to Agent mode, and type @Beth.

For detailed setup (prerequisites, task tracking, MCP servers): docs/INSTALLATION.md

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 WHAT to build: PRDs, user stories, priorities, success metrics.
@researcher The Intelligence Competitive analysis, user insights, market dirt.
@ux-designer The Architect HOW it works: component specs, design tokens, accessibility.
@developer The Builder React/TypeScript/Next.js - UI and full-stack. Gets it done.
@tester The Enforcer Quality assurance, accessibility, performance. Finds every crack.
@security-reviewer The Bodyguard Enterprise security. Vulnerabilities, compliance, threat modeling.

Product Manager vs UX Designer

Product Manager UX Designer
Focus WHAT to build, WHY, WHEN HOW it looks, feels, behaves
Outputs PRDs, user stories, priorities Component specs, design tokens, accessibility
Example "Users need date filtering" "Date picker: variants, states, ARIA"

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)
     ├──▶ @developer (implementation)
     ├──▶ @tester (quality gate)
     └──▶ @security-reviewer (protection)

The Workflow

New Feature?

Request → Product (requirements) → Research (validation) → Design (interface) 
       → Developer (build) → 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)

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.
@developer 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        
│   ├── developer.agent.md          # UI + full-stack
│   ├── tester.agent.md             
│   └── security-reviewer.agent.md  # 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?

Beth

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
Azure Cloud resource management See MCP Setup Guide
Web Search Internet research See MCP Setup Guide

Full details: docs/MCP-SETUP.md

License

MIT — Take it. Run it. Build empires.


Built with the kind of ferocity that would make John Dutton proud.

About

Beth is the ruthless, hyper-competent agent orchestrator who runs your dev team like a boss. Routes work to specialized agents, creates and tracks work with Backlog.md, and delivers results without excuses. Built for GitHub Copilot.

Resources

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%