{"id":44601731,"url":"https://github.com/kochetkov-ma/claude-brewcode","last_synced_at":"2026-06-27T11:01:21.029Z","repository":{"id":334995176,"uuid":"1141341659","full_name":"kochetkov-ma/claude-brewcode","owner":"kochetkov-ma","description":"Brewcode - full-featured development platform for Claude Code: infinite focus tasks with automatic context handoff, prompt optimization, skill/agent creation, quorum code reviews, project rules management, and knowledge persistence","archived":false,"fork":false,"pushed_at":"2026-06-13T19:39:08.000Z","size":3800,"stargazers_count":27,"open_issues_count":3,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T20:20:57.364Z","etag":null,"topics":["ai-agent","ai-tools","anthropic","claude-code","claude-code-agents","claude-code-plugin","claude-code-skill","developer-tools","llm-tools","marketplace","mcp","prompt-engineering"],"latest_commit_sha":null,"homepage":"","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kochetkov-ma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-24T17:30:37.000Z","updated_at":"2026-06-13T19:39:11.000Z","dependencies_parsed_at":"2026-04-24T15:01:45.519Z","dependency_job_id":null,"html_url":"https://github.com/kochetkov-ma/claude-brewcode","commit_stats":null,"previous_names":["kochetkov-ma/claude-brewcode"],"tags_count":138,"template":false,"template_full_name":null,"purl":"pkg:github/kochetkov-ma/claude-brewcode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kochetkov-ma%2Fclaude-brewcode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kochetkov-ma%2Fclaude-brewcode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kochetkov-ma%2Fclaude-brewcode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kochetkov-ma%2Fclaude-brewcode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kochetkov-ma","download_url":"https://codeload.github.com/kochetkov-ma/claude-brewcode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kochetkov-ma%2Fclaude-brewcode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34850575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-tools","anthropic","claude-code","claude-code-agents","claude-code-plugin","claude-code-skill","developer-tools","llm-tools","marketplace","mcp","prompt-engineering"],"created_at":"2026-02-14T09:41:55.229Z","updated_at":"2026-06-27T11:01:21.024Z","avatar_url":"https://github.com/kochetkov-ma.png","language":"MDX","funding_links":[],"categories":["Source Catalog"],"sub_categories":[],"readme":"# claude-brewcode\n\n[![macOS](https://img.shields.io/badge/macOS-support-000000?logo=apple\u0026logoColor=white)](https://www.apple.com/macos/)\n[![Claude](https://img.shields.io/badge/Claude-Anthropic-orange?logo=anthropic\u0026logoColor=white)](https://claude.ai)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet?logo=anthropic\u0026logoColor=white)](https://code.claude.com)\n\n[![Release](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/release.yml/badge.svg)](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/release.yml)\n[![Latest Release](https://img.shields.io/github/v/release/kochetkov-ma/claude-brewcode?label=latest\u0026color=blue)](https://github.com/kochetkov-ma/claude-brewcode/releases/latest)\n[![Documentation](https://img.shields.io/badge/Docs-doc--claude.brewcode.app-4A90D9?logo=bookstack\u0026logoColor=white)](https://doc-claude.brewcode.app/getting-started/)\n\n**Claude Code plugin suite** -- four plugins for development, documentation, text utility, and visual workflows.\n\nA regular Claude Code session loses context during compaction. Brewcode automatically saves knowledge, passes state between compaction cycles, and continues work without restarting. Four plugins. 33 skills. 16 agents. 9 lifecycle hooks.\n\n[**Full Documentation**](https://doc-claude.brewcode.app/getting-started/)\n\n\u003e **Security:** Code is scanned on every commit. No personal data is collected or transmitted.\n\u003e\n\u003e [![Gitleaks](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/gitleaks.yml/badge.svg)](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/gitleaks.yml?query=branch%3Amain)\n\u003e [![CodeQL](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/codeql.yml/badge.svg)](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/codeql.yml?query=branch%3Amain)\n\u003e [![Semgrep](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/semgrep.yml/badge.svg)](https://github.com/kochetkov-ma/claude-brewcode/actions/workflows/semgrep.yml?query=branch%3Amain)\n\n## 🚀 Install in 30 seconds\n\nPaste this prompt into any Claude Code session -- Claude will run the full install for you:\n\n```\nExecute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:\n\n1. claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode\n2. claude plugin install brewcode@claude-brewcode\n3. claude plugin install brewdoc@claude-brewcode\n4. claude plugin install brewtools@claude-brewcode\n5. claude plugin install brewui@claude-brewcode\n\nAfter all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.\n```\n\nAlready installed? Update with this prompt:\n\n```\nExecute these commands in this Claude Code session, one by one, show full output for each, do not skip any, do not summarize:\n\n1. claude plugin marketplace update claude-brewcode\n2. claude plugin update brewcode@claude-brewcode\n3. claude plugin update brewdoc@claude-brewcode\n4. claude plugin update brewtools@claude-brewcode\n5. claude plugin update brewui@claude-brewcode\n\nAfter all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unavailable, tell me to type `exit` and run `claude` again. Run the commands now.\n```\n\n\u003e After install/update, run `/reload-plugins` (or `exit` + `claude` to restart). For manual install steps see [Installation](#installation) below.\n\n## Plugin Suite\n\n| Plugin | Purpose | Skills | Install |\n|--------|---------|--------|---------|\n| [brewcode](brewcode/README.md) | Infinite task execution, quorum reviews, skill/agent creation, semantic search | 13 | `claude plugin install brewcode@claude-brewcode` |\n| [brewdoc](brewdoc/README.md) | Documentation tools: auto-sync, memory optimization, PDF conversion, publishing | 6 | `claude plugin install brewdoc@claude-brewcode` |\n| [brewtools](brewtools/README.md) | Universal text utilities: token optimization, humanization, secrets scanning, plugin updates | 13 | `claude plugin install brewtools@claude-brewcode` |\n| [brewui](brewui/README.md) | UI/visual tools: AI image generation via multiple providers | 1 | `claude plugin install brewui@claude-brewcode` |\n\n## Installation\n\n### Marketplace (recommended)\n\nPermanent installation through the Claude Code plugin system. Plugins load automatically with every session.\n\n1. **Add marketplace** -- registers the plugin source:\n\n```bash\nclaude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode\n```\n\n2. **Install plugins** -- copies plugins to local cache:\n\n```bash\nclaude plugin install brewcode@claude-brewcode\nclaude plugin install brewdoc@claude-brewcode\nclaude plugin install brewtools@claude-brewcode\nclaude plugin install brewui@claude-brewcode\n```\n\n3. **Reload plugins** -- run `/reload-plugins` in Claude Code, or `exit` + `claude` to restart.\n\n### Already installed? Update\n\nUse `/brewtools:plugin-update` inside Claude Code for the easiest path -- it runs all update commands and reloads automatically.\n\nOr run manually:\n\n```bash\nclaude plugin marketplace update claude-brewcode\nclaude plugin update brewcode@claude-brewcode\nclaude plugin update brewdoc@claude-brewcode\nclaude plugin update brewtools@claude-brewcode\nclaude plugin update brewui@claude-brewcode\n```\n\nAfter updating, run `/reload-plugins` (preferred) or `exit` + `claude` to restart.\n\n### Local directory (for development)\n\n```bash\nclaude --plugin-dir ./brewcode --plugin-dir ./brewdoc --plugin-dir ./brewtools --plugin-dir ./brewui\n```\n\n### Requirements\n\n| Component | Version | Purpose |\n|-----------|---------|---------|\n| Claude Code CLI | latest | Plugin runtime |\n| Node.js | 20+ | Hook runtime |\n| macOS | 13+ | Supported OS |\n\n\u003e **macOS only.** Linux and Windows support is planned for future releases.\n\n## Quick Start\n\n### brewcode -- infinite task execution\n\n```bash\n/brewcode:setup                              # 1. Analyze project, generate templates (one-time)\n/brewcode:spec \"Implement JWT authorization\"  # 2. Research codebase + create specification\n/brewcode:plan                                # 3. Generate phased execution plan\n/brewcode:start                               # 4. Execute with infinite context handoff\n```\n\nAfter `/brewcode:setup`, each task follows the cycle: `spec` -\u003e `plan` -\u003e `start`. During execution, the plugin automatically compacts knowledge at ~90% context, writes handoff state, and continues without interruption.\n\n### brewdoc -- documentation tools\n\n```bash\n/brewdoc:auto-sync                    # Sync all project docs with codebase\n/brewdoc:my-claude                    # Generate Claude Code installation docs\n/brewdoc:memory                       # Optimize memory files interactively\n/brewdoc:md-to-pdf ./docs/report.md   # Convert markdown to PDF\n/brewdoc:publish \"Hello world\"        # Publish to brewpage.app -- returns public URL\n/brewdoc:guide                        # Interactive tutorial for the plugin suite\n```\n\n### brewtools -- text utilities\n\n```bash\n/brewtools:text-optimize CLAUDE.md         # Token-efficient optimization (30+ rules)\n/brewtools:text-human 3be67487             # Remove AI artifacts from a commit\n/brewtools:secrets-scan                    # Scan for leaked credentials\n/brewtools:plugin-update                   # Install or update the plugin suite\n```\n\n### brewui -- visual tools\n\n```bash\n/brewui:image-gen \"a cozy coffee shop at sunset\"          # Generate image (default)\n/brewui:image-gen --edit photo.png \"add warm lighting\"    # Edit existing image\n/brewui:image-gen --config                                 # Configure API keys\n```\n\n## How It Works\n\n```\n  /brewcode:spec --\u003e 5-10 research agents + user Q\u0026A (*) --\u003e SPEC.md\n                                                                │\n  /brewcode:plan \u003c──────────────────────────────────────────────┘\n        │\n        └──\u003e phased plan + user Q\u0026A (*) ──────────────────\u003e PLAN.md\n                                            (*) skip with -n/--noask\n                                                                │\n  /brewcode:start \u003c─────────────────────────────────────────────┘\n        │\n        v\n  ┌─ Execute phases with agents ──────────────────────────────────┐\n  │   Phase 1 --\u003e Phase 2 --\u003e ... --\u003e Phase N                      │\n  │       │  (context ~90%)                                        │\n  │   PreCompact: compact KNOWLEDGE + write handoff                │\n  │       │                                                        │\n  │   [auto-compact] --\u003e same session resumes --\u003e next phase        │\n  └────────────────────────────────────────────────────────────────┘\n```\n\n### Knowledge lifecycle\n\n1. Agents accumulate knowledge entries during execution (KNOWLEDGE.jsonl)\n2. PreCompact hook compacts and deduplicates before context handoff\n3. Pre-task hook injects knowledge into every agent prompt\n4. Knowledge accumulates across phases, converted to permanent rules at task end\n\n## Skills Reference\n\n### Brewcode (13 skills)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewcode:setup` | Analyze project, check prerequisites, generate adapted templates |\n| `/brewcode:spec` | Research codebase + user dialog -\u003e SPEC.md |\n| `/brewcode:plan` | Generate phased PLAN.md from SPEC or Plan Mode |\n| `/brewcode:start` | Execute task with infinite context handoff |\n| `/brewcode:teams` | Create and manage dynamic teams of domain-specific agents |\n| `/brewcode:standards-review` | Review code for project standards compliance |\n| `/brewcode:convention` | Extract etalon classes, patterns, architecture into convention docs |\n| `/brewcode:rules` | Extract rules from KNOWLEDGE to `.claude/rules/` |\n| `/brewcode:grepai` | Semantic code search (setup, status, start, stop, reindex) |\n| `/brewcode:skills` | List, create, and upgrade skills |\n| `/brewcode:agents` | Interactive agent creation and improvement |\n| `/brewcode:e2e` | E2E testing orchestration with BDD scenarios |\n| `/brewcode:debate` | Evidence-based multi-agent debate (Challenge, Strategy, Critic modes) |\n| `/brewcode:teardown` | Remove plugin configuration (keeps task data) |\n\n### Brewdoc (6 skills)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewdoc:auto-sync` | Universal document sync with codebase |\n| `/brewdoc:my-claude` | Generate Claude Code installation docs |\n| `/brewdoc:memory` | Optimize memory files interactively |\n| `/brewdoc:md-to-pdf` | Convert markdown to professional PDF |\n| `/brewdoc:publish` | Publish to brewpage.app -- returns public URL |\n| `/brewdoc:guide` | Interactive tutorial for the plugin suite |\n\n### Brewtools (13 skills)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewtools:text-optimize` | LLM token efficiency optimization (30+ rules) |\n| `/brewtools:text-human` | Remove AI artifacts, humanize code |\n| `/brewtools:think-short` | Toggle terse-output mode -- inject brevity directives via SessionStart + PreToolUse:Task hooks |\n| `/brewtools:secrets-scan` | Scan git-tracked files for leaked secrets |\n| `/brewtools:ssh` | SSH server management -- connect, configure, deploy |\n| `/brewtools:deploy` | GitHub Actions deployment -- workflows, releases, GHCR, CI/CD |\n| `/brewtools:debate` | Evidence-based multi-agent debate (Challenge, Strategy, Critic modes) |\n| `/brewtools:plugin-update` | Install and update the full plugin suite |\n| `/brewtools:skill-toggle` | Disable/enable individual plugin skills (survives updates) |\n| `/brewtools:agent-toggle` | Disable/enable individual agents via native permissions.deny |\n| `/brewtools:provider-switch` | Configure alternative API providers (DeepSeek, Z.ai/GLM, Qwen, MiniMax, OpenRouter) |\n| `/brewtools:manager` | Manager mode -- codewords ++m/++mp inject a delegate-everything prompt; HARD wall (on/off/uninstall) installs a project PreToolUse guard that blocks main-session edits, forcing delegation |\n| `/brewtools:task-board-init` | Deploy a file-based Kanban into ANY repo via multi-agent analysis -- task-tracker agent, task-board skill, tasks rule, .claude/features |\n\n### Brewui (1 skill)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewui:image-gen` | AI image generation via multiple providers with anti-slop controls |\n\n### Portable skills (standalone)\n\nSelf-contained `SKILL.md` folders that ship outside the four plugins -- drop them into any compatible agent runtime. Both publish content to [brewpage.app](https://brewpage.app) (text, markdown, files, multi-file sites) and return a public URL.\n\n| Skill | Runtime | Path |\n|-------|---------|------|\n| `brewpage-publish` | Claude Code | [`skills/brewpage-publish`](skills/brewpage-publish/) |\n| `brewpage-publish` | OpenClaw / AgentSkills | [`openclaw/brewpage-publish`](openclaw/brewpage-publish/) |\n\n## Agents (16 total)\n\n| Agent | Model | Purpose |\n|-------|-------|---------|\n| developer | opus | Implement features, write code, fix bugs |\n| tester | sonnet | Run tests, analyze failures, debug flaky tests |\n| reviewer | opus | Code review, architecture, security, performance |\n| architect | opus | Architecture analysis, patterns, trade-offs, scaling |\n| skill-creator | opus | Create and improve Claude Code skills |\n| agent-creator | opus | Create and improve Claude Code agents |\n| hook-creator | opus | Create and debug Claude Code hooks |\n| bash-expert | opus | Create professional shell scripts |\n| text-optimizer | sonnet | Optimize text and docs for LLM efficiency |\n| ssh-admin | opus | Linux server administration via SSH |\n| deploy-admin | opus | GitHub Actions deployment and CI/CD |\n| bc-coordinator | haiku | Task coordination, artifact management |\n| bc-knowledge-manager | haiku | KNOWLEDGE.jsonl compaction and deduplication |\n| bc-grepai-configurator | opus | Generate grepai config.yaml |\n| bd-auto-sync-processor | sonnet | Process documents for auto-sync |\n| bc-rules-organizer | sonnet | Create and optimize `.claude/rules/` files |\n\n## Documentation\n\n| Resource | Link |\n|----------|------|\n| Full documentation | [doc-claude.brewcode.app](https://doc-claude.brewcode.app/getting-started/) |\n| Quick Start guide | [Quickstart](https://doc-claude.brewcode.app/quickstart/) |\n| Brewcode overview | [Brewcode](https://doc-claude.brewcode.app/brewcode/overview/) |\n| Brewdoc overview | [Brewdoc](https://doc-claude.brewcode.app/brewdoc/overview/) |\n| Brewtools overview | [Brewtools](https://doc-claude.brewcode.app/brewtools/overview/) |\n| Brewui overview | [Brewui](https://doc-claude.brewcode.app/brewui/overview/) |\n| Release Notes | [RELEASE-NOTES.md](RELEASE-NOTES.md) |\n\n## Development\n\n```bash\nCLAUDE_DEBUG=1 claude --plugin-dir ./brewcode   # Debug mode\nbash .claude/scripts/update-plugin.sh           # Update all plugins\nbash .claude/scripts/bump-version.sh X.Y.Z      # Bump version everywhere\n```\n\n## License\n\nMIT -- see [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkochetkov-ma%2Fclaude-brewcode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkochetkov-ma%2Fclaude-brewcode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkochetkov-ma%2Fclaude-brewcode/lists"}