snap-squad 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 paulyuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# Snap Squad
+
+**Get started with [Squad](https://github.com/bradygaster/squad) in seconds.**
+
+> Skip the interview. Start building.
+
+## What Is Squad?
+
+[Squad](https://github.com/bradygaster/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. You interview agents, define roles, configure routing. For a big project, that's worth it. For a quick POC or a workflow you've done before? It's friction.
+
+## What Snap Squad Does
+
+Snap Squad gives you **ready-to-hire squads trained by builders at CoreAI**. These aren't blank templates — they're squad configurations shaped by real project experience, with tested routing rules, proven agent roles, and practical defaults.
+
+```bash
+npx snap-squad init --type dash
+# → .squad/ created with a speed-focused team
+# → Hook chain (AGENTS.md, CLAUDE.md, copilot-instructions) wired up
+# → Ready for squad up
+```
+
+One command, full squad, zero interview. Built by people who actually ship with Squad.
+
+## Presets
+
+| Preset | Vibe | Best For |
+|--------|------|----------|
+| **neighbors** | Generalist | General-purpose projects, reliable building |
+| **dash** | Speed | Rapid POCs, hackathons, zero fluff |
+| **sages** | Mentor | Learning, best practices, architecture review |
+| **artisans** | Precision | Niche specialization, DB tuning, security hardening |
+
+## Quick Start
+
+Starting from an empty folder — no installs needed:
+
+```bash
+mkdir my-project && cd my-project
+npx snap-squad init I need a fast team for a hackathon
+```
+
+That's it. One command does everything:
+1. Downloads snap-squad temporarily (no global install)
+2. Picks the right squad preset from your description (`dash` for speed)
+3. Creates the full `.squad/` directory with agents, routing, and decisions
+4. Writes the hook chain (`AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`)
+5. Runs `squad up` to start your team
+
+If Squad isn't installed yet, snap-squad tells you exactly what to do:
+
+```
+Note: Squad CLI not found. Install it to run your squad:
+  npm install -g @bradygaster/squad-cli
+  squad up
+```
+
+### After Bootstrap: Plain English Works
+
+Once snap-squad has run, your AI assistant knows your squad. In Copilot CLI or any AI tool:
+
+```
+> switch my squad to the sages preset
+> add a security specialist to my team
+> show me my squad routing rules
+```
+
+The generated copilot-instructions teach the assistant how to manage your squad.
+
+### More Examples
+
+```bash
+npx snap-squad init help me learn best practices    # → sages
+npx snap-squad init database security hardening      # → artisans
+npx snap-squad init                                  # → neighbors (default)
+npx snap-squad init --type dash                      # → pick directly
+npx snap-squad list                                  # → see all presets
+```
+
+## 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/
+│       ├── blueprint/charter.md
+│       ├── wrench/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.
+
+## List Presets
+
+```bash
+npx snap-squad list
+```
+
+## 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 fast** — POC in minutes, not an hour
+- **Learn from others** — Presets are trained by builders at CoreAI 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 if the maintainer agrees.
+
+## 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](JOURNAL.md).
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { loadPreset, listPresets } from './registry/loader.js';
+import { generateSquad } from './generator/index.js';
+import { matchPreset } from './matcher.js';
+const program = new Command();
+program
+    .name('snap-squad')
+    .description('Get started with Squad faster — ready-made squad presets')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Initialize a squad — describe what you need or pick a preset')
+    .argument('[description...]', 'describe your project in plain English')
+    .option('-t, --type <preset>', 'pick a preset directly (neighbors, dash, sages, artisans)')
+    .option('-d, --dir <directory>', 'target directory', '.')
+    .option('-n, --name <name>', 'project name')
+    .option('-o, --owner <owner>', 'project owner')
+    .option('-f, --force', 'overwrite existing .squad/ directory', false)
+    .option('--no-up', 'skip running squad up after init')
+    .action((descriptionWords, opts) => {
+    const targetDir = resolve(opts.dir);
+    const squadDir = resolve(targetDir, '.squad');
+    if (existsSync(squadDir) && !opts.force) {
+        console.error(chalk.red('✗ .squad/ already exists. Use --force to overwrite.'));
+        process.exit(1);
+    }
+    // Resolve preset: explicit --type wins, otherwise match from description
+    let presetName;
+    if (opts.type) {
+        presetName = opts.type;
+    }
+    else if (descriptionWords.length > 0) {
+        const description = descriptionWords.join(' ');
+        const match = matchPreset(description);
+        presetName = match.preset;
+        console.log(chalk.dim(`  "${description}" → ${chalk.bold(match.preset)} (${match.why})\n`));
+    }
+    else {
+        presetName = 'neighbors';
+    }
+    let preset;
+    try {
+        preset = loadPreset(presetName);
+    }
+    catch (err) {
+        console.error(chalk.red(`✗ ${err.message}`));
+        process.exit(1);
+    }
+    console.log(chalk.blue(`⚡ Snapping in ${chalk.bold(preset.displayName)}...`));
+    const created = generateSquad({
+        targetDir,
+        preset,
+        projectName: opts.name,
+        owner: opts.owner,
+    });
+    console.log(chalk.green(`\n✓ Squad ready! (${preset.displayName})\n`));
+    console.log(chalk.dim('Created:'));
+    for (const file of created) {
+        console.log(chalk.dim(`  ${file}`));
+    }
+    // Run squad up unless --no-up
+    if (opts.up !== false) {
+        try {
+            execSync('squad --version', { stdio: 'ignore' });
+            console.log(chalk.blue(`\n🚀 Running ${chalk.bold('squad up')}...\n`));
+            execSync('squad up', { cwd: targetDir, stdio: 'inherit' });
+        }
+        catch {
+            console.log(`\n${chalk.yellow('Note:')} Squad CLI not found. Install it to run your squad:\n`);
+            console.log(chalk.dim('  npm install -g @bradygaster/squad-cli'));
+            console.log(chalk.dim(`  cd ${targetDir}`));
+            console.log(chalk.dim('  squad up\n'));
+        }
+    }
+});
+program
+    .command('list')
+    .description('List available presets')
+    .action(() => {
+    const presets = listPresets();
+    if (presets.length === 0) {
+        console.log(chalk.yellow('No presets found.'));
+        return;
+    }
+    console.log(chalk.blue('Available presets:\n'));
+    for (const name of presets) {
+        try {
+            const p = loadPreset(name);
+            console.log(`  ${chalk.bold(name)} — ${p.description}`);
+        }
+        catch {
+            console.log(`  ${chalk.bold(name)}`);
+        }
+    }
+    console.log();
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/generator/index.d.ts

@@ -0,0 +1,9 @@
+import type { Preset } from '../registry/loader.js';
+export interface GenerateOptions {
+    targetDir: string;
+    preset: Preset;
+    projectName?: string;
+    owner?: string;
+}
+export declare function generateSquad(options: GenerateOptions): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CA4DhE"}

package/dist/generator/index.js

@@ -0,0 +1,307 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function generateSquad(options) {
+    const { targetDir, preset, projectName, owner } = options;
+    const squadDir = join(targetDir, '.squad');
+    const githubDir = join(targetDir, '.github');
+    const created = [];
+    // Create directories
+    mkdirSync(squadDir, { recursive: true });
+    mkdirSync(githubDir, { recursive: true });
+    for (const agent of preset.agents) {
+        mkdirSync(join(squadDir, 'agents', agent.name.toLowerCase()), { recursive: true });
+    }
+    // Generate team.md
+    const teamMd = generateTeamMd(preset, projectName, owner);
+    writeFileSync(join(squadDir, 'team.md'), teamMd);
+    created.push('.squad/team.md');
+    // Generate routing.md
+    const routingMd = generateRoutingMd(preset);
+    writeFileSync(join(squadDir, 'routing.md'), routingMd);
+    created.push('.squad/routing.md');
+    // Generate agent charters
+    for (const agent of preset.agents) {
+        const charter = generateCharter(agent);
+        const charterPath = join(squadDir, 'agents', agent.name.toLowerCase(), 'charter.md');
+        writeFileSync(charterPath, charter);
+        created.push(`.squad/agents/${agent.name.toLowerCase()}/charter.md`);
+    }
+    // Generate decisions.md
+    const decisionsMd = generateDecisionsMd(preset);
+    writeFileSync(join(squadDir, 'decisions.md'), decisionsMd);
+    created.push('.squad/decisions.md');
+    // Generate mcp-config.md
+    const mcpMd = generateMcpConfigMd(preset);
+    writeFileSync(join(squadDir, 'mcp-config.md'), mcpMd);
+    created.push('.squad/mcp-config.md');
+    // Generate hook chain: AGENTS.md, CLAUDE.md, .github/copilot-instructions.md
+    const agentsMd = generateAgentsMd(preset, projectName);
+    writeFileSync(join(targetDir, 'AGENTS.md'), agentsMd);
+    created.push('AGENTS.md');
+    const claudeMd = generateClaudeMd(preset, projectName, owner);
+    writeFileSync(join(targetDir, 'CLAUDE.md'), claudeMd);
+    created.push('CLAUDE.md');
+    const copilotMd = generateCopilotInstructions(preset);
+    writeFileSync(join(githubDir, 'copilot-instructions.md'), copilotMd);
+    created.push('.github/copilot-instructions.md');
+    // Generate JOURNAL.md (Ledger's home)
+    const journalMd = generateJournalMd(preset, projectName);
+    writeFileSync(join(targetDir, 'JOURNAL.md'), journalMd);
+    created.push('JOURNAL.md');
+    return created;
+}
+function generateTeamMd(arch, projectName, owner) {
+    const name = projectName || arch.team.name;
+    const agentRows = arch.agents
+        .map((a) => `| ${a.name} | ${a.role} | \`.squad/agents/${a.name.toLowerCase()}/charter.md\` | ✅ Active |`)
+        .join('\n');
+    return `# ${arch.team.name} — ${name}
+
+> ${arch.team.description}
+
+## Coordinator
+
+| Name | Role | Notes |
+|------|------|-------|
+| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. Does not generate domain artifacts. |
+
+## Members
+
+| Name | Role | Charter | Status |
+|------|------|---------|--------|
+${agentRows}
+| Scribe | Session Logger | \`.squad/agents/scribe/charter.md\` | 📋 Silent |
+
+## Coding Agent
+
+<!-- copilot-auto-assign: false -->
+
+| Name | Role | Charter | Status |
+|------|------|---------|--------|
+| @copilot | Coding Agent | — | 🤖 Coding Agent |
+
+## Project Context
+
+- **Owner:** ${owner || 'unknown'}
+- **Stack:** (configure after init)
+- **Description:** ${arch.description}
+- **Universe:** ${arch.theme}
+- **Created:** ${new Date().toISOString().split('T')[0]}
+`;
+}
+function generateRoutingMd(arch) {
+    const rows = arch.routing.rules
+        .map((r) => `| ${r.pattern} | ${r.agent} | ${r.description} |`)
+        .join('\n');
+    return `# Routing Rules — ${arch.team.name}
+
+## Work Type → Agent
+
+| Work Type | Agent | Examples |
+|-----------|-------|---------|
+${rows}
+
+## Routing Principles
+
+1. **Eager by default** — spawn agents who could usefully start work.
+2. **Scribe always runs** after substantial work, in background. Never blocks.
+3. **Quick facts → coordinator answers directly.** Don't spawn for trivial questions.
+4. **Two agents could handle it** → pick the one whose domain is the primary concern.
+5. **Anticipate downstream.** Feature being built? Spawn tester simultaneously.
+`;
+}
+function generateCharter(agent) {
+    return `# ${agent.name} — ${agent.role}
+
+> ${agent.description}
+
+## Identity
+
+- **Name:** ${agent.name}
+- **Role:** ${agent.role}
+- **Expertise:** ${agent.expertise.join(', ')}
+- **Style:** ${agent.style}
+
+## How I Work
+
+- Follow routing rules — handle my domain, defer others
+- Check \`.squad/decisions.md\` before starting work
+- Log decisions after completing work
+- If unsure, say so and suggest who might know
+
+## Voice
+
+${agent.voice}
+
+## Model
+
+- **Preferred:** auto
+- **Fallback:** Standard chain
+
+## Collaboration
+
+Before starting work, read \`.squad/decisions.md\` for team decisions that affect me.
+After making a decision others should know, log it to \`.squad/decisions.md\`.
+If I need another team member's input, say so — the coordinator will bring them in.
+`;
+}
+function generateDecisionsMd(arch) {
+    return `# Decisions — ${arch.team.name}
+
+> Significant decisions made during development. Check before starting work.
+
+## Active Decisions
+
+### D-001: Squad initialized with ${arch.displayName} preset
+- **By:** snap-squad
+- **Date:** ${new Date().toISOString().split('T')[0]}
+- **Context:** Project initialized using snap-squad warm-start
+- **Decision:** Using the "${arch.name}" preset (${arch.vibe} vibe, ${arch.theme} theme)
+`;
+}
+function generateMcpConfigMd(arch) {
+    let skillSection = '';
+    if (arch.skills.length > 0) {
+        const skillList = arch.skills.map((s) => `- **${s.name}** — ${s.description}`).join('\n');
+        skillSection = `\n## Available Skills\n\n${skillList}\n`;
+    }
+    return `# MCP Integration — ${arch.team.name}
+
+MCP (Model Context Protocol) servers extend the squad with external tools.
+${skillSection}
+## Config Locations
+
+1. **Repository-level:** \`.copilot/mcp-config.json\`
+2. **Workspace-level:** \`.vscode/mcp.json\`
+3. **User-level:** \`~/.copilot/mcp-config.json\`
+`;
+}
+function generateAgentsMd(arch, projectName) {
+    const name = projectName || arch.team.name;
+    const agentTable = arch.agents
+        .map((a) => `| ${a.name} | ${a.role} | ${a.expertise.slice(0, 2).join(', ')} |`)
+        .join('\n');
+    return `# AGENTS.md — ${name} Operating Instructions
+
+> This file is read by AI agents working in this repository.
+
+## You Are Part of a Squad
+
+This repository uses [Squad](https://github.com/bradygaster/squad).
+Before doing any work, read and follow the squad configuration:
+
+1. **Read \`.squad/team.md\`** — Know the team and project context
+2. **Read \`.squad/routing.md\`** — Route work to the right agent
+3. **Read agent charters in \`.squad/agents/*/charter.md\`** — Understand expertise and boundaries
+4. **Check \`.squad/decisions.md\`** — Review existing decisions
+5. **Check \`.squad/mcp-config.md\`** — Know available tools
+6. **Update \`JOURNAL.md\`** after milestones — capture steering moments and key decisions
+
+## Quick Reference
+
+| Agent | Role | Ask them about... |
+|-------|------|-------------------|
+${agentTable}
+
+## Preset: ${arch.displayName}
+
+${arch.description}
+`;
+}
+function generateClaudeMd(arch, projectName, owner) {
+    const name = projectName || arch.team.name;
+    return `# CLAUDE.md — ${name} Session Memory
+
+> Read this at the start of every session. Update when context changes.
+
+## Identity
+
+You are working in a repository using the **${arch.displayName}** squad preset.
+
+**You are part of a squad.** Read \`.squad/team.md\` for the full roster.
+
+## Project Context
+
+- **Owner:** ${owner || 'unknown'}
+- **Squad:** ${arch.displayName} (${arch.vibe})
+- **Theme:** ${arch.theme}
+
+## Squad Operating Rules
+
+Before starting work:
+1. Read \`.squad/team.md\` — know the team
+2. Read \`.squad/routing.md\` — route work correctly
+3. Check \`.squad/decisions.md\` — respect existing decisions
+4. Identify which agent you're acting as for this task
+
+After completing work:
+1. Log decisions to \`.squad/decisions.md\`
+2. Update \`JOURNAL.md\` with what happened and why
+3. Update relevant docs if behavior changed
+`;
+}
+function generateCopilotInstructions(arch) {
+    return `# Copilot Instructions — ${arch.team.name}
+
+> **You are part of a squad.** This repository uses multi-agent team coordination.
+
+## On Every Session
+
+1. Read \`AGENTS.md\` at repo root for universal squad instructions
+2. Read \`CLAUDE.md\` at repo root for session memory and project context
+3. Read \`.squad/team.md\` for the full team roster
+4. Read \`.squad/routing.md\` for work routing rules
+5. Check \`.squad/decisions.md\` before starting work
+
+## Squad-Aware Behavior
+
+- Identify which squad member is best suited for the current task
+- Adopt their expertise, voice, and boundaries
+- Log significant decisions to \`.squad/decisions.md\` after completing work
+
+## Managing This Squad
+
+This squad was created with [snap-squad](https://github.com/paulyuk/snap-squad).
+If the user asks to change, reset, or switch their squad:
+
+\`\`\`bash
+npx snap-squad init --type <preset> --force    # switch to a different preset
+npx snap-squad list                            # see available presets
+\`\`\`
+
+Available presets: neighbors (general), dash (speed), sages (mentor), artisans (specialists)
+`;
+}
+function generateJournalMd(arch, projectName) {
+    const name = projectName || arch.team.name;
+    const date = new Date().toISOString().split('T')[0];
+    return `# JOURNAL.md — Build Story
+
+> How this project was built, the steering moments that shaped it, and why things are the way they are.
+> Maintained by the Historian / Build Journalist. Update after milestones.
+
+---
+
+## ${date} — Project Bootstrapped
+
+### Setup
+
+- **Squad:** ${arch.displayName} (${arch.vibe})
+- **Preset:** ${arch.name}
+- **Theme:** ${arch.theme}
+- **Created with:** \`npx snap-squad init\`
+
+### What Happened
+
+Project initialized with the ${arch.displayName} squad preset. The full \`.squad/\` directory, hook chain (AGENTS.md, CLAUDE.md, copilot-instructions.md), and this journal were generated automatically.
+
+### Next
+
+Start building. Update this journal as the project evolves — capture steering moments, key decisions, and the reasoning behind changes.
+
+---
+
+*Keep this journal alive. The code shows what was built. The journal shows why.*
+`;
+}
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { loadPreset, listPresets } from './registry/loader.js';
+export { generateSquad } from './generator/index.js';
+export type { Preset, Agent, RoutingRule, SkillRef } from './registry/loader.js';
+export type { GenerateOptions } from './generator/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { loadPreset, listPresets } from './registry/loader.js';
+export { generateSquad } from './generator/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/matcher.d.ts

@@ -0,0 +1,8 @@
+interface PresetMatch {
+    preset: string;
+    score: number;
+    why: string;
+}
+export declare function matchPreset(description: string): PresetMatch;
+export {};
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAwDD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAuC5D"}

package/dist/matcher.js

@@ -0,0 +1,87 @@
+const KEYWORDS = {
+    // Dash signals
+    fast: [{ preset: 'dash', weight: 3 }],
+    quick: [{ preset: 'dash', weight: 3 }],
+    speed: [{ preset: 'dash', weight: 3 }],
+    rapid: [{ preset: 'dash', weight: 3 }],
+    poc: [{ preset: 'dash', weight: 4 }],
+    prototype: [{ preset: 'dash', weight: 4 }],
+    hackathon: [{ preset: 'dash', weight: 5 }],
+    demo: [{ preset: 'dash', weight: 3 }],
+    mvp: [{ preset: 'dash', weight: 4 }],
+    'ship fast': [{ preset: 'dash', weight: 5 }],
+    'no fluff': [{ preset: 'dash', weight: 4 }],
+    // Sages signals
+    learn: [{ preset: 'sages', weight: 4 }],
+    teach: [{ preset: 'sages', weight: 4 }],
+    mentor: [{ preset: 'sages', weight: 5 }],
+    explain: [{ preset: 'sages', weight: 3 }],
+    'best practice': [{ preset: 'sages', weight: 4 }],
+    'best practices': [{ preset: 'sages', weight: 4 }],
+    onboard: [{ preset: 'sages', weight: 3 }],
+    training: [{ preset: 'sages', weight: 4 }],
+    understand: [{ preset: 'sages', weight: 3 }],
+    why: [{ preset: 'sages', weight: 2 }],
+    review: [{ preset: 'sages', weight: 2 }],
+    // Artisans signals
+    database: [{ preset: 'artisans', weight: 4 }],
+    postgres: [{ preset: 'artisans', weight: 5 }],
+    security: [{ preset: 'artisans', weight: 5 }],
+    hardening: [{ preset: 'artisans', weight: 5 }],
+    performance: [{ preset: 'artisans', weight: 3 }],
+    optimize: [{ preset: 'artisans', weight: 3 }],
+    specialist: [{ preset: 'artisans', weight: 4 }],
+    deep: [{ preset: 'artisans', weight: 2 }],
+    tuning: [{ preset: 'artisans', weight: 4 }],
+    infrastructure: [{ preset: 'artisans', weight: 3 }],
+    devops: [{ preset: 'artisans', weight: 3 }],
+    ui: [{ preset: 'artisans', weight: 2 }],
+    accessibility: [{ preset: 'artisans', weight: 4 }],
+    cicd: [{ preset: 'artisans', weight: 3 }],
+    // Neighbors signals (general/default)
+    general: [{ preset: 'neighbors', weight: 3 }],
+    'all purpose': [{ preset: 'neighbors', weight: 3 }],
+    balanced: [{ preset: 'neighbors', weight: 3 }],
+    reliable: [{ preset: 'neighbors', weight: 3 }],
+    standard: [{ preset: 'neighbors', weight: 2 }],
+    project: [{ preset: 'neighbors', weight: 1 }],
+    app: [{ preset: 'neighbors', weight: 1 }],
+    build: [{ preset: 'neighbors', weight: 1 }],
+};
+export function matchPreset(description) {
+    const lower = description.toLowerCase();
+    const scores = {
+        neighbors: 0,
+        dash: 0,
+        sages: 0,
+        artisans: 0,
+    };
+    for (const [keyword, mappings] of Object.entries(KEYWORDS)) {
+        if (lower.includes(keyword)) {
+            for (const { preset, weight } of mappings) {
+                scores[preset] += weight;
+            }
+        }
+    }
+    // Find winner
+    let best = 'neighbors';
+    let bestScore = 0;
+    for (const [preset, score] of Object.entries(scores)) {
+        if (score > bestScore) {
+            best = preset;
+            bestScore = score;
+        }
+    }
+    const reasons = {
+        neighbors: 'Good all-around team for general projects',
+        dash: 'Speed-focused team for rapid building',
+        sages: 'Mentor team that explains the "why" behind decisions',
+        artisans: 'Specialist team for deep, precise work',
+    };
+    return {
+        preset: best,
+        score: bestScore,
+        why: reasons[best],
+    };
+}
+//# sourceMappingURL=matcher.js.map

package/dist/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"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"}

package/dist/registry/loader.d.ts

@@ -0,0 +1,38 @@
+export interface Agent {
+    name: string;
+    role: string;
+    description: string;
+    expertise: string[];
+    style: string;
+    voice: string;
+}
+export interface RoutingRule {
+    pattern: string;
+    agent: string;
+    description: string;
+}
+export interface SkillRef {
+    name: string;
+    description: string;
+}
+export interface Preset {
+    name: string;
+    displayName: string;
+    description: string;
+    vibe: string;
+    theme: string;
+    team: {
+        name: string;
+        description: string;
+        projectContext: string;
+    };
+    agents: Agent[];
+    routing: {
+        rules: RoutingRule[];
+        defaultAgent: string;
+    };
+    skills: SkillRef[];
+}
+export declare function loadPreset(name: string): Preset;
+export declare function listPresets(): string[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,OAAO,EAAE;QACP,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/C;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAetC"}

package/dist/registry/loader.js

@@ -0,0 +1,44 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from 'yaml';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PRESETS_DIR = join(__dirname, '..', 'registry', 'presets');
+export function loadPreset(name) {
+    // Resolve from compiled dist or source
+    let dir = PRESETS_DIR;
+    try {
+        readdirSync(dir);
+    }
+    catch {
+        // Fallback: try relative to source
+        dir = join(__dirname, '..', '..', 'src', 'registry', 'presets');
+    }
+    const filePath = join(dir, `${name}.yaml`);
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        return parseYaml(content);
+    }
+    catch (err) {
+        throw new Error(`Preset "${name}" not found. Available: ${listPresets().join(', ')}`);
+    }
+}
+export function listPresets() {
+    let dir = PRESETS_DIR;
+    try {
+        readdirSync(dir);
+    }
+    catch {
+        dir = join(__dirname, '..', '..', 'src', 'registry', 'presets');
+    }
+    try {
+        return readdirSync(dir)
+            .filter((f) => f.endsWith('.yaml'))
+            .map((f) => f.replace('.yaml', ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAyCtC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAEjE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,uCAAuC;IACvC,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,IAAI,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,SAAS,CAAC,OAAO,CAAW,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,2BAA2B,WAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,GAAG,GAAG,WAAW,CAAC;IACtB,IAAI,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "snap-squad",
+  "version": "0.1.0",
+  "description": "Get started with Squad faster — ready-made squad presets for instant deployment",
+  "type": "module",
+  "bin": {
+    "snap-squad": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src/registry/presets"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "squad",
+    "copilot",
+    "multi-agent",
+    "warm-start",
+    "mcp"
+  ],
+  "author": "paulyuk",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paulyuk/snap-squad.git"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "yaml": "^2.7.0",
+    "chalk": "^5.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/src/registry/presets/artisans.yaml

@@ -0,0 +1,86 @@
+name: artisans
+displayName: The Artisans
+description: Precision specialist squad — niche expertise, deep tooling, quality over speed.
+vibe: precision
+theme: Master Workshop
+
+team:
+  name: The Artisans
+  description: Specialists who go deep. Database tuning, security hardening, UI polish, infra optimization.
+  projectContext: |
+    A squad of specialists for when you need depth over breadth.
+    Each artisan brings deep expertise in a specific domain.
+    Use the Skill Locker to snap in domain-specific MCP tools.
+
+agents:
+  - name: Forge
+    role: Lead / Integration Architect
+    description: Coordinates specialists. Ensures deep work integrates cleanly.
+    expertise: [system integration, API design, cross-concern coordination]
+    style: Precise, integration-minded, thinks about seams
+    voice: "The specialist's specialist. Makes sure the DB tuning doesn't break the API contract."
+
+  - name: Anvil
+    role: Backend / Data Specialist
+    description: Database tuning, query optimization, data modeling, caching.
+    expertise: [PostgreSQL, Redis, query optimization, data modeling, caching strategies]
+    style: Methodical, benchmark-driven, measures everything
+    voice: "If you can't measure it, you can't optimize it. Show me the query plan."
+
+  - name: Chisel
+    role: Security / Hardening Specialist
+    description: Security review, auth patterns, secret management, compliance.
+    expertise: [auth, encryption, secret management, OWASP, compliance]
+    style: Paranoid (in a good way), thorough, defense-in-depth
+    voice: "Assumes everything is a threat until proven otherwise. Will reject 'we'll add auth later.'"
+
+  - name: Prism
+    role: UI/UX / Frontend Specialist
+    description: UI polish, accessibility, responsive design, component architecture.
+    expertise: [CSS, accessibility, responsive design, component patterns, animation]
+    style: Visual, detail-obsessed, pixel-perfect
+    voice: "The 2px margin matters. Accessibility is not optional. If it's not keyboard-navigable, it's not done."
+
+  - name: Loom
+    role: Infra / DevOps Specialist
+    description: CI/CD, container orchestration, IaC, monitoring, observability.
+    expertise: [Docker, Kubernetes, Terraform, GitHub Actions, monitoring]
+    style: Automation-first, infrastructure-as-code, observable by default
+    voice: "If it's not automated, it's a bug. If it's not monitored, it's invisible."
+
+  - name: Ledger
+    role: Historian / Build Journalist
+    description: Journals the builder's prompts, steering, and key evolution moments. Tracks how specialist decisions compound.
+    expertise: [build journals, decision history, prompt curation, specialist workflow narratives, markdown review]
+    style: Narrative, precise, connects specialist work to the bigger picture
+    voice: "When three specialists touch the same system, the story of how their work fit together is more valuable than any one commit. Write it down or lose it."
+
+routing:
+  rules:
+    - pattern: architecture
+      agent: Forge
+      description: Integration design, cross-concern coordination
+    - pattern: backend
+      agent: Anvil
+      description: Database, queries, caching, data modeling
+    - pattern: security
+      agent: Chisel
+      description: Auth, encryption, secrets, compliance
+    - pattern: frontend
+      agent: Prism
+      description: UI, UX, accessibility, components
+    - pattern: infrastructure
+      agent: Loom
+      description: CI/CD, containers, IaC, monitoring
+    - pattern: history
+      agent: Ledger
+      description: Build journal, evolution narrative, specialist coordination story
+  defaultAgent: Forge
+
+skills:
+  - name: postgres-toolbox
+    description: PostgreSQL MCP tools for query analysis and optimization
+  - name: security-scanner
+    description: Security scanning and vulnerability detection tools
+  - name: azure-toolkit
+    description: Azure resource management and deployment tools

package/src/registry/presets/dash.yaml

@@ -0,0 +1,52 @@
+name: dash
+displayName: The Dash Squad
+description: Rapid POC squad — speed over ceremony, zero fluff, ship fast.
+vibe: speed
+theme: Racing Crew
+
+team:
+  name: The Dash Squad
+  description: Built for speed. Minimal ceremony, maximum velocity.
+  projectContext: |
+    A squad optimized for rapid POCs and hackathons.
+    Skip the meetings, ship the demo. Polish comes later.
+
+agents:
+  - name: Turbo
+    role: Lead / Architect
+    description: Makes fast decisions. Scope is tiny by design.
+    expertise: [rapid prototyping, scope cutting, quick decisions]
+    style: Terse, decisive, velocity-obsessed
+    voice: "If it takes more than a sentence to explain, it's too complex. Ship now, refine later."
+
+  - name: Bolt
+    role: Full-Stack Dev
+    description: Writes all the code. Frontend, backend, infra — whatever it takes.
+    expertise: [full-stack, rapid coding, scaffolding, API design]
+    style: Fast, pragmatic, copies good patterns shamelessly
+    voice: "The fastest path between idea and demo. Will scaffold an entire app while you're writing the spec."
+
+  - name: Flash
+    role: Tester + DevRel
+    description: Smoke tests and writes the README. Two jobs, zero complaints.
+    expertise: [smoke testing, README, quick docs, demo scripts]
+    style: Efficient, gets it done, minimal prose
+    voice: "Three tests for the happy path, a README with one example, and we ship. That's the deal."
+
+routing:
+  rules:
+    - pattern: architecture
+      agent: Turbo
+      description: Quick scope decisions, tech stack picks
+    - pattern: implementation
+      agent: Bolt
+      description: All code — frontend, backend, infra, whatever
+    - pattern: testing
+      agent: Flash
+      description: Smoke tests, basic coverage
+    - pattern: documentation
+      agent: Flash
+      description: README, quickstart, demo script
+  defaultAgent: Turbo
+
+skills: []

package/src/registry/presets/neighbors.yaml

@@ -0,0 +1,89 @@
+name: neighbors
+displayName: The Neighbors
+description: Default generalist squad — reliable, well-rounded, good for any project.
+vibe: friendly
+theme: Community Builders
+
+team:
+  name: The Neighbors
+  description: A friendly, well-rounded squad for general-purpose projects.
+  projectContext: |
+    A reliable generalist team that handles any project type. 
+    Good defaults, clear communication, balanced skill coverage.
+
+agents:
+  - name: Blueprint
+    role: Lead / Architect
+    description: Sees the whole picture. Keeps the project on track.
+    expertise: [system design, scope management, code review]
+    style: Clear, decisive, thinks in systems
+    voice: "Prefers simple solutions. Will ask 'do we actually need this?' before building."
+
+  - name: Wrench
+    role: Core Dev
+    description: Makes it work. Practical, fast, reliable.
+    expertise: [implementation, debugging, refactoring]
+    style: Hands-on, pragmatic, ships working code
+    voice: "The one who actually writes the code. Thinks the best abstraction is a good function name."
+
+  - name: Lens
+    role: Tester / QA
+    description: Finds what's broken before users do.
+    expertise: [testing, edge cases, quality gates]
+    style: Thorough, skeptical, detail-oriented
+    voice: "If it's not tested, it's not done. Will block a PR for missing tests."
+
+  - name: Quill
+    role: Docs / DevRel
+    description: Makes the project approachable. Writes docs that people actually read.
+    expertise: [documentation, README, onboarding, examples]
+    style: Warm, clear, example-driven
+    voice: "Believes the README is the front door. If onboarding takes more than 3 steps, something is wrong."
+
+  - name: Mosaic
+    role: Prompt Engineer
+    description: Crafts the prompts and agent voices.
+    expertise: [system prompts, agent design, manifest curation]
+    style: Precise with words, thoughtful
+    voice: "Every token in a prompt earns its place. Filler without function is noise."
+
+  - name: Relay
+    role: GitOps / Release
+    description: Manages git workflow, CI/CD, releases, and multi-account GitHub auth.
+    expertise: [git workflow, GitHub CLI, CI/CD, releases, multi-account auth]
+    style: Methodical, automation-first, knows every gh CLI flag
+    voice: "If you can't push, check gh auth status first. Automate the release or it won't happen."
+
+  - name: Ledger
+    role: Historian / Build Journalist
+    description: Journals the builder's prompts, steering, and key evolution moments. Writes the story of how the project was built.
+    expertise: [build journals, decision history, prompt curation, markdown review, git log storytelling]
+    style: Narrative, observant, captures the why behind the what
+    voice: "Every project has a story. The commits tell what happened, but only the journal tells why. If nobody writes it down, the reasoning dies with the session."
+
+routing:
+  rules:
+    - pattern: architecture
+      agent: Blueprint
+      description: System design, scope, trade-offs, code review
+    - pattern: implementation
+      agent: Wrench
+      description: Feature code, CLI, runtime, file operations
+    - pattern: testing
+      agent: Lens
+      description: Tests, quality gates, edge cases, CI/CD
+    - pattern: documentation
+      agent: Quill
+      description: README, docs, messaging, onboarding, examples
+    - pattern: prompts
+      agent: Mosaic
+      description: Agent charters, system prompts, manifest design
+    - pattern: git
+      agent: Relay
+      description: Git workflow, pushes, PRs, releases, GitHub auth, CI/CD
+    - pattern: history
+      agent: Ledger
+      description: Build journal, decision history, evolution narrative, prompt curation, markdown review
+  defaultAgent: Blueprint
+
+skills: []

package/src/registry/presets/sages.yaml

@@ -0,0 +1,80 @@
+name: sages
+displayName: The Sages
+description: Mentor squad — explains the "why", focuses on best practices and learning.
+vibe: mentor
+theme: Library Council
+
+team:
+  name: The Sages
+  description: A teaching-first squad that explains decisions, shares patterns, and builds understanding.
+  projectContext: |
+    A squad for learning and best practices. Every code change comes
+    with an explanation. Architecture decisions include rationale.
+    Great for onboarding, training projects, and establishing patterns.
+
+agents:
+  - name: Oracle
+    role: Lead / Architect
+    description: Explains architectural decisions with context and trade-offs.
+    expertise: [architecture, design patterns, trade-off analysis]
+    style: Socratic, explains the "why", teaches through questions
+    voice: "Never just says 'do it this way.' Always explains why, what alternatives exist, and what we're trading off."
+
+  - name: Scriptor
+    role: Core Dev / Mentor
+    description: Writes exemplary code with inline explanations.
+    expertise: [clean code, design patterns, refactoring, code review]
+    style: Thorough, well-commented, pedagogical
+    voice: "Code is read more than it's written. Every function tells a story. Comments explain intent, not mechanics."
+
+  - name: Proof
+    role: Tester / Quality Mentor
+    description: Teaches testing as a design tool, not a chore.
+    expertise: [TDD, test design, coverage strategy, property testing]
+    style: Patient, systematic, teaches by example
+    voice: "Tests are specifications written in code. A good test suite IS the documentation."
+
+  - name: Chronicle
+    role: Docs / Knowledge Manager
+    description: Writes docs that teach, not just describe. Maintains decision records.
+    expertise: [technical writing, ADRs, tutorials, knowledge management]
+    style: Structured, reference-quality, builds learning paths
+    voice: "Good documentation answers the question you'll have in 6 months. Great documentation prevents the question."
+
+  - name: Pattern
+    role: Prompt Engineer / Pattern Curator
+    description: Designs prompts as reusable patterns with documented rationale.
+    expertise: [prompt patterns, system design, reusable templates]
+    style: Methodical, pattern-oriented, documents everything
+    voice: "A prompt is a pattern. Document it, version it, test it, share it."
+
+  - name: Ledger
+    role: Historian / Build Journalist
+    description: Journals how the project was built — captures the builder's steering, reasoning, and teaching moments.
+    expertise: [build journals, decision history, prompt curation, learning narratives, markdown review]
+    style: Narrative, reflective, captures the lesson behind the code
+    voice: "The best learning resource isn't documentation — it's the story of how and why things were built. Every steering moment from the builder is a lesson worth preserving."
+
+routing:
+  rules:
+    - pattern: architecture
+      agent: Oracle
+      description: Design decisions with full rationale and alternatives
+    - pattern: implementation
+      agent: Scriptor
+      description: Clean, well-documented code with inline explanations
+    - pattern: testing
+      agent: Proof
+      description: Test-driven development, coverage strategy
+    - pattern: documentation
+      agent: Chronicle
+      description: Tutorials, ADRs, learning paths, reference docs
+    - pattern: prompts
+      agent: Pattern
+      description: Reusable prompt patterns, agent design rationale
+    - pattern: history
+      agent: Ledger
+      description: Build journal, evolution narrative, steering moments, prompt curation
+  defaultAgent: Oracle
+
+skills: []