Introduction

Brewcode is a plugin suite for Claude Code: project conventions and rules, domain agent teams, multi-agent quorum review, semantic code search, and tooling to build your own skills, agents, and hooks. Recipes (skills) define what to brew, brewers (agents) do the work, and a few hooks handle session start, post-compact recall, and manager codewords.

Every skill except /brewdoc:publish, /brewtools:text-optimize and /brewtools:text-human runs only when you type /plugin:skill — see the FAQ for why that is deliberate. Claude can run those three itself (publish or share a link; compress or humanize files you name); typing them still works.

Start with the project foundation

Run setup-status first. Establish semantic search, run convention-setup before teams-setup, configure agent consumers, then install the task board and finish with documentation sync. Follow the Full Setup run-list one setup per session.

Four plugins, one suite

♾️

brewcode

The core: semantic code search, quorum review, conventions, skill/agent/hook/mod creation. 9 skills · 6 agents · 2 registered hooks.

⚙️

brewtools

Universal utilities: prompt optimization, AI artifact removal, secrets scanning, SSH, deploy. 13 skills · 3 agents · 2 registered hooks.

🖼️

brewui

UI / visual / creative tools (placeholder, currently empty). 0 skills · 0 agents.

📂

brewdoc

Documentation tools: docsync doc-staleness tracking, memory-sync generation, Markdown → PDF, publishing. 5 skills · 0 agents.

Two optional brewcode mods sit outside the suite: they install separately from the same marketplace and are not counted among the four plugins.

Naming rule: a skill whose name ends in -setup installs a mechanism into the project — after it runs you use the installed thing, not the skill. Recurring tools keep bare names and are correct to run over and over. See Full Setup for the ordered run list.

What makes it different

📄

Task board and methodology

Domain methodology, per-task work/review/test plans, and a task graph. Active top-level tasks get unique hourly session anti-drift timers unless you override them; specs are optional.

🔍

Quorum code review

3 to 5 parallel reviewers work independently. Results are merged via a quorum algorithm (2/3 agreement). Deduplication and ranking by severity.

📖

Convention setup

Extracts etalon classes, patterns, and architecture into convention docs, then syncs the distilled rules into .claude/rules/.

⚙️

Skills and agents

27 skills and 9 specialized agents across 4 plugins. Built-in tools for creating your own skills, agents, hooks, and mods. Prompt optimization included.

📋

One setup dashboard

/brewcode:setup-status reports which of the 11 setups are installed, stale, disabled, partial or missing here, and prints the exact command for each row.

What’s included

Plugin	Purpose	Skills	Agents	Hooks
brewcode	Conventions and rules, agent teams, semantic search, quorum review, skill/agent/hook/mod creation	9	6	2
brewtools	Text utilities, secrets scanning, SSH, deploy, manager mode, the opt-in hook layer	13	3	2
brewui	UI / visual / creative tools (placeholder, empty)	0	0	—
brewdoc	Documentation tools: doc-staleness tracking, memory sync, setup docs, PDF, publishing	5	0	—

All four plugins install with a single marketplace and load automatically with every Claude Code session. The suite has four registered plugin hooks; additional setup-installed project hooks are separate.

Install

📦 How to install Brewcode — click to expand install instructions

Install prompt

If Claude refuses to run the commands, paste the prompt below directly into the chat.

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.

Full instructions: Installation · Upgrading: /brewtools:plugin-update.

Next step

📂

Updating plugins

Use /brewtools:plugin-update to check and update the brewcode plugin suite in one command. See the FAQ for details.