convez.ai
MCP ServerProdutividadeAvançado
kochetkov-ma

Brewcode - Suite de Plugins para Claude Code

kochetkov-ma/claude-brewcode

Suite de 4 plugins (28+ skills, 14 agents) para desenvolvimento ininterrupto em Claude Code

Ver no GitHub
BomPluginScore · de 0 a 100

Plataforma de desenvolvimento completa que estende Claude Code com preservação automática de contexto, otimização de prompts, criação de skills e agents, revisão de código em quórum e gerenciamento de regras de projeto. Resolve o problema de perda de contexto durante compactação com handoff automático de estado entre ciclos.

Instalação

$npx convez-ai kochetkov-ma/claude-brewcode

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
39
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
v6.12.13
Issues abertas
3
Contribuidores
1

Casos de uso

  • Tarefas de desenvolvimento com foco infinito sem perda de contexto
  • Automação de fluxos de trabalho visuais e documentação técnica
  • Criação e gerenciamento de skills e agents reutilizáveis
  • Revisão colaborativa de código com quórum e auditoria

Veredito

Solução robusta e bem arquitetada para desenvolvedores que trabalham extensivamente com Claude Code. A preservação automática de contexto e os 14 agents predefinidos agregam valor real em projetos complexos, embora exija familiaridade com Claude Code e instalação via CLI.

README

A tradução para o português deste README ainda está na fila.

claude-brewcode

macOS Claude Claude Code

Release Latest Release Documentation

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

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

Full Documentation

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

Gitleaks CodeQL Semgrep

🚀 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

PluginPurposeSkillsInstall
brewcodeInfinite task execution, quorum reviews, skill/agent creation, semantic search13claude plugin install brewcode@claude-brewcode
brewdocDocumentation tools: auto-sync, memory optimization, PDF conversion, publishing6claude plugin install brewdoc@claude-brewcode
brewtoolsUniversal text utilities: token optimization, humanization, secrets scanning, plugin updates11claude plugin install brewtools@claude-brewcode
brewuiUI/visual tools: AI image generation, design-to-code conversion2claude 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
  1. 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
  1. 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

ComponentVersionPurpose
Claude Code CLIlatestPlugin runtime
Node.js20+Hook runtime
macOS13+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
/brewtools:plugin-update                   # Install or update the plugin suite

brewui -- visual tools

/brewui:image-gen "a cozy coffee shop at sunset"          # Generate image (default)
/brewui:image-gen --edit photo.png "add warm lighting"    # Edit existing image
/brewui:image-gen --config                                 # Configure API keys

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 (13 skills)

SkillPurpose
/brewcode:setupAnalyze project, check prerequisites, generate adapted templates
/brewcode:specResearch codebase + user dialog -> SPEC.md
/brewcode:planGenerate phased PLAN.md from SPEC or Plan Mode
/brewcode:startExecute task with infinite context handoff
/brewcode:teamsCreate and manage dynamic teams of domain-specific agents
/brewcode:standards-reviewReview code for project standards compliance
/brewcode:conventionExtract etalon classes, patterns, architecture into convention docs
/brewcode:rulesExtract rules from KNOWLEDGE to .claude/rules/
/brewcode:grepaiSemantic code search (setup, status, start, stop, reindex)
/brewcode:skillsList, create, and upgrade skills
/brewcode:agentsInteractive agent creation and improvement
/brewcode:e2eE2E testing orchestration with BDD scenarios
/brewcode:glm-design-to-codeVision model design-to-code (image, text, HTML, URL)
/brewcode:debateEvidence-based multi-agent debate (Challenge, Strategy, Critic modes)
/brewcode:teardownRemove plugin configuration (keeps task data)

Brewdoc (6 skills)

SkillPurpose
/brewdoc:auto-syncUniversal document sync with codebase
/brewdoc:my-claudeGenerate Claude Code installation docs
/brewdoc:memoryOptimize memory files interactively
/brewdoc:md-to-pdfConvert markdown to professional PDF
/brewdoc:publishPublish to brewpage.app -- returns public URL
/brewdoc:guideInteractive tutorial for the plugin suite

Brewtools (11 skills)

SkillPurpose
/brewtools:text-optimizeLLM token efficiency optimization (30+ rules)
/brewtools:text-humanRemove AI artifacts, humanize code
/brewtools:think-shortToggle terse-output mode -- inject brevity directives via SessionStart + PreToolUse:Task hooks
/brewtools:secrets-scanScan git-tracked files for leaked secrets
/brewtools:sshSSH server management -- connect, configure, deploy
/brewtools:deployGitHub Actions deployment -- workflows, releases, GHCR, CI/CD
/brewtools:debateEvidence-based multi-agent debate (Challenge, Strategy, Critic modes)
/brewtools:plugin-updateInstall and update the full plugin suite

Brewui (2 skills)

SkillPurpose
/brewui:image-genAI image generation via 5 providers with anti-slop controls
/brewui:glm-design-to-codeGLM vision design-to-code: image/text/HTML/URL to multi-framework code

Portable skills (standalone)

Self-contained SKILL.md folders that ship outside the four plugins -- drop them into any compatible agent runtime. Both publish content to brewpage.app (text, markdown, files, multi-file sites) and return a public URL.

SkillRuntimePath
brewpage-publishClaude Codeskills/brewpage-publish
brewpage-publishOpenClaw / AgentSkillsopenclaw/brewpage-publish

Agents (16 total)

AgentModelPurpose
developeropusImplement features, write code, fix bugs
testersonnetRun tests, analyze failures, debug flaky tests
revieweropusCode review, architecture, security, performance
architectopusArchitecture analysis, patterns, trade-offs, scaling
skill-creatoropusCreate and improve Claude Code skills
agent-creatoropusCreate and improve Claude Code agents
hook-creatoropusCreate and debug Claude Code hooks
bash-expertopusCreate professional shell scripts
text-optimizersonnetOptimize text and docs for LLM efficiency
bc-coordinatorhaikuTask coordination, artifact management
bc-knowledge-managerhaikuKNOWLEDGE.jsonl compaction and deduplication
bc-grepai-configuratoropusGenerate grepai config.yaml
bd-auto-sync-processorsonnetProcess documents for auto-sync
bc-rules-organizersonnetCreate and optimize .claude/rules/ files

Documentation

ResourceLink
Full documentationdoc-claude.brewcode.app
Quick Start guideQuickstart
Brewcode overviewBrewcode
Brewdoc overviewBrewdoc
Brewtools overviewBrewtools
Brewui overviewBrewui
Release NotesRELEASE-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

Ver o original no GitHub

Bom para

Relacionados