Snap Squad

Skip the interview. Start building.

Get a working Squad in one command. No setup. No interviews. Just a team that's ready to ship.

Quick Start

mkdir my-project && cd my-project
npx snap-squad init

That's it. You now have the default squad — a reliable generalist team with routing rules, agent charters, and decision logging. Open Copilot and start building:

copilot
# Or open VS Code — your squad is already wired in

Need speed instead?

npx snap-squad init I need a fast team for a hackathon

Snap Squad reads your description and picks fast — a speed-focused squad built for rapid POCs. No fluff, no ceremony, just velocity.

Describe what you need. Get the right team.

npx snap-squad init help me learn best practices    # → mentors
npx snap-squad init database security hardening      # → specialists
npx snap-squad init something is on fire debug help  # → specialists (Chuck is already on his way)
npx snap-squad init                                  # → default
npx snap-squad init --type fast                      # → pick directly

Regenerate safely

npx snap-squad init --force      # refresh structural templates, keep JOURNAL.md + .squad/decisions.md
npx snap-squad init --reset-all  # overwrite every generated file for a true clean slate

When --force preserves a content file, Snap Squad prints a warning so you know it left your journal or decisions log alone.

What Is Squad?

Squad gives you AI agent teams for any project — a multi-agent runtime built on GitHub Copilot. You define your team, route work to specialists, and ship faster.

The catch? Setting up a new squad takes time. Interviews, charters, routing config. For a big project, that's worth it. For a quick POC? It's friction.

Snap Squad removes the friction. One command, full squad, zero interview.

Presets

Preset	Vibe	Agents	Best For
default	Generalist	Architect, Coder, Tester, DevRel, Prompter, GitOps, Evaluator (light evals), Researcher, Scribe	General-purpose projects, reliable building
fast	Speed	Architect, Coder (full-stack), Tester (test + docs)	Rapid POCs, hackathons, zero fluff
mentors	Mentor	Architect, Coder (mentor dev), Tester (quality mentor), DocWriter, Prompter, Evaluator, Researcher, Scribe	Learning, best practices, architecture review
specialists	Precision	Debugger 🥋, Architect, Backend (data), Security, Frontend (UI/UX), DevOps (infra), Evaluator (deep evals), Auditor (skill audit), EvalRunner (skill bench), Swarm (mass ops), Researcher (deep research), Scribe	DB tuning, security hardening, mass ops, troubleshooting

default does light evals (Evaluator spot-checks baselines). Need a full eval pipeline? specialists brings Evaluator for deep eval architecture plus Auditor and EvalRunner for skill benchmarking.

Click any preset name above to see the full roster — every agent's role, personality, routing rules, and when to use them.

These aren't blank templates. They're squad configurations shaped by real project experience at CoreAI — tested routing rules, proven agent roles, and practical defaults.

What Gets Created

your-project/
├── .squad/
│   ├── team.md              # Who's on the team
│   ├── routing.md           # How work gets routed
│   ├── decisions.md         # Decision log
│   ├── mcp-config.md        # MCP tool config
│   └── agents/
│       ├── architect/charter.md
│       ├── coder/charter.md
│       └── ...
├── AGENTS.md                # AI agent instructions (any tool)
├── CLAUDE.md                # Claude/Copilot CLI session memory
└── .github/
    └── copilot-instructions.md  # GitHub Copilot instructions

The hook chain (AGENTS.md + CLAUDE.md + copilot-instructions.md) makes every AI session squad-aware — regardless of which tool opens your workspace.

After Bootstrap: Plain English

Once your squad is initialized, just talk to it:

> switch my squad to the mentors preset
> add a security specialist to my team
> show me my squad routing rules

The generated instructions teach your AI how to manage the squad. No special syntax needed.

Browse Presets

npx snap-squad list

Want the Full Squad Runtime?

Snap Squad gets you started. The Squad CLI takes it further — interactive shell, triage, hire, and more:

npm install -g @bradygaster/squad-cli
squad

Why Not Just Use Squad Directly?

You should! Squad's built-in setup is great for tailored teams. Snap Squad is for when you want to:

Start in seconds — working squad before your coffee gets cold
Learn from others — presets shaped by builders who ship with Squad daily
Reuse patterns — same team shape across multiple projects
Onboard people — give someone a working squad without the interview

The goal is to contribute these presets upstream to Squad.

Status

🚧 Alpha — Built by its own squad (dogfooding FTW).

How This Was Built

This project was built with AI assistance, steered by a human builder. The full story — every steering moment, key decision, and evolution arc — is in the build journal.

License

MIT

paulyuk/snap-squad

README