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 specification (/brewcode:spec) to convention analysis (/brewcode:convention) and multi-agent review (/brewcode:superreview).
9 agents (brewers)
Specialized agents: developer, tester, reviewer, architect, skill-creator, agent-creator, hook-creator, and bash-expert.
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) │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ spec, e2e │ │ developer, tester │ │
│ │ superreview │ ──────> │ reviewer, architect│ │
│ │ convention,. │ │ + dynamic teams │ │
│ └──────────────┘ └──────────────────┘ │
│ │ │ │
│ v v │
│ Hooks (processes) Templates + Knowledge │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ session-start│ │ SPEC.md.template │ │
│ │ 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/ # 9 agents
│ ├── developer.md # Feature implementation (opus)
│ ├── tester.md # Testing (sonnet)
│ ├── reviewer.md # Code review (opus)
│ ├── architect.md # Architecture (opus)
│ ├── 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
│ ├── spec/ # Specification creation
│ ├── 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 spec, review, conventions, and meta-tooling. See Skills for details.
| Group | Skills | Purpose |
|---|---|---|
| Spec | spec | Specification authoring via research + interaction |
| 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 |
9 agents (brewers) with different models and specializations. See the Agents section for details.
| Role | Agents | Model |
|---|---|---|
| Implementation | developer, tester, architect | opus/sonnet |
| Review | reviewer | opus |
| Creation | skill-creator, agent-creator, hook-creator | opus |
| Optimization | bash-expert | opus |
| 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
- Specification/brewcode:spec
Parallel codebase research and user refinement loop. Generates SPEC.md scoped to the project.
- 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.