Skip to content

README.md

Latest commit

 

History

History
146 lines (109 loc) · 6.13 KB

README.md

File metadata and controls

146 lines (109 loc) · 6.13 KB
Raw

Brewcode

Infinite task execution plugin for Claude Code -- automatic context handoff, multi-agent workflows, knowledge persistence.

Field Value
Version 4.2.3
Skills 13
Agents 12
Hooks 2
Model opus

Install

Paste this into a Claude Code session:

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:grepai                              # 1. Set up semantic code search (one-time)
/brewcode:spec "Implement JWT authorization"  # 2. Research + specification

Skills

Skill Purpose
/brewcode:spec Research codebase + user dialog -> SPEC.md
/brewcode:grepai Semantic code search (setup, status, start, stop, reindex)
/brewcode:superreview Generate a project-tailored deep-review skill (review + standards merged)
/brewcode:teams Dynamic agent team creation, management, and performance tracking
/brewcode:convention Extract etalon classes, patterns, architecture into convention docs and rules
/brewcode:rules Prompt-driven rules management: status, create, improve, review
/brewcode:skills Prompt-driven skill management: status, create, improve, review
/brewcode:agents Prompt-driven agent management: status, create, improve, review
/brewcode:e2e E2E testing orchestration with BDD scenarios and quorum review

Note: /brewcode:superreview emits a self-contained, project-local deep-review skill tailored to your stack.

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/                              # 2 lifecycle hooks
|   +-- session-start.mjs              # SessionStart: version-check, plan-symlink, permission_mode
|   +-- forced-eval.mjs                # UserPromptSubmit: skill activation reminder
|   +-- hooks.json                     # Event bindings
|   +-- lib/utils.mjs                  # Shared utilities
+-- agents/                            # 10 agents
+-- skills/                            # 9 skills
+-- templates/                         # Rule templates

Hook Lifecycle

Hook Event Purpose
session-start SessionStart Version-check, plan-symlink, permission_mode tag
forced-eval UserPromptSubmit Skill activation reminder (~9K additionalContext bound)

Task Structure

.claude/tasks/{TS}_{NAME}_task/
  SPEC.md             # Specification (research results from /brewcode:spec)

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