beekeeper-suit

# Beekeeper-Suit The Beekeeper-Suit routing skill is how the primary Cursor orchestrator decides which Bee in the Army to delegate to. Each Bee owns one domain. Each Bee's domain is documented in a guide under `guides/`. This SKILL.md is the roster: a one-line index pointing to each Bee's full guide. This Army is tuned for the **Hivemind** repo (`@deeplake/hivemind`): a TypeScript/Node (ESM, Node 22) codebase that gives coding agents cloud-backed shared memory powered by Activeloop Deep Lake. The Bees speak that stack: TypeScript + esbuild + Vitest, Deep Lake datasets and embeddings, the MCP server, the six harness integrations, and the `library/` documentation convention. There is no Django, React, Prisma, or Postgres here, and no Bee pretends there is. **The Army's commitment:** every registered Bee is paired with exactly one Stinger (a Cursor skill). Bees are persona plus guardrails; Stingers are the procedural arsenal. Read the guide before routing, and invoke the Bee by its `name:` frontmatter value. --- ## Roster | Bee | Domain | Trigger keywords | Guide | |---|---|---|---| | `adr-writing-worker-bee` | Architecture Decision Records: Nygard format (Context / Decision / Consequences / Alternatives), MADR extended template, Y-statement framing, supersession lifecycle, and the "decisions, not docs" discipline | "write an ADR", "record this decision", "supersede ADR-NNN", "set up our ADR log", "which ADR format?", "Nygard vs MADR" | [`guides/adr-writing-worker-bee.md`](guides/adr-writing-worker-bee.md) | | `affiliate-referral-program-worker-bee` | Platform selection, attribution architecture, payout design, and fraud mitigation for SaaS affiliate and referral programs. | "set up affiliate program", "affiliate platform selection", "Rewardful vs FirstPromoter", "Safari attribution broken", "referral program fraud" | [`guides/affiliate-referral-program-worker-bee.md`](guides/affiliate-referral-program-worker-bee.md) | | `agile-scrum-worker-bee` | Scrum methodology coaching: ceremonies, DoD, estimation, anti-pattern diagnosis, framework selection (Scrum/ScrumBan/Kanban/Shape Up), and honesty-first "is this Scrum?" audits. | "audit our Scrum process", "is this Scrum?", "write our Definition of Done", "Sprint Planning help", "Scrum anti-patterns" | [`guides/agile-scrum-worker-bee.md`](guides/agile-scrum-worker-bee.md) | | `ai-coding-tools-worker-bee` | Recommends, compares, and configures AI coding tools (Cursor, Claude Code, Aider, Cline, Windsurf, Devin, Bolt) across four autonomy tiers with benchmark-grounded advice. | "which AI coding tool", "Cursor vs Claude Code vs Aider", "set up Aider", "Cline keeps breaking", "SWE-bench scores" | [`guides/ai-coding-tools-worker-bee.md`](guides/ai-coding-tools-worker-bee.md) | | `ai-tools-platform-worker-bee` | AI gateway setup (Portkey/OpenRouter), cloud provider selection, frontier model choice, cost optimization, local LLMs, GPU cloud vendors, and MCP/IDE plugin setup. | "which AI provider", "set up Portkey", "Ollama local LLM", "GPU cloud inference", "which MCP servers" | [`guides/ai-tools-platform-worker-bee.md`](guides/ai-tools-platform-worker-bee.md) | | `alt-ads-platforms-worker-bee` | Paid acquisition specialist for 10 alternative ad platforms (LinkedIn, TikTok, Reddit, Bing, Pinterest, Quora, YouTube, Spotify, X/Twitter, podcast) with ICP-first channel-fit diagnosis. | "LinkedIn Ads B2B", "TikTok CAPI setup", "Reddit Ads developers", "channel diversification paid", "Microsoft Ads LinkedIn targeting" | [`guides/alt-ads-platforms-worker-bee.md`](guides/alt-ads-platforms-worker-bee.md) | | `api-docs-worker-bee` | OpenAPI spec enrichment, renderer selection (Scalar/Redoc/Swagger UI/Mintlify/Stoplight/Bump.sh), hosted deployment, SDK generation (TS/Python/Go), and changelog discipline. | "set up API docs", "compare Redoc vs Scalar", "deploy OpenAPI spec", "generate TypeScript SDK", "write API changelog" | [`guides/api-docs-worker-bee.md`](guides/api-docs-worker-bee.md) | | `app-store-submission-worker-bee` | iOS & Android store publication: ASO, privacy compliance, rejection diagnosis, IAP setup, and submission timelines. | "submit my app", "App Store rejection", "ASO strategy", "privacy nutrition label", "set up IAP" | [`guides/app-store-submission-worker-bee.md`](guides/app-store-submission-worker-bee.md) | | `asset-worker-bee` | Single owner of the Universal Asset Registry — catalogs all 19 asset types, audits code-vs-DB drift, and governs the sync-generator contract. | "register asset", "asset registry", "drift audit", "sync generator", "deprecate asset" | [`guides/asset-worker-bee.md`](guides/asset-worker-bee.md) | | `auth-worker-bee` | Authentication implementation: provider selection (Clerk/Better Auth/Auth.js/Supabase/WorkOS), Google OAuth + GIS, MFA/passkeys, RBAC, session hardening, B2B SSO, provider migrations. | "set up auth", "pick an auth provider", "wire up Google sign-in", "Google OAuth verification", "set up MFA passkeys" | [`guides/auth-worker-bee.md`](guides/auth-worker-bee.md) | | `blogging-content-strategy-worker-bee` | Editorial blogging strategy: cluster-pillar architecture, post-length by intent, title/meta craft, keyword scoping, AEO formatting, CTA copy, pre-publish checklist, cadence planning. | "map blog content", "cluster pillar architecture", "pre-publish checklist", "blog cadence", "optimize title meta" | [`guides/blogging-content-strategy-worker-bee.md`](guides/blogging-content-strategy-worker-bee.md) | | `branching-strategy-worker-bee` | Branching strategy advisor: model selection (trunk-based development, GitHub Flow, GitFlow), release/hotfix branch patterns, the merge-vs-rebase argument, the long-lived-branch trap, and the feature-flag vs feature-branch decision | "which branching model should we use", "GitFlow or trunk-based?", "merge or rebase?", "feature flag or branch?", "set up Merge Queue", "migrate from GitFlow" | [`guides/branching-strategy-worker-bee.md`](guides/branching-strategy-worker-bee.md) | | `changelog-release-notes-worker-bee` | Release communication for `@deeplake/hivemind`: a Keep-a-Changelog CHANGELOG.md, semver discipline across the CLI/library/harness/MCP/schema contract surfaces, impact-first release notes, and the sync-versions plus release.yaml mechanics | "write a changelog entry", "version bump", "semver decision", "breaking change", "release notes", "we just shipped" | [`guides/changelog-release-notes-worker-bee.md`](guides/changelog-release-notes-worker-bee.md) | | `ci-release-worker-bee` | Build, CI, and npm release: the esbuild multi-harness bundle plus sync-versions single-sourcing, the tsc + jscpd + Vitest quality gate, the GitHub Actions workflow architecture, npm publish discipline (files allowlist, prepack, pack-check), and tree-sitter native-dep healing | "the build is slow", "design our CI", "npm release", "files allowlist", "pack-check", "cross-node-install", "sync-versions" | [`guides/ci-release-worker-bee.md`](guides/ci-release-worker-bee.md) | | `code-forensics-worker-bee` | Converts vendor paper trails (invoices, emails, git, audit logs) into litigation-ready 11-deliverable forensic packets for fee-clawback and breach-of-contract claims. | "forensic investigation", "fee clawback", "build a case against my developer", "breach of contract evidence", "investigate this engagement" | [`guides/code-forensics-worker-bee.md`](guides/code-forensics-worker-bee.md) | | `code-review-pr-worker-bee` | Code review culture and PR lifecycle: PR descriptions, review checklists (blocker/suggestion/nit taxonomy), async-first review norms, the small-PR discipline, rubber-stamp detection, and the review-as-mentorship lens | "audit our PR culture", "write a PR description", "create a review checklist", "coach this review comment", "is this PR too large?", "improve code review" | [`guides/code-review-pr-worker-bee.md`](guides/code-review-pr-worker-bee.md) | | `cold-outreach-worker-bee` | Founder-led B2B cold email: tool selection (Apollo/Clay/Smartlead/Instantly/Lemlist), deliverability, sequence design, AI personalization, list hygiene, reply handling. | "cold email sequence", "email deliverability", "Clay personalization", "Apollo vs Instantly", "email warmup" | [`guides/cold-outreach-worker-bee.md`](guides/cold-outreach-worker-bee.md) | | `crm-integration-worker-bee` | CRM connectivity specialist: bi-directional sync design, field mapping, deduplication, and native vs Merge.dev architecture for HubSpot, Salesforce, Pipedrive, Attio, Folk, Close, and Copper. | "integrate with HubSpot", "bi-directional CRM sync", "CRM field mapping", "Merge.dev or native API", "dedup contacts in CRM" | [`guides/crm-integration-worker-bee.md`](guides/crm-integration-worker-bee.md) | | `cron-scheduling-worker-bee` | Cron expression authoring/auditing, platform limits (Vercel/Cloudflare/GitHub Actions), distributed exactly-once execution, DST safety, retry patterns, and missed-run observability. | "write cron expression", "set up Vercel Cron", "cron job runs twice", "GitHub Actions schedule drifting", "distributed cron" | [`guides/cron-scheduling-worker-bee.md`](guides/cron-scheduling-worker-bee.md) | | `csv-xlsx-import-export-worker-bee` | Owns CSV/XLSX parse (papaparse, SheetJS, ExcelJS), streaming large files, column-mapping UX wizard, Zod row validation, CSV injection prevention, and styled XLSX export. | "build CSV import", "add XLSX upload", "column-mapping wizard", "export to Excel", "streaming parse large file" | [`guides/csv-xlsx-import-export-worker-bee.md`](guides/csv-xlsx-import-export-worker-bee.md) | | `cursor-ide-worker-bee` | Cursor platform and harness: Cursor hooks (`hooks.json` 1.7+ wired by `install-cursor.ts`), the first-party `harnesses/cursor/extension` build, registering the Hivemind MCP server in Cursor, and the `.cursor/` Bee Army layout (rules `.mdc`, agents, skills, commands, model matrix) | "cursor hooks", "hooks.json", ".cursor/rules .mdc", "register Hivemind MCP in Cursor", "cursor extension", "Bee Army layout" | [`guides/cursor-ide-worker-bee.md`](guides/cursor-ide-worker-bee.md) | | `customer-support-tooling-worker-bee` | Selects, configures, and audits SaaS support platforms (Plain, Pylon, Help Scout, Front, Intercom); designs AI deflection, SLA policy, and Linear/Slack integrations. | "support tool selection", "AI deflection setup", "SLA tier design", "shared inbox config", "support stack audit" | [`guides/customer-support-tooling-worker-bee.md`](guides/customer-support-tooling-worker-bee.md) | | `dark-mode-theming-worker-bee` | Owns runtime theming layer: CSS variable token architecture, next-themes wiring, FOWT prevention, SSR hydration safety, Tailwind v4 dark mode, multi-brand CSS overrides. | "set up dark mode", "FOWT fix", "next-themes flashing", "CSS variable token layer", "Tailwind v4 dark mode" | [`guides/dark-mode-theming-worker-bee.md`](guides/dark-mode-theming-worker-bee.md) | | `db-worker-bee` | PostgreSQL architecture: schema design, indexing, zero-downtime migrations, ORM choice (Drizzle/Prisma), and serverless DB platform selection. | "design this schema", "review this migration", "jsonb or columns", "index strategy", "Drizzle or Prisma" | [`guides/db-worker-bee.md`](guides/db-worker-bee.md) | | `deeplake-dataset-worker-bee` | Deep Lake data architecture: the 7-table ColumnDef schema (`USING deeplake`), FLOAT4[768] embeddings, additive schema healing (no `IF NOT EXISTS` because 500-not-409), append-only version-bump, deeplake_index/vector/hybrid search, DeeplakeApi querying, SQL guards, dataset versioning, and BYOC storage | "design a Deep Lake table", "add a column", "schema healing", "hybrid search query", "append-only versioning", "BYOC storage", "DeeplakeApi" | [`guides/deeplake-dataset-worker-bee.md`](guides/deeplake-dataset-worker-bee.md) | | `dependency-audit-worker-bee` | npm supply-chain hygiene: Renovate vs Dependabot for this package, `npm audit` triage, the tree-sitter/optionalDependencies install-time risk (ensure-tree-sitter postinstall), SBOM from the tarball, npm provenance, and the publish-time guards (files allowlist, pack-check, audit:openclaw, CodeQL) | "audit our dependencies", "set up Renovate", "npm audit is noisy", "generate an SBOM", "tree-sitter postinstall", "npm provenance", "audit:openclaw" | [`guides/dependency-audit-worker-bee.md`](guides/dependency-audit-worker-bee.md) | | `design-system-worker-bee` | Bootstraps complete design systems from scratch: structured aesthetic interview, starter kit selection, and the canonical seven-artifact folder output. | "build a design system", "bootstrap UI", "create tokens and utilities", "scaffold design language", "design brief and tokens" | [`guides/design-system-worker-bee.md`](guides/design-system-worker-bee.md) | | `devops-worker-bee` | Container build + CI/CD pipeline specialist: Dockerfile hygiene, Docker Compose dev stacks, GitHub Actions architecture, Depot acceleration, image scanning, and local-CI parity. | "review Dockerfile", "CI pipeline", "audit workflow security", "migrate to Depot", "build is slow" | [`guides/devops-worker-bee.md`](guides/devops-worker-bee.md) | | `discord-bot-worker-bee` | Discord developer surface: SDK selection, slash commands, interactive components, voice pipeline (Lavalink 4 + DAVE), sharding, rate limits, bot verification gate. | "add a slash command", "set up voice", "bot hits 100 servers", "wire up a modal", "review discord.py bot" | [`guides/discord-bot-worker-bee.md`](guides/discord-bot-worker-bee.md) | | `discovery-research-worker-bee` | Continuous product discovery coach: Opportunity Solution Trees, JTBD interviews, assumption mapping, and prototype experiment design (Torres framework). | "run a discovery session", "build an OST", "write an interview script", "map our assumptions", "design a prototype experiment" | [`guides/discovery-research-worker-bee.md`](guides/discovery-research-worker-bee.md) | | `docs-site-worker-bee` | Documentation-site infrastructure specialist: platform selection, Diátaxis architecture, docs-as-code CI pipelines, and search setup (Docusaurus, Starlight, Mintlify, Fern, Nextra, GitBook). | "pick a docs platform", "set up Docusaurus", "migrate from GitBook", "docs-as-code CI", "Mintlify vs Starlight" | [`guides/docs-site-worker-bee.md`](guides/docs-site-worker-bee.md) | | `embeddings-runtime-worker-bee` | Embeddings runtime: the local `@huggingface/transformers` plus nomic-embed-text-v1.5 (q8, 768-dim) daemon, socket IPC and lifecycle, Hivemind-scoped model and quantization selection, the embeddings-on vs BM25-fallback decision, and the dim-must-match-schema constraint | "embeddings daemon", "swap embedding model", "nomic-embed", "q8 quantization", "768-dim", "enable semantic search", "BM25 fallback" | [`guides/embeddings-runtime-worker-bee.md`](guides/embeddings-runtime-worker-bee.md) |