Execute these commands in this session, one by one, show full output for each, do not skip any:

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

After install, run `/reload-plugins` (or `exit` + `claude`).

Or install the whole suite

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.

Update anytime with /brewtools:plugin-update.

Overview

Brewcode turns single Claude Code sessions into an infinite task pipeline. Claude Code's native auto-compaction preserves the working context, and brewcode hooks re-inject plugin state on each session so the task runs to completion regardless of how many compaction cycles occur.

Skills cover project analysis, specification creation through parallel research agents, code review, convention analysis, and project rules management. Specialized agents handle implementation, testing, review, architecture, and coordination.

Installation

# Marketplace (recommended)
claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode
claude plugin install brewcode@claude-brewcode

# Already installed? Update
claude plugin marketplace update claude-brewcode
claude plugin update brewcode@claude-brewcode

# Dev mode (no install)
claude --plugin-dir ./brewcode

Quick Start

/brewcode:setup                              # 1. Adapt templates for the project (one-time)
/brewcode:spec "Implement JWT authorization"  # 2. Research + specification

Skills

Skill	Purpose
`/brewcode:setup`	Analyze project, check prerequisites, generate adapted templates and config
`/brewcode:spec`	Research codebase + user dialog -> SPEC.md
`/brewcode:teams`	Dynamic agent team creation, management, and performance tracking
`/brewcode:standards-review`	Review code for project standards compliance
`/brewcode:convention`	Extract etalon classes, patterns, architecture into convention docs and rules
`/brewcode:rules`	Extract rules from accumulated knowledge to `.claude/rules/`
`/brewcode:grepai`	Semantic code search (setup, status, start, stop, reindex)
`/brewcode:skills`	Skill management: list, create, upgrade with activation optimization
`/brewcode:agents`	Interactive agent creation and improvement
`/brewcode:e2e`	E2E testing orchestration with BDD scenarios and quorum review
`/brewcode:teardown`	Plugin configuration cleanup (tasks are preserved)

Note: /brewcode:review is a local skill created in the project during /brewcode:setup.

Agents

Agent	Model	Purpose
developer	opus	Implement features, write code, fix bugs
tester	sonnet	Run tests, analyze failures, debug flaky tests
reviewer	opus	Code review, architecture, security, performance
architect	opus	Architecture analysis, patterns, trade-offs, scaling
skill-creator	opus	Create and improve Claude Code skills
agent-creator	opus	Create and improve Claude Code agents
hook-creator	opus	Create and debug Claude Code hooks
bash-expert	opus	Create professional shell scripts
bc-grepai-configurator	opus	Internal: spawned by /brewcode:grepai
bc-rules-organizer	sonnet	Internal: spawned by /brewcode:rules

Dynamic teams: Use /brewcode:teams create to generate 5-20 project-specific agents with self-selection protocol and performance tracking.

Architecture

brewcode/
+-- .claude-plugin/plugin.json          # Plugin manifest
+-- hooks/                              # 6 lifecycle hooks
|   +-- session-start.mjs              # Session initialization
|   +-- grepai-session.mjs             # Auto-start grepai watch
|   +-- pre-task.mjs                   # grepai injection into agents
|   +-- grepai-reminder.mjs            # grepai reminder
|   +-- forced-eval.mjs                # Skill activation
|   +-- permission-guard.sh            # Manager-mode edit guard
+-- agents/                            # 12 agents
+-- skills/                            # 13 skills
+-- templates/                         # Rule templates

Hook Lifecycle

Hook	Event	Purpose
session-start	SessionStart	Initialize session, inject plugin path
grepai-session	SessionStart	Auto-start grepai watch process
pre-task	PreToolUse:Task	Inject grepai reminder into agent prompts
grepai-reminder	PreToolUse:Bash	Remind to prefer semantic search
forced-eval	UserPromptSubmit	Skill activation
permission-guard	PermissionRequest	Manager-mode edit guard for main session

Task Structure

.claude/tasks/{TS}_{NAME}_task/
  SPEC.md             # Specification (research results)
  PLAN.md             # Phased execution plan
  KNOWLEDGE.jsonl     # Accumulated knowledge (survives compactions)
  phases/             # Individual phase files for agents
  artifacts/          # Execution reports by phases
  backup/             # Backups
  .lock               # Session lock file

Documentation

Full docs: doc-claude.brewcode.app/brewcode/overview

Resource	Link
Skills reference	Skills
Agents reference	Agents
Hooks reference	Hooks
Workflow	Workflow
Release Notes	RELEASE-NOTES.md

Author: Maksim Kochetkov | License: MIT