claude-brewcode

Claude Code plugin suite -- four plugins for development, documentation, text utility, and visual workflows.

A regular Claude Code session hands a big task to one agent and loses sight of it. Brewcode splits work into bounded units, gives every spawn a six-field brief, and re-states delegation on eligible prompts 1, 10, 20, and so on, with separate post-compaction recall. Four plugins. 27 skills. 8 agents. 6 registered hook commands.

Full Documentation

Approaches -- every hook, agent and injection the suite installs, and who installs what.

Security: Code is scanned on every commit. No personal data is collected or transmitted.

🚀 Install in 30 seconds

Paste this prompt into any Claude Code session -- Claude will run the full install for you:

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.

Already installed? Update with this 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 update claude-brewcode
2. claude plugin update brewcode@claude-brewcode
3. claude plugin update brewdoc@claude-brewcode
4. claude plugin update brewtools@claude-brewcode
5. claude plugin update 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.

After install/update, run /reload-plugins (or exit + claude to restart). For manual install steps see Installation below.

Plugin Suite

Plugin	Purpose	Skills	Install
brewcode	Infinite task execution, quorum reviews, skill/agent creation, semantic search	9	claude plugin install brewcode@claude-brewcode
brewdoc	Documentation tools: docsync, memory-sync generation, PDF conversion, publishing	5	claude plugin install brewdoc@claude-brewcode
brewtools	Universal text utilities: token optimization, humanization, secrets scanning, plugin updates	13	claude plugin install brewtools@claude-brewcode
brewui	UI/visual/creative tools (placeholder, currently empty)	0	claude plugin install brewui@claude-brewcode

Installation

Marketplace (recommended)

Permanent installation through the Claude Code plugin system. Plugins load automatically with every session.

1. Add marketplace -- registers the plugin source:

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

2. Install plugins -- copies plugins to local cache:

claude plugin install brewcode@claude-brewcode
claude plugin install brewdoc@claude-brewcode
claude plugin install brewtools@claude-brewcode
claude plugin install brewui@claude-brewcode

3. Reload plugins -- run /reload-plugins in Claude Code, or exit + claude to restart.

Already installed? Update

Use /brewtools:plugin-update inside Claude Code for the easiest path -- it runs all update commands and reloads automatically.

Or run manually:

claude plugin marketplace update claude-brewcode
claude plugin update brewcode@claude-brewcode
claude plugin update brewdoc@claude-brewcode
claude plugin update brewtools@claude-brewcode
claude plugin update brewui@claude-brewcode

After updating, run /reload-plugins (preferred) or exit + claude to restart.

Local directory (for development)

claude --plugin-dir ./brewcode --plugin-dir ./brewdoc --plugin-dir ./brewtools --plugin-dir ./brewui

Requirements

Component	Version	Purpose
Claude Code CLI	latest	Plugin runtime
Node.js	20+	Hook runtime
macOS	13+	Supported OS

macOS only. Linux and Windows support is planned for future releases.

Quick Start

brewcode -- infinite task execution

/brewcode:setup-status       # 1. Inspect setup state and the recommended installation order
/brewcode:convention-setup   # 2. Establish coding, architecture and testing patterns before teams
/brewcode:teams-setup        # 3. Create agents that use those project conventions
/brewtools:task-board-setup install  # 4. Deploy the board; select the optional spec/design layer
/task-board add "Implement JWT authorization"  # 5. Create an accepted task with methodology and work units
/task-spec <returned-task-id>  # 6. Research and write specs for that existing task
/brewcode:superreview-setup  # 7. Generate a project-tailored deep-review skill
/brewcode:setup-status       # anytime: what is installed, stale or missing in this project

Skills orchestrate, agents execute. Each spawn is a bounded unit with a six-field brief; the forced-eval hook adds its 472-byte role/split/branch reminder on eligible prompts 1, 10, 20, and so on, and a role-recall/compact-recall pair re-anchors the same role plus the plan and task graph after a compaction, so work stays observable across compaction cycles.

The task board provides shared domain methodology for reviews and tests, plus a methodology and base work units for each task. When a top-level task becomes active, the main session's /task-board announces and creates its unique hourly anti-drift cron; the user can choose ano