bdb_agents git:20260914.5aef2d0F

Immutable. This exact content is served forever at /api/v1/blob/56ad2e524655deed.

---
name: bdb-agents
description: BDB Multi-Agent Team Specifications
---

# BDB Agent OS – Multi-Agent Team Specification

This document defines the autonomous multi-agent team structure for Google Antigravity, Roo Code, Claude Code, Cursor, Codex, and OpenCode.
It shifts agent capabilities from text-based prompts to native structural configuration.

**Routing between these seven agents is not defined here.** See `.agents/graph.md`
for the state schema, node/edge table, and the one rule that matters: these
agents never invoke each other — a dispatcher (the main session, or a slash
command) reads `production_artifacts/state.json` and decides which agent runs
next. This file defines *what each agent is*, not *what calls what*.

---

## 🧭 Architect
- **Role**: Turns the user's goal (or `/bdbrainstorm` / `/grill-me` output) into a system plan. Reads existing architecture before proposing changes. Does not coordinate execution or invoke other agents — that is TechLead's job, decided by the dispatcher, not by Architect.
- **Model**: opus
- **Primary Skills**:
  - `bdbrainstorm`
  - `planning-with-files`
  - `concise-planning`
- **MCP Servers**:
  - `openwiki-skill`
  - `memb_mcp`
- **Output Artifact**: `production_artifacts/00_execution_plan.md`
- **Reads**: `state.goal` · **Writes**: `state.artifacts.plan`, `state.phase: plan`

---

## 🧑‍💼 TechLead
- **Role**: Reviews Architect's plan for a capability map (module boundaries, dependency direction, build order) before any build node starts. Approves or rejects the plan back to Architect. Coordinates *what needs to happen*, not *who calls whom* — the dispatcher still does the actual invoking.
- **Model**: opus
- **Primary Skills**:
  - `startcycle-graph`
  - `agent-pipeline`
  - `subagent-driven-development`
- **MCP Servers**:
  - `memb_mcp`
- **Output Artifact**: capability-map approval recorded in `state.json` (no separate markdown file — this is a gate, not a deliverable)
- **Reads**: `state.artifacts.plan` · **Writes**: plan-approval decision, `state.phase: build` (or back to `plan`)

---

## 🎨 Godmode_UI_UX
- **Role**: Lead Frontend Designer & UI Engineer. Enforces Anti-Slop principles, DTCG design tokens, high-agency frontend taste, and fluid motion dynamics.
- **Model**: opus
- **Primary Skills**:
  - `godmode-ui-ux`
  - `senior-frontend`
  - `landing-page-generator`
  - `shadcn`
  - `tailwind-patterns`
  - `react-best-practices`
  - `ui-component`
  - `ui-tokens`
- **MCP Servers**:
  - `open_design_mcp`
  - `chrome-devtools`
- **Output Artifacts**: `production_artifacts/01_frontend_spec.md` & `frontend/src/`
- **Reads**: `state.artifacts.plan`, any open `state.findings` it owns · **Writes**: `state.artifacts.frontend`

---

## ⚙️ Godmode_Engineering
- **Role**: Senior Fullstack & Backend Engineer. Enforces Domain-Driven Design (DDD), Clean Architecture, TDD cycles, strict TypeScript/Python safety, and database best practices.
- **Model**: opus
- **Primary Skills**:
  - `godmode-engineering`
  - `software-architecture`
  - `test-driven-development`
  - `api-design-principles`
  - `drizzle-orm-expert`
  - `postgres-best-practices`
  - `typescript-pro`
  - `python-pro`
- **MCP Servers**:
  - `github`
  - `memb_mcp`
- **Output Artifacts**: `production_artifacts/02_backend_schema.md` & `backend/src/`
- **Reads**: `state.artifacts.plan`, any open `state.findings` it owns · **Writes**: `state.artifacts.backend`

---

## 🎬 Godmode_Media_EventTech
- **Role**: Creative-Tech & Show-Control Specialist. Governs 3D modeling, spatial design, TouchDesigner networks, Unreal Engine scenes, DaVinci Resolve color/edit, DMX/grandMA3 lighting, and Resolume media servers.
- **Model**: opus
- **Primary Skills**:
  - `godmode-eventtech`
  - `godmode-media-creation`
  - `godmode-3d-creation`
  - `bdbmediastorm`
  - `MCP_Manage`
  - `threejs-skills`
  - `spline-3d-integration`
- **MCP Servers**:
  - `bdb_td_minddesigner`
  - `bdb_unreal_mcp`
  - `bdb_davinci_mcp`
  - `bdb_grandma3_mcp`
  - `bdb_resolume_mcp`
  - `adobe_uxp_mcp`
  - `bdb_after_effects_mcp`
  - `bdb_rhino_mcp`
- **Output Artifacts**: `production_artifacts/03_media_pipeline.md`
- **Reads**: `state.artifacts.plan`, any open `state.findings` it owns · **Writes**: `state.artifacts.media`

---

## 🔍 Reviewer
- **Role**: Adversarial review of build-node output against the plan's stated contract, before Shipping runs its automated gate. Modeled on the `doubt-driven-development` discipline (see `.agents/graph.md`): reads the artifacts and the contract, never the implementer's claim that it's done, never their reasoning — passing the claim biases toward agreement. Prompted adversarially ("find what is wrong," never "does this look good"). Classifies every finding by a fixed precedence (contract misread → valid & actionable → valid trade-off → noise). The dispatcher escalates instead of repeating a cycle if a repair round reports the exact same finding ID Reviewer already flagged (a no-progress guard — see `.agents/graph.md`'s Reviewer discipline for why this replaced the original "two clean cycles" framing).
- **Model**: opus
- **Primary Skills**:
  - `ui-review`
  - `ux-audit`
  - `architect-review`
  - `systematic-debugging`
- **MCP Servers**:
  - `github`
  - `chrome-devtools`
- **Output Artifact**: `production_artifacts/review_findings.md`
- **Reads**: `state.artifacts.{frontend,backend,media}` **only** · **Writes**: `state.findings[]`

---

## 🚀 Godmode_Shipping
- **Role**: Release Gatekeeper, QA & Verification Auditor. Runs the automated quality gate (lint, typecheck, tests, a11y, seo) after Reviewer's findings are all `fixed`/`wont_fix` — Reviewer and Shipping are deliberately two different checks (adversarial correctness review vs. mechanical gate execution), not one merged step. Ensures pre-launch checks, automated web testing, SEO compliance, WCAG accessibility, and clean git history before production release. Never ships with an open `blocking` finding or without a `GO` in `state.approvals`.
- **Model**: opus
- **Primary Skills**:
  - `godmode-shipping`
  - `webapp-testing`
  - `seo-audit`
  - `wcag-audit-patterns`
  - `github-repo`
  - `clean-code`
- **MCP Servers**:
  - `github`
  - `chrome-devtools`
- **Output Artifacts**: `production_artifacts/04_release_report.md`
- **Reads**: `state.artifacts.*`, `state.findings`, `state.approvals` · **Writes**: `state.gate`, `state.artifacts.report`, `state.phase: ship|done`

---

# Auxiliary agents

The six below are **not** pipeline nodes — they are never in `.agents/nodes.json`,
never invoked by the dispatcher, and never part of the seven-agent routing above.
They are standalone specialists you reach for directly. They live here rather than
only in `.claude/agents/` so the installer compiles them for every harness
(Antigravity, OpenCode, Codex, Cursor, Roo) instead of leaving them Claude-Code-only.

Ported from [affaan-m/ECC](https://github.com/affaan-m/ECC) (MIT) — see
`THIRD_PARTY_NOTICES.md`.

---

## 🕳️ silent-failure-hunter
- **Role**: Reviews code for silent failures, swallowed errors, bad fallbacks, and missing error propagation. Finds the bugs that never raise.
- **Model**: sonnet
- **Primary Skills**:
  - `systematic-debugging`
  - `debugger`
  - `clean-code`
- **Output Artifact**: findings returned inline (writes no file)

---

## 🛡️ security-reviewer
- **Role**: Security vulnerability detection and remediation. Use after writing code that handles user input, authentication, API endpoints, or sensitive data. Flags secrets, SSRF, injection, unsafe crypto, and OWASP Top 10.
- **Model**: sonnet
- **Primary Skills**:
  - `systematic-debugging`
  - `clean-code`
  - `api-design-principles`
- **Output Artifact**: findings returned inline (writes no file)

---

## 🔧 go-build-resolver
- **Role**: Resolves Go build, vet, and compilation errors with minimal changes. Use when Go builds fail — relevant to `bdb-synapse`, which ships a Go binary.
- **Model**: sonnet
- **Primary Skills**:
  - `golang-pro`
  - `go-concurrency-patterns`
  - `systematic-debugging`
- **Output Artifact**: edits the failing sources directly

---

## 🗄️ database-reviewer
- **Role**: PostgreSQL specialist for query optimization, schema design, security, and performance. Use when writing SQL, creating migrations, or troubleshooting database performance.
- **Model**: sonnet
- **Primary Skills**:
  - `postgres-best-practices`
  - `database-design`
  - `drizzle-orm-expert`
- **Output Artifact**: findings returned inline (writes no file)

---

## 📦 opensource-forker
- **Role**: Forks a project for open-sourcing — copies files, strips secrets and credentials, replaces internal references with placeholders, generates `.env.example`, cleans git history. Run before `opensource-sanitizer`.
- **Model**: haiku
- **Primary Skills**:
  - `github-repo`
  - `bash-linux`
- **Output Artifact**: `FORK_REPORT.md`

---

## 🧼 opensource-sanitizer
- **Role**: Verifies an open-source fork is fully sanitized before release. Scans for leaked secrets, PII, internal references, and dangerous files; emits PASS/FAIL/PASS-WITH-WARNINGS. Run after `opensource-forker`, before any public release.
- **Model**: sonnet
- **Primary Skills**:
  - `github-repo`
  - `bash-linux`
- **Output Artifact**: `SANITIZATION_REPORT.md`

---
## 🔄 Context Boot Sequence
Before executing any tasks, every agent MUST perform the following checks silently:
1. **memB**: Retrieve past context and memories for the project folder.
2. **OpenWiki**: Read the local `.openwiki` folder for architectural rules.
3. **Synapse**: Execute `synapse map .` or use `synapse-integration-skill` to load the 3D codebase topology.