claude-brewcode

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

A regular Claude Code session loses context during compaction. Brewcode automatically saves knowledge, passes state between compaction cycles, and continues work without restarting. Three plugins. 22+ skills. 14 agents. 9 lifecycle hooks.

Full Documentation

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

Plugin Suite

Plugin	Purpose	Skills	Install
brewcode	Infinite task execution, quorum reviews, skill/agent creation, semantic search	15	claude plugin install brewcode@claude-brewcode
brewdoc	Documentation tools: auto-sync, memory optimization, PDF conversion, publishing	6	claude plugin install brewdoc@claude-brewcode
brewtools	Universal text utilities: token optimization, humanization, secrets scanning	3	claude plugin install brewtools@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

3. Restart Claude Code -- plugins load automatically on every session.

Already installed? Update

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

Local directory (for development)

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

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                              # 1. Analyze project, generate templates (one-time)
/brewcode:spec "Implement JWT authorization"  # 2. Research codebase + create specification
/brewcode:plan                                # 3. Generate phased execution plan
/brewcode:start                               # 4. Execute with infinite context handoff

After /brewcode:setup, each task follows the cycle: spec -> plan -> start. During execution, the plugin automatically compacts knowledge at ~90% context, writes handoff state, and continues without interruption.

brewdoc -- documentation tools

/brewdoc:auto-sync                    # Sync all project docs with codebase
/brewdoc:my-claude                    # Generate Claude Code installation docs
/brewdoc:memory                       # Optimize memory files interactively
/brewdoc:md-to-pdf ./docs/report.md   # Convert markdown to PDF
/brewdoc:publish "Hello world"        # Publish to brewpage.app -- returns public URL
/brewdoc:guide                        # Interactive tutorial for the plugin suite

brewtools -- text utilities

/brewtools:text-optimize CLAUDE.md         # Token-efficient optimization (30+ rules)
/brewtools:text-human 3be67487             # Remove AI artifacts from a commit
/brewtools:secrets-scan                    # Scan for leaked credentials

How It Works

  /brewcode:spec --> 5-10 research agents + user Q&A (*) --> SPEC.md
                                                                │
  /brewcode:plan <──────────────────────────────────────────────┘
        │
        └──> phased plan + user Q&A (*) ──────────────────> PLAN.md
                                            (*) skip with -n/--noask
                                                                │
  /brewcode:start <─────────────────────────────────────────────┘
        │
        v
  ┌─ Execute phases with agents ──────────────────────────────────┐
  │   Phase 1 --> Phase 2 --> ... --> Phase N                      │
  │       │  (context ~90%)                                        │
  │   PreCompact: compact KNOWLEDGE + write handoff                │
  │       │                                                        │
  │   [auto-compact] --> same session resumes --> next phase        │
  └────────────────────────────────────────────────────────────────┘

Knowledge lifecycle

1. Agents accumulate knowledge entries during execution (KNOWLEDGE.jsonl)
2. PreCompact hook compacts and deduplicates before context handoff
3. Pre-task hook injects knowledge into every agent prompt
4. Knowledge accumulates across phases, converted to permanent rules at task end

Skills Reference

Brewcode (15 skills)

Skill	Purpose
/brewcode:setup	Analyze project, check prerequisites, generate adapted templates
/brewcode:spec	Research codebase + user dialog -> SPEC.md
/brewcode:plan	Generate phased PLAN.md from SPEC or Plan Mode
/brewcode:start	Execute task with infinite context handoff
/brewcode:teams	Create and manage dynamic teams of domain-specific agents
/brewcode:standards-review	Review code for project standards compliance
/brewcode:convention	Extract etalon classes, patterns, architecture into convention docs
/brewcode:rules	Extract rules from KNOWLEDGE to .claude/rules/
/brewcode:grepai	Semantic code search (setup, status, start, stop, reindex)
/brewcode:skills	List, create, and upgrade skills
/brewcode:agents	Interactive agent creation and improvement
/brewcode:e2e	E2E testing orchestration with BDD scenarios
/brewcode:glm-design-to-code	Vision model design-to-code (image, text, HTML, URL)
/brewcode:debate	Evidence-based multi-agent debate (Challenge, Strategy, Critic modes)
/brewcode:teardown	Remove plugin configuration (keeps task data)

Brewdoc (6 skills)

Skill	Purpose
/brewdoc:auto-sync	Universal document sync with codebase
/brewdoc:my-claude	Generate Claude Code installation docs
/brewdoc:memory	Optimize memory files interactively
/brewdoc:md-to-pdf	Convert markdown to professional PDF
/brewdoc:publish	Publish to brewpage.app -- returns public URL
/brewdoc:guide	Interactive tutorial for the plugin suite

Brewtools (3 skills)

Skill	Purpose
/brewtools:text-optimize	LLM token efficiency optimization (30+ rules)
/brewtools:text-human	Remove AI artifacts, humanize code
/brewtools:secrets-scan	Scan git-tracked files for leaked secrets

Agents (14 total)

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
text-optimizer	sonnet	Optimize text and docs for LLM efficiency
bc-coordinator	haiku	Task coordination, artifact management
bc-knowledge-manager	haiku	KNOWLEDGE.jsonl compaction and deduplication
bc-grepai-configurator	opus	Generate grepai config.yaml
bd-auto-sync-processor	sonnet	Process documents for auto-sync
bc-rules-organizer	sonnet	Create and optimize .claude/rules/ files

Documentation

Resource	Link
Full documentation	doc-claude.brewcode.app
Quick Start guide	Quickstart
Brewcode overview	Brewcode
Brewdoc overview	Brewdoc
Brewtools overview	Brewtools
Release Notes	RELEASE-NOTES.md

Development

CLAUDE_DEBUG=1 claude --plugin-dir ./brewcode   # Debug mode
bash .claude/scripts/update-plugin.sh           # Update all plugins
bash .claude/scripts/bump-version.sh X.Y.Z      # Bump version everywhere

License

MIT -- see LICENSE