A 20-agent AI software team for Claude Code. Smart routing, auto-CODEOWNERS, self-improvement, and proactive DX suggestions.
# Install the team plugin
claude plugins add /path/to/brains-in-a-hat/brains-in-a-hat
# Install the visualization plugin (optional)
claude plugins add /path/to/brains-in-a-hat/grant| Plugin | Purpose |
|---|---|
brains-in-a-hat |
20-agent dev team — routing, QA, memory, retrospectives |
grant |
Visualization agent — architecture diagrams, git activity, code maps |
| Agent | Role |
|---|---|
| Session Manager | Briefings at session start, memory updates at end |
| QA Engineer | Advisory QA reviews before commits |
| Meta/Retro | Retrospectives, DX suggestions, CODEOWNERS maintenance |
| Agent | Trigger |
|---|---|
| System Designer | New features, architectural decisions |
| Architect | Code review for boundary violations |
| UI Reviewer | QML/CSS/HTML visual changes |
| Qt/QML | PySide6/Qt-specific patterns |
| MLOps | ONNX models, inference, weights |
| Signal Processing | Audio/video pipelines, timestamps |
| Hardware/Device | Probe protocol, WiFi, USB, V4L2 |
| Domain Expert | Clinical/domain-specific validation |
| Profiler | Performance, latency, memory |
| Researcher | Technical investigation, benchmarks |
| Data/Schema | SQLite, migrations, config |
| UX/Workflow | End-to-end user flows |
| Testing Strategy | Test suite design, coverage |
| Agent | Role |
|---|---|
| DevOps | CI/CD, GitHub Actions |
| Packaging | AppImage, Docker, PyInstaller |
| Docs Writer | Specs, CLAUDE.md, API docs |
| Parker | Issues, backlog, milestones, GitHub Projects |
- Smart routing — Neal (orchestrator) activates 4-6 agents per task based on files touched
- Auto-CODEOWNERS — Meta Agent generates ownership mapping on install, maintains during retros
- Self-improvement — retrospectives after major tasks, agent prompt updates
- Proactive DX — suggests hooks, aliases, workflow improvements (rate-limited)
- Advisory QA — QA reviews are advisory; they never block commits
/assemble— Activate the brains-in-a-hat team (Neal + all agents)/team-briefing— Session start briefing: branch status, uncommitted changes, open tasks/team-debrief— Session end memory update: save decisions, WIP, workflow changes/team-retro— Post-task retrospective: what went well, what to improve/team-review— QA review of staged/modified changes before commit/team-cleanup— Find dead code, unused imports, stale TODOs
/grant— Visualize architecture, git activity, code structure, or agent topology
The dashboard auto-starts via the session-start hook each time a Claude Code session opens. It requires Python 3 or uv to be available on $PATH.
- Runs at
http://localhost:8787by default - Accepts a
?project=<path>query parameter for multi-project use - Logs to
.brains_in_a_hat/state/dashboard.login the current project
Copy examples/user-preferences.json to .brains_in_a_hat/user-preferences.json in your project and customize. Controls communication style, tool preferences, engineering principles. The Meta Agent also learns and updates this file over time.
Copy examples/domain-config.json to .brains_in_a_hat/domain-config.json and customize for your domain. The included example is for clinical speech-language pathology — replace with your own domain terminology, compliance requirements, and validation rules.
The plugin lives in a Git repo — install on any device with Claude Code. Project-specific config (CODEOWNERS, domain-config) stays in .brains_in_a_hat/. Vault artifacts persist globally at ~/.brains_in_a_hat/vault/.
Set BRAINS_VAULT_DIR in your environment to redirect the vault to any location — for example, a subfolder inside an Obsidian Sync vault so artifacts are automatically synced across devices:
# ~/.zshenv (use .zshenv not .zshrc — hooks run in non-interactive shells)
export BRAINS_VAULT_DIR="$HOME/Documents/Second Brain/brainshat"The directory is created automatically on first run. All agents, vault lookups (vault_find), and artifact writes use the resolved path. The /assemble briefing shows the active vault location.
If unset, defaults to ~/.brains_in_a_hat/vault/.
MIT