Snap Squad EMU

⚠️ Microsoft internal variant of snap-squad — secure-by-design defaults, SFI-grounded Security agent, and Product Launch Readiness preset.

Skip the interview. Start building — securely.

Get a squad-aware AI workspace with Azure PLR and SFI built in. Same one-command UX as snap-squad, with Microsoft-internal presets.

Quick Start

mkdir my-project && cd my-project
npx snap-squad-emu 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-emu init I need a fast team for a hackathon

Snap Squad EMU 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-emu init help me learn best practices    # → mentors
npx snap-squad-emu init database security hardening      # → specialists
npx snap-squad-emu init PLR readiness for GA launch      # → product-launch-readiness
npx snap-squad-emu init                                  # → default (secure-by-design)
npx snap-squad-emu init --type fast                      # → pick directly

Regenerate safely

npx snap-squad-emu init --force      # refresh structural templates, keep JOURNAL.md + .squad/decisions.md
npx snap-squad-emu 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 EMU removes the friction. One command, full squad, zero interview — with secure-by-design defaults and PLR readiness built in.

What's Different From snap-squad?

| Feature | snap-squad | snap-squad-emu | |---------|-----------|----------------| | Secure-by-design Architect | ❌ | ✅ SFI-grounded (aka.ms/sfi) | | Security agent (default) | ❌ | ✅ SFI + Azure security baselines | | PLR preset | ❌ | ✅ 19 agents covering all PLR headings | | Accessibility agent | ❌ | ✅ WCAG 2.1 AA, cross-cutting | | Azure skills references | ❌ | ✅ aka.ms/azure-skills |

Content Guardrail

No sensitive Microsoft internal information is stored inline in this package. All internal references use URLs, MCP server configs, and tool pointers that agents fetch at runtime. This keeps the published npm package safe.

Presets

| Preset | Vibe | Agents | Best For | |--------|------|--------|----------| | default | Generalist | Architect (secure-by-design), Coder, Tester, DevRel, Prompter, GitOps, Evaluator, Researcher, Scribe, Security (SFI) | General-purpose projects, secure defaults | | 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 | | product-launch-readiness | PLR | All default agents + Governance, Compliance, Reliability, QualityLead, Deployer, Support, Enablement, Accessibility (cross-cutting) | Azure GA/Preview sign-off, PLR checklists |

default now includes a Security agent grounded on SFI. Need full PLR coverage? product-launch-readiness adds Governance, Compliance, Reliability, Deployer, Support, Enablement, and Accessibility agents — one per PLR checklist heading.

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-emu 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.

Upstream Relationship

This repo is a mirror of the public paulyuk/snap-squad. See UPSTREAM.md for the full topology, sync workflow, and planned personal EMU fork.

paulyuk/snap-squad                    ← public source of truth, npm publishes
  └─► coreai-microsoft/snap_squad     ← this repo (EMU org mirror + MSFT customizations)
        └─► paulyuk_microsoft/snap_squad  ← planned personal EMU fork for dev work

Contributions: Bug fixes and features should go upstream to paulyuk/snap-squad. Microsoft-specific changes (compliance, templates, internal customizations) stay here.

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