Brewcode Overview
Install prompt
Execute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:
1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewcode@claude-brewcode
After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.Install the entire suite:
Install prompt
Execute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:
1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
2. claude plugin install brewcode@claude-brewcode
3. claude plugin install brewdoc@claude-brewcode
4. claude plugin install brewtools@claude-brewcode
5. claude plugin install brewui@claude-brewcode
After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.Brewcode is a plugin for Claude Code for spec authoring, multi-agent review, and a toolkit of skills and agents. The name is a nod to brewing: skills (recipes) define what to brew, agents (brewers) do the work, and hooks (processes) manage prompt-time injection.
Key Features
Native plugin paths
Agents resolve paths via native ${CLAUDE_PLUGIN_ROOT}, substituted in each agent .md at Task spawn.
No hook injection, no shared runtime state.
8 skills (recipes)
From convention analysis (/brewcode:convention) and agent teams (/brewcode:teams) to multi-agent review (/brewcode:superreview).
5 agents (brewers)
Specialists only: skill-creator, agent-creator, hook-creator, bash-expert, and the internal bc-rules-organizer. Generic roles are generated per project into .claude/agents/.
2 hooks (processes)
Prompt-time delegation reminder and session-start version-check.
E2E testing
BDD scenario authoring and Playwright autotest orchestration via /brewcode:e2e.
Code quality
Standards-review, convention analysis. Rules are automatically synced to .claude/rules/.
Dynamic teams
Create project-specific agent teams (5-20) with self-selection, performance tracking, and automatic tuning.
Architecture
Brewcode works as a layer on top of Claude Code through the hook system. The plugin has no external runtime — all context is managed through built-in Claude Code events.
Brewcode Plugin
┌──────────────────────────────────────────────────────────┐
│ │
│ Skills (recipes) Agents (brewers) │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ semble, e2e │ │ skill/agent/hook │ │
│ │ superreview │ ──────> │ creator, bash │ │
│ │ convention,. │ │ + project teams │ │
│ └──────────────┘ └──────────────────┘ │
│ │ │ │
│ v v │
│ Hooks (processes) Templates + Knowledge │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ session-start│ │ rules templates │ │
│ │ forced-eval │ <──────> │ artifacts/ │ │
│ │ │ │ │ │
│ │ │ │ │ │
│ └──────────────┘ └──────────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘Plugin structure
brewcode/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── hooks/
│ ├── hooks.json # 2 hooks (SessionStart, UserPromptSubmit)
│ ├── session-start.mjs # Version-check, plan-symlink, permission tag
│ ├── forced-eval.mjs # [ROLE] delegate + [SPLIT] bounded units
│ └── lib/
│ └── utils.mjs # I/O, version cache, configuration
├── agents/ # 5 agents
│ ├── skill-creator.md # Skill creation (opus)
│ ├── agent-creator.md # Agent creation (opus)
│ ├── hook-creator.md # Hook creation (opus)
│ ├── bash-expert.md # Bash scripts (opus)
│ └── bc-rules-organizer.md # Rules organizer (haiku)
├── skills/ # 8 skills
│ ├── semble/ # Semantic code search setup
│ ├── convention/ # Convention analysis
│ ├── rules/ # Rule extraction
│ ├── superreview/ # Multi-agent quorum review
│ ├── skills/ # Skill management
│ ├── agents/ # Agent management
│ ├── teams/ # Dynamic agent teams
│ └── e2e/ # E2E testing orchestration
└── templates/ # Rule templatesComponents in detail
8 skills (recipes) cover search, review, conventions, and meta-tooling. See Skills for details.
| Group | Skills | Purpose |
|---|---|---|
| Search | semble | Semantic code-search MCP setup and maintenance |
| Quality | superreview, convention, rules | Multi-agent review, conventions, rule extraction |
| Dynamic | teams | Agent team creation and management |
| Testing | e2e | E2E testing orchestration with BDD scenarios |
| Meta | skills, agents | Skill and agent management |
5 agents (brewers), all specialists. Generic implementation/review roles are generated per project
into .claude/agents/ by /brewcode:teams — brewcode no longer ships them.
See the Agents section for details.
| Role | Agents | Model |
|---|---|---|
| Creation | skill-creator, agent-creator, hook-creator | inherit |
| Scripting | bash-expert | inherit |
| Internal | bc-rules-organizer | haiku |
- dynamic project agents created by
/brewcode:teams
2 hooks manage prompt-time injection and session start. See the Hooks section for details.
| Event | Hook | Purpose |
|---|---|---|
| SessionStart | session-start | Initialization, version-check |
| UserPromptSubmit | forced-eval | Manager-role + split-discipline reminder |
Quick start
- Conventions/brewcode:convention
Parallel per-layer analysis. Writes etalon classes and recurring patterns into
.claude/convention/. - Deep review/brewcode:superreview
Generate a project-tailored quorum review skill. Run once per project.
- Team Creation (optional)/brewcode:teams
Create a project-specific agent team with performance tracking.
Latest Release
Download, changelog, and installation instructions.
Installation Guide
Full setup, update, and troubleshooting instructions.
View on GitHub
Source code, README, and configuration files.