Skip to the content
Agent Tools

bee

Community

Bee — a spec-driven TDD workflow navigator for AI-assisted development. Guides developers through the right level of process: triage, spec, architecture, TDD planning, execution, verification, and review.

Plugin · by incubyte · runs in Claude Code, Cowork, claude.ai · 21 skills, 16 commands, 36 agents · listed 2026-05-03

Claude Code

claude plugin install bee

A community plugin: Anthropic has not reviewed it. Read the source before you install it.

Skills (21)

  • Skill ai-ergonomics

    This skill should be used when evaluating how well code supports LLM-assisted development. Contains context window friendliness, explicitness, module boundaries, test-as-spec, and naming criteria.

    Any agent

    npx skills add incubyte/ai-plugins --skill ai-ergonomics
  • Skill ai-workflow

    This skill should be used when explaining why Bee follows spec-first TDD workflows, or when teaching mode is on. Contains the reasoning behind spec → plan → test → code ordering.

    Any agent

    npx skills add incubyte/ai-plugins --skill ai-workflow
  • Skill architecture-patterns

    This skill should be used when evaluating architecture options, checking dependency direction, or deciding between onion, MVC, and simple patterns. Contains YAGNI-based decision criteria.

    Any agent

    npx skills add incubyte/ai-plugins --skill architecture-patterns
  • Skill bee-state

    This skill should be used when updating workflow state in bee-state.local.md. Contains the full command reference for update-bee-state.sh including init, set, get, clear, all flags, and multi-line…

    Any agent

    npx skills add incubyte/ai-plugins --skill bee-state
  • Skill boundary-generation

    This skill should be used after discovery completes on a greenfield project when the discovery document contains a Module Structure section.

    Any agent

    npx skills add incubyte/ai-plugins --skill boundary-generation
  • Skill brainstorming

    This skill should be used when the user wants to brainstorm, explore ideas, think through options, says 'let's brainstorm', 'what are our options', 'how might we', 'what if we', 'help me think…

    Any agent

    npx skills add incubyte/ai-plugins --skill brainstorming
  • Skill browser-testing

    This skill should be used when running browser-based verification. Supports two providers: Claude-in-Chrome (primary) and chrome-devtools-mcp (fallback).

    Any agent

    npx skills add incubyte/ai-plugins --skill browser-testing
  • Skill clean-code

    This skill should be used when writing, reviewing, or refactoring code. Contains SRP, DRY, YAGNI, naming, error handling, dependency direction, and Kent Beck's four rules of simple design.

    Any agent

    npx skills add incubyte/ai-plugins --skill clean-code
  • Skill code-review

    This skill should be used when performing code reviews, analyzing git hotspots, or detecting coupling. Contains Adam Tornhill's code-as-crime-scene methodology and effort sizing.

    Any agent

    npx skills add incubyte/ai-plugins --skill code-review
  • Skill collaboration-loop

    This skill should be used when processing @bee annotations in documents or managing [ ] Reviewed gates. Contains the exact comment card format and review loop rules.

    Any agent

    npx skills add incubyte/ai-plugins --skill collaboration-loop
  • Skill debugging

    This skill should be used when diagnosing failures, fixing bugs, or investigating why tests don't pass. Contains systematic debugging: reproduce first, read before you change, assume nothing, find…

    Any agent

    npx skills add incubyte/ai-plugins --skill debugging
  • Skill design-fundamentals

    This skill should be used when making UI/UX decisions, designing layouts, choosing colors and typography, writing UI specs, or reviewing visual components.

    Any agent

    npx skills add incubyte/ai-plugins --skill design-fundamentals
  • Skill grill-me

    Interview the user relentlessly about a plan, design, or idea until reaching shared understanding. Use when the user wants to stress-test their thinking, asks to be grilled, says 'poke holes in…

    Any agent

    npx skills add incubyte/ai-plugins --skill grill-me
  • Skill grill-me-with-context

    Interview the user about a plan or design with full codebase context. Use when the user wants to stress-test their thinking against the actual codebase, says 'grill me with context', 'challenge this…

    Any agent

    npx skills add incubyte/ai-plugins --skill grill-me-with-context
  • Skill lsp-analysis

    This skill should be used when performing precise dependency analysis with LSP tools. Contains availability checking, graph reasoning, and graceful degradation.

    Any agent

    npx skills add incubyte/ai-plugins --skill lsp-analysis
  • Skill model-tiers

    This skill should be used when an orchestrator needs to choose or resolve a model for a delegated agent — i.e. by /bee:planner when authoring a plan (assigning a capability tier per agent per slice)…

    Any agent

    npx skills add incubyte/ai-plugins --skill model-tiers
  • Skill requirement-architect

    Rewrites software requirements to lead to better code design and architecture. Use this skill whenever a user shares requirements, user stories, feature specs, acceptance criteria, or PRDs and wants…

    Any agent

    npx skills add incubyte/ai-plugins --skill requirement-architect
  • Skill resolve-m-conflicts

    This skill should be used when resolving git merge conflicts. Parses conflict markers, shows clean side-by-side diffs, explains why each conflict occurred using git history, and presents resolution…

    Any agent

    npx skills add incubyte/ai-plugins --skill resolve-m-conflicts
  • Skill spec-writing

    This skill should be used when writing specs, acceptance criteria, or slicing features into vertical slices. Contains adaptive depth by risk and out-of-scope capture.

    Any agent

    npx skills add incubyte/ai-plugins --skill spec-writing
  • Skill tdd-practices

    This skill should be used when writing a TDD plan, reviewing test quality, choosing between unit and integration tests, or applying red-green-refactor.

    Any agent

    npx skills add incubyte/ai-plugins --skill tdd-practices
  • Skill try-it-yourself

    This skill should be used after all slices are verified and before review. Contains templates for generating contextual 'Try it yourself' manual verification steps based on what was built (frontend…

    Any agent

    npx skills add incubyte/ai-plugins --skill try-it-yourself

Agents (36)

  • Agent architecture-advisor

    Use this agent to evaluate architecture options when the task warrants a decision. Most tasks just follow existing patterns. Includes YAGNI check.

  • Agent architecture-impl-advisor

    Use this agent to evaluate architecture for spec-driven development (SDD). Reads the spec and codebase, evaluates across 6 dimensions (Simplicity, Cohesion, Decoupling, Evolvability, Testability…

  • Agent architecture-test-writer

    Use this agent to generate runnable ArchUnit-style boundary tests from a confirmed architecture assessment report. Produces passing tests for healthy boundaries and intentionally failing tests for…

  • Agent browser-verifier

    Use this agent to verify a running app in the browser — checks acceptance criteria, console errors, runtime exceptions, and visual state via browser MCP tools.

  • Agent context-gatherer

    Use this agent to read a codebase and understand patterns, conventions, and the area being changed. Run before planning. Use for any task beyond TRIVIAL.

  • Agent design-agent

    Use this agent to produce a design brief for UI-involved projects. For existing design systems, it reads and documents what exists.

  • Agent discovery

    Use this agent as a PM persona that interviews users and produces a client-shareable PRD. Works standalone via /bee:discover or internally via /bee:sdd.

  • Agent domain-language-extractor

    Use this agent to extract domain vocabulary from README, docs, the company's website, and code naming patterns. Compares domain language against code structure to find vocabulary drift and boundary…

  • Agent onboard

    Use this agent to analyze a codebase and deliver an interactive onboarding walkthrough adapted to the developer's role, experience, and focus area. Use when a developer is joining an existing project.

  • Agent programmer

    Use this agent to write code for a TDD plan slice — writes failing tests, makes them pass, refactors. Follows strict RED-GREEN-REFACTOR one test at a time. Use after TDD plan is reviewed and approved.

  • Agent qc-planner

    Use this agent to synthesize review agent outputs into a prioritized test plan. Scores hotspots, inventories existing tests, assesses testability, and produces a fixed-format plan.

  • Agent quick-fix

    Use this agent when the orchestrator classifies a task as TRIVIAL — typos, config changes, obvious one-liners. Makes the fix and runs tests.

  • Agent recap

    Use this agent after SDD completes to walk the developer through what was built — files changed, core logic, tests written, architecture decisions.

  • Agent review-ai-ergonomics

    Use this agent to review code for how well LLMs can work with it — context window friendliness, explicitness, module boundaries, test-as-spec, naming, and documentation quality.

  • Agent review-behavioral

    Use this agent to analyze git history to find hotspots (high-churn + high-complexity files) and temporal coupling (files that change together). Use as part of the multi-agent review.

  • Agent review-code-quality

    Use this agent to review code against clean code principles — SRP, DRY, YAGNI, naming, small functions, error handling, dependency direction. Use as part of the multi-agent review.

  • Agent review-coupling

    Use this agent to analyze structural coupling — import dependencies, afferent/efferent coupling, change amplifiers, and decoupling opportunities. Use as part of the multi-agent review.

  • Agent review-org-standards

    Use this agent to review code against the target project's CLAUDE.md conventions and rules. Checks project-specific patterns, naming, architecture, and any custom standards.

  • Agent review-team-practices

    Use this agent to review team practices — commit message quality and PR review substance. Identifies rubber-stamp reviews and low-quality commit messages. Use as part of the multi-agent review.

  • Agent review-tests

    Use this agent to review test quality — vanity test detection, assertion quality, mocking discipline, behavior-based testing, isolation, naming, frontend-specific checks, and coverage gaps.

  • Agent reviewer

    Use this agent to review the complete body of work after all slices are done. Risk-aware ship recommendation. Use after all slices are verified complete.

  • Agent sdd-verifier

    Use this agent to verify a completed SDD slice — tests pass, test quality assessed, criteria met, patterns followed. Risk-aware.

  • Agent slice-builder

    Merged build agent for ONE plan slice in the /bee:start → /bee:planner → /bee:plan-implementer workflow. Writes the slice's plan-specified tests, confirms they fail (red), writes the code to make…

  • Agent slice-coder

    Use this agent to write production code for one spec slice in the SDD workflow. Receives the spec, architecture recommendation, and context — writes all production code for the slice's acceptance…

  • Agent slice-tester

    Use this agent to write tests for completed production code in the SDD workflow. Reads production code with adversarial eyes, assesses testability, makes small testability refactors if needed…

  • Agent spec-builder

    Use this agent to interview the developer and build a spec. Depth adapts to task size and risk. Use for FEATURE and EPIC workflows after context gathering.

  • Agent tdd-coder

    Use this agent as the "code" side of ping-pong TDD. It receives a failing test and writes the minimum production code to make it pass. Refactors after GREEN.

  • Agent tdd-ping-pong

    Use this agent to run ping-pong TDD on a spec. It orchestrates a test-writer and coder agent in alternating RED-GREEN-REFACTOR cycles, one test at a time, until all acceptance criteria are…

  • Agent tdd-planner-cqrs

    Use this agent to generate a split TDD plan for CQRS architectures. Command side (behavior + events) and query side (projections + read models). One plan per slice.

  • Agent tdd-planner-event-driven

    Use this agent to generate a contract-first TDD plan for event-driven architectures. One plan per slice. Use when architecture decision is event-driven or message-based.

  • Agent tdd-planner-mvc

    Use this agent to generate a TDD plan for MVC architecture. One plan per slice. Use when architecture decision is MVC. <example> Context: Architecture-advisor confirmed the codebase uses MVC user…

  • Agent tdd-planner-onion

    Use this agent to generate an outside-in TDD plan for onion/hexagonal architecture. One plan per slice. Use when architecture decision is onion or hexagonal.

  • Agent tdd-planner-simple

    Use this agent to generate a simple test-first plan. For small features and utilities. Use when architecture decision is simple or default.

  • Agent tdd-test-writer

    Use this agent as the "test" side of ping-pong TDD. It writes exactly ONE failing test, runs it to confirm RED, and returns the test name and error. Never writes more than one test per invocation.

  • Agent tidy

    Use this agent to clean up the area before building. Creates a separate commit. Optional — skipped if area is clean. Use when context gatherer flags tidy opportunities.

  • Agent verifier

    Use this agent to verify a completed slice — tests pass, criteria met, patterns followed. Risk-aware. Use after execution of each slice.

Commands (16)

  • Command architect

    Architectural health assessment grounded in domain language. Compares how a product describes itself against how the code is structured.

  • Command brainstorm

    Start a brainstorming session. Open-ended, collaborative idea generation for product, architecture, UX, or any problem space.

  • Command browser-test

    Run browser-based regression tests against specs. Verifies acceptance criteria in a running app via Chrome MCP, produces pass/fail reports with screenshots. Read-only — does not modify code.

  • Command coach

    Analyze your development sessions and get actionable coaching insights

  • Command discover

    Start a discovery session. A PM persona that interviews you (or synthesizes from transcripts) and produces a client-shareable PRD. Use standalone or let /bee invoke it automatically.

  • Command help

    Explain Bee's features interactively — what each command does, when to use it, what artifacts it produces. Adapts to your project context.

  • Command migrate

    Analyze a legacy and new codebase to produce a prioritized, independently-shippable migration plan.

  • Command onboard

    Interactive developer onboarding for existing projects. Analyzes the codebase and delivers an adaptive walkthrough with knowledge checks.

  • Command ping-pong

    Run ping-pong TDD on a spec. Two agents alternate — one writes a failing test, the other makes it pass — until all acceptance criteria are implemented.

  • Command plan-implementer

    Canonical plan executor. Implements an execution plan one merged build agent per slice (tests + code together, at each slice's plan-assigned model tier), then reviews and verifies once at the end.

  • Command planner

    Authors the execution plan — the prescriptive "how" that lets a lower-tier model write good code. Runs on the best model, once per feature.

  • Command qc

    Quality coverage analysis with hotspot-driven test planning. Finds high-risk untested code and produces a prioritized test plan.

  • Command review

    Standalone code review with hotspot analysis, tech debt prioritization, and developer coaching.

  • Command sdd

    Use spec to drive development. Works with or without a pre-built spec. With a spec path, skips to context → architecture → slice loop.

  • Command spec-writer

    Spec authoring link of Bee's plan-driven chain. Produces a testable, slice-decomposed spec from a discovery doc, a focused conversation, or a task description — via bee's spec-builder agent, which…

  • Command start

    Triage router and the first command to run when the user doesn't know which Bee command applies. Takes a description, classifies the work (bug / small feature / large feature / exploratory /…

From Anthropic's public plugin directory, read on 2026-10-15. Find a skill by task.