GUIDE

Quick Start

The first ten minutes: conventions, domain agents, a task board and a project-tailored review skill. Run each setup generator in its own fresh session. New here? Follow the recommended flow.

Before you begin

Install Claude Code and the plugins first: see Installation. A skill ending in -setup installs a mechanism you use afterwards; the ordered list lives in Full Setup.

Full workflow

Install the plugins

Add the marketplace and install brewcode once per machine. The task board needs brewtools, so install it too.

claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
claude plugin install brewcode@claude-brewcode
claude plugin install brewtools@claude-brewcode

Check the setup dashboard
The dashboard probes eleven setups and prints the command for each. It installs nothing; it only offers to upgrade setups that are already stale.
```
/brewcode:setup-status
```
Write the project conventions
Parallel agents extract etalon classes and coding, testing and architecture patterns into .claude/convention/.
```
/brewcode:convention-setup install
```
Create a domain agent team
Generates 5-20 project agents with self-selection and performance tracking, built on the conventions.
```
/brewcode:teams-setup install core "one agent per bounded context, plus a migrations specialist"
```
Set up the task board
Deploys a file-based Kanban and a project-tailored /task-spec skill. Select the optional spec layer when asked.
```
/brewtools:task-board-setup install . "one lane per service"
```

Add your first task

Create the task, then resolve it by its unique title. /task-spec needs an existing task record and creates none.

/task-board add "Implement JWT authorization with role-based access"
/task-spec "Implement JWT authorization with role-based access"

Generate the deep review skill
Writes a project-tailored /superreview skill into .claude/skills/. The default depth runs your build, lint and test gates plus an intent check; a depth word such as deep adds domain experts and a validator.
```
/brewcode:superreview-setup install "QUICK depth; gate on the existing build and lint commands"
```

Step details: reload, teams, tasks and timers #

Run /reload-plugins inside a session after installing.

Remove a team later by name: uninstall core, or purge core to drop its archive and trace files too.

The board returns the task ID, which /task-spec accepts if titles overlap. If the spec layer was omitted, run task-board setup’s upgrade and select it. /task-spec researches the codebase, asks clarifying questions and fans out to domain agents; methodology, spec and design land under .claude/features/.

When a top-level task becomes active, the main session’s task-board announces its hourly anti-drift cron, with a cadence you choose or an opt-out. Timers depend on the active session and runtime limits.

Distributed plugin skills run only on your explicit command. Three exceptions: Claude can run /brewdoc:publish, /brewtools:text-optimize and /brewtools:text-human mid-task.

What’s next

Update Claude Code first

The mods in the last row need Claude Code 2.1.301 or newer. Check with claude --version; if it is lower, run claude update and restart Claude Code (exit, then claude).

Goal	Command
Deep review: invoke the generated skill	`/superreview`
Extract rules from conventions and commits	`/brewcode:rules "derive rules from .claude/convention/, one file per domain"`
Optimize prompts and agents	`/brewtools:text-optimize .claude/agents/`
Stay current: update plugins and mods, then upgrade the stale setups	`/brewtools:plugin-update` `/reload-plugins` `/brewcode:setup-status upgrade`
Brewcode mods: prompt placeholders, plan-mode effort, durable reminders	`claude plugin install brewmod-placeholders@claude-brewcode` `claude plugin install brewmod-plan-effort@claude-brewcode` `claude plugin install brewmod-reminders@claude-brewcode`

All 27 skills are listed on the plugin pages: brewcode, brewtools, brewdoc, brewui.

Full Setup

All 11 -setup skills in one ordered run list.

View on GitHub

Source code, README, and releases.

Update: /brewtools:plugin-update, /reload-plugins, then /brewcode:setup-status upgrade - FAQ