Brewcode Overview

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

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.

Install the entire 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.

Brewcode is a plugin for Claude Code that turns single sessions into an infinite task pipeline with automatic context handoff between sessions. The name is a nod to brewing: skills (recipes) define what to brew, agents (brewers) do the work, and hooks (processes) manage the lifecycle.

Key Features

Architecture

Brewcode works as a layer on top of Claude Code through the hook system. The plugin has no external runtime — all context is managed through built-in Claude Code events.

                         Brewcode Plugin
  ┌──────────────────────────────────────────────────────────┐
  │                                                          │
  │   Skills (recipes)            Agents (brewers)           │
  │   ┌──────────────┐          ┌──────────────────┐         │
  │   │ setup, spec  │          │ developer, tester │         │
  │   │ plan, start  │ ──────>  │ reviewer, architect│         │
  │   │ convention,. │          │ + dynamic teams   │         │
  │   └──────────────┘          └──────────────────┘         │
  │          │                          │                     │
  │          v                          v                     │
  │   Hooks (processes)           Templates + Knowledge      │
  │   ┌──────────────┐          ┌──────────────────┐         │
  │   │ session-start│          │ PLAN.md.template  │         │
  │   │ pre-task     │ <──────> │ KNOWLEDGE.jsonl   │         │
  │   │ pre-compact  │          │ SPEC.md.template  │         │
  │   │ stop         │          │ artifacts/        │         │
  │   └──────────────┘          └──────────────────┘         │
  │                                                          │
  └──────────────────────────────────────────────────────────┘

Task execution flow

PLAN.md --> phases (phases/) --> agents execute --> hooks manage
   │                               │                     │
   │  Phase Registry               │  Task API           │  SessionStart
   │  (phase table)                │  (create/update)    │  PreToolUse
   │                               │                     │  PostToolUse
   v                               v                     │  PreCompact
artifacts/{P}-{N}{T}/          KNOWLEDGE.jsonl            │  Stop
{AGENT}_output.md              (knowledge accumulation)   v
                                                    handoff (auto)

Plugin structure

brewcode/
├── .claude-plugin/
│   └── plugin.json                    # Plugin manifest
├── hooks/
│   ├── hooks.json                     # Binding 8 hooks to events
│   ├── session-start.mjs              # Session initialization
│   ├── grepai-session.mjs             # Auto-start grepai watch
│   ├── pre-task.mjs                   # Knowledge injection into agents
│   ├── grepai-reminder.mjs            # grepai reminder
│   ├── post-task.mjs                  # Session binding, 2-step protocol
│   ├── pre-compact.mjs               # Knowledge compaction, handoff
│   ├── stop.mjs                       # Exit blocking
│   ├── forced-eval.mjs                # Skill activation (84%)
│   └── lib/
│       ├── utils.mjs                  # I/O, lock files, configuration
│       └── knowledge.mjs             # KNOWLEDGE.jsonl operations
├── agents/                            # 12 agents
│   ├── developer.md                   # Feature implementation (opus)
│   ├── tester.md                      # Testing (sonnet)
│   ├── reviewer.md                    # Code review (opus)
│   ├── architect.md                   # Architecture (opus)
│   ├── skill-creator.md               # Skill creation (opus)
│   ├── agent-creator.md               # Agent creation (opus)
│   ├── hook-creator.md                # Hook creation (opus)
│   ├── bash-expert.md                 # Bash scripts (opus)
│   ├── bc-coordinator.md              # Task coordinator (haiku)
│   ├── bc-knowledge-manager.md        # Knowledge manager (haiku)
│   ├── bc-grepai-configurator.md      # grepai configurator (opus)
│   └── bc-rules-organizer.md          # Rules organizer (sonnet)
├── skills/                            # 13 skills
│   ├── setup/                         # Project analysis, templates
│   ├── spec/                          # Specification creation
│   ├── plan/                          # Plan creation
│   ├── start/                         # Task execution
│   ├── convention/                    # Convention analysis
│   ├── rules/                         # Rule extraction
│   ├── grepai/                        # Semantic search
│   ├── teardown/                      # Cleanup
│   ├── standards-review/              # Standards review
│   ├── skills/                        # Skill management
│   ├── agents/                        # Agent management
│   ├── teams/                         # Dynamic agent teams
│   └── e2e/                           # E2E testing orchestration
└── templates/                         # Rule templates

Target project structure

After running /brewcode:setup and /brewcode:start, the following appears in your project:

{PROJECT}/
└── .claude/
    └── tasks/
        ├── cfg/
        │   ├── brewcode.config.json    # Plugin configuration
        │   └── brewcode.state.json     # Execution state
        ├── templates/                  # Adapted templates
        │   ├── PLAN.md.template
        │   ├── SPEC.md.template
        │   └── phase*.template
        ├── logs/
        │   └── brewcode.log            # Hook log
        ├── sessions/
        │   └── {session_id}.info       # Session information
        └── {TS}_{NAME}_task/           # Task directory
            ├── PLAN.md                 # Execution plan
            ├── SPEC.md                 # Specification
            ├── KNOWLEDGE.jsonl         # Accumulated knowledge
            ├── phases/                 # Phase files
            │   ├── 1-create-entity.md
            │   ├── 1V-verify-entity.md
            │   └── FR-final-review.md
            ├── artifacts/              # Agent reports
            │   ├── FINAL.md
            │   └── {P}-{N}{T}/
            ├── backup/                 # Backups
            └── .lock                   # Session lock file

Components in detail

Recommended launch order