{"id":44601731,"url":"https://github.com/kochetkov-ma/claude-brewcode","last_synced_at":"2026-04-10T17:27:35.152Z","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-03-30T18:50:22.000Z","size":796,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-30T20:28:23.274Z","etag":null,"topics":["ai-agents","brewcode","claude-code","claude-code-plugin","code-review","context-management","developer-tools","prompt-optimization","task-automation"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","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-03-30T18:50:26.000Z","dependencies_parsed_at":"2026-02-28T22:05:38.223Z","dependency_job_id":null,"html_url":"https://github.com/kochetkov-ma/claude-brewcode","commit_stats":null,"previous_names":["kochetkov-ma/claude-brewcode"],"tags_count":15,"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":31371642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T17:53:18.093Z","status":"ssl_error","status_checked_at":"2026-04-03T17:53:17.617Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-agents","brewcode","claude-code","claude-code-plugin","code-review","context-management","developer-tools","prompt-optimization","task-automation"],"created_at":"2026-02-14T09:41:55.229Z","updated_at":"2026-04-03T19:01:46.492Z","avatar_url":"https://github.com/kochetkov-ma.png","language":"Shell","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** - three plugins for development, documentation, and text utility workflows.\n\n[**Documentation**](https://doc-claude.brewcode.app/getting-started/) \u0026mdash; getting started guide, skills reference, and architecture overview.\n\n## Plugin Suite\n\n| Plugin | Version | Purpose | Install |\n|--------|---------|---------|---------|\n| brewcode | 3.4.11 | Infinite task execution, prompt optimization, skill/agent creation, quorum reviews | `claude plugin install brewcode@claude-brewcode` |\n| brewdoc | 3.4.11 | Documentation tools: auto-sync, my-claude docs, memory optimization, brewpage publishing | `claude plugin install brewdoc@claude-brewcode` |\n| brewtools | 3.4.11 | Universal text utilities: token optimization, humanization, secrets scanning | `claude plugin install brewtools@claude-brewcode` |\n\n---\n\n## Brewcode\n\n**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.\n\n`13` skills. `14` specialized agents. `7` lifecycle hooks.\n\n\u003e 🔒 **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\u003e [![Skills.sh Security](https://img.shields.io/badge/Security_Audit-skills.sh-brightgreen?logo=vercel)](https://skills.sh/kochetkov-ma/claude-brewcode/text-optimizer)\n\n---\n\n## Installation\n\n**Option A** - install from GitHub (persistent across sessions):\n\n1. **Add marketplace** - registers the plugin source in Claude Code\n   ```bash\n   claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode\n   ```\n2. **Install plugins** - copies both plugins to local cache\n   ```bash\n   claude plugin install brewcode@claude-brewcode\n   claude plugin install brewdoc@claude-brewcode\n   claude plugin install brewtools@claude-brewcode\n   ```\n3. **Restart Claude Code** - plugins load automatically on every session\n\n**Already installed?** Update to the latest version:\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\n```\n\n**Option B** - run from local directory (for development or one-time use):\n\n```bash\n# Both plugins\nclaude --plugin-dir ./brewcode --plugin-dir ./brewdoc\n\n# Single plugin\nclaude --plugin-dir ./brewcode\nclaude --plugin-dir ./brewdoc\n```\n\nAfter installation, run `/brewcode:setup` inside Claude Code to check prerequisites (brew, jq, coreutils), optionally set up semantic search (ollama, grepai), and adapt templates for your project.\n\n---\n\n## Quick Start\n\n### brewcode — task execution\n\n```bash\n/brewcode:setup                              # 1. Adapt templates for your project (one-time)\n/brewcode:spec \"Implement JWT authorization\"  # 2. Research + specification\n/brewcode:plan                                # 3. Generate phased plan\n/brewcode:start                               # 4. Execute with infinite context\n```\n\nAfter `/brewcode:setup`, each task follows the cycle: `spec` -\u003e `plan` -\u003e `start`.\n\n### brewdoc — documentation tools\n\n```bash\n/brewdoc:auto-sync                    # Sync all project docs with codebase\n/brewdoc:auto-sync init ./docs/api.md # Add file to auto-sync tracking\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 text/file/JSON to brewpage.app → public URL\n```\n\n---\n\n\u003e ⚠️ **macOS only.** Windows and Linux support is planned for future releases.\n\n## Examples\n\n### 1. Infinite focus task\n\n```bash\n# From text description - plugin researches codebase itself\n/brewcode:spec \"Add role-based access control with admin panel\"\n\n# From file - use existing requirements document as input\n/brewcode:spec ./docs/requirements/rbac.md\n\n# No questions mode - fully autonomous, no user interaction\n/brewcode:spec -n \"Add role-based access control with admin panel\"\n```\n\nThe plugin spawns 5-10 research agents in parallel, asks clarifying questions (use `-n`/`--noask` to skip), analyzes codebase patterns, and produces a structured SPEC. Then:\n\n```bash\n/brewcode:plan        # Creates phased PLAN.md from SPEC (may ask questions)\n/brewcode:plan -n     # Same but fully autonomous\n/brewcode:start       # Executes across unlimited context compactions\n```\n\nDuring execution, the plugin automatically compacts knowledge at ~90% context, writes handoff state, and continues without interruption.\n\n### 2. Multi-agent code review\n\n```bash\n/brewcode:review              # Review staged/recent changes\n/brewcode:review -q 3-5       # Quorum of 3 to 5 parallel reviewers\n/brewcode:review -c            # Enable Devil's Advocate (critic) mode\n```\n\nEach reviewer works independently. Results are merged via quorum algorithm (2/3 agreement required). Findings are deduplicated and ranked by severity.\n\n### 3. Prompt and text optimization\n\n```bash\n/brewtools:text-optimize ./prompts/system.md          # Single file, medium mode\n/brewtools:text-optimize ./prompts/system.md -d        # Deep mode with rule-based analysis\n/brewtools:text-optimize .claude/agents/               # Directory - optimizes all .md files inside\n/brewtools:text-optimize                               # No args - optimizes ALL: CLAUDE.md, agents, skills\n/brewtools:text-human ./src/utils/helper.ts            # Remove AI artifacts from code\n```\n\n### 4. Project rules management\n\n```bash\n/brewcode:rules                           # Extract rules from session context\n/brewcode:rules .claude/tasks/**/K*.jsonl  # Extract from KNOWLEDGE file\n/brewcode:rules .claude/rules \"add SQL anti-patterns\"  # Targeted rule update\n```\n\n### 5. Semantic code search\n\n```bash\n/brewcode:grepai setup    # Configure and start grepai for your project\n/brewcode:grepai status   # Check index health\n```\n\nOnce configured, `grepai_search` is automatically injected into all agent prompts for AI-powered code exploration.\n\n### 6. Mode Switcher skills\n\n```bash\n# Create a skill that toggles a session-level behavioral mode\n/brewcode:skills create \"toggle research mode\"\n```\n\nThe `/brewcode:skills create` command auto-detects mode-switching intent (keywords: \"mode\", \"toggle\", \"persistent\", \"from now on\") and generates a **Mode Switcher** skill — a special skill type with `on`/`off`/`status` arguments that persists across auto-compactions via hook injection.\n\n```\nSkill writes mode → state file → hooks inject on every event\n                                  ├── forced-eval.mjs  (every prompt)\n                                  ├── session-start.mjs (session + compact)\n                                  └── pre-task.mjs     (every sub-agent)\n```\n\n### Security audit\n\n```bash\n/brewtools:secrets-scan    # Scan all git-tracked files for leaked credentials\n```\n\n---\n\n## How It Works\n\n### Core flow: infinite context execution\n\n```\n  /brewcode:spec ──► 5-10 research agents + user Q\u0026A (*) ──► SPEC.md\n                                                                 │\n  /brewcode:plan ◄───────────────────────────────────────────────┘\n        │\n        └──► phased plan + user Q\u0026A (*) ──────────────────► PLAN.md\n                                            (*) skip with -n/--noask\n                                                                 │\n  /brewcode:start ◄──────────────────────────────────────────────┘\n        │\n        ▼\n  ┌─ Execute phases with agents ──────────────────────────────────┐\n  │                                                               │\n  │   Phase 1 ──► Phase 2 ──► ... ──► Phase N                    │\n  │       │                                                       │\n  │       ▼  (context ~90%)                                       │\n  │   PreCompact: compact KNOWLEDGE + write handoff               │\n  │       │                                                       │\n  │       ▼                                                       │\n  │   [auto-compact] ──► same session resumes ──► next phase ─┐   │\n  │                                                            │   │\n  │   ◄────────────────────────────────────────────────────────┘   │\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### Hook lifecycle\n\n| Hook | Event | Purpose |\n|------|-------|---------|\n| `session-start` | SessionStart | Initialize session, inject plugin path |\n| `grepai-session` | SessionStart | Auto-start grepai watch process |\n| `pre-task` | PreToolUse:Task | Inject grepai + KNOWLEDGE into agent prompts |\n| `grepai-reminder` | PreToolUse:Glob/Grep | Remind to prefer semantic search |\n| `post-task` | PostToolUse:Task | Bind session, enforce 2-step protocol (success/failure branching) |\n| `pre-compact` | PreCompact | Compact KNOWLEDGE, write handoff entry |\n| `stop` | Stop | Block if not terminal (finished/failed/cancelled/error), clean lock |\n\n---\n\n## Key Features\n\n| Feature | Description |\n|---------|-------------|\n| **Infinite focus tasks** | Automatic context handoff at ~90% - same session continues seamlessly |\n| **Parallel research** | 5-10 agents analyze codebase before spec/plan creation |\n| **Quorum code review** | Multi-agent review with consensus filtering and critic mode |\n| **Knowledge persistence** | KNOWLEDGE.jsonl survives compactions, injects into all agent prompts |\n| **Prompt optimization** | Deep token optimization with 31 verified rules |\n| **Skill/agent creation** | Tools for building and upgrading custom skills and agents |\n| **Project rules** | Extract reusable patterns and anti-patterns into `.claude/rules/` |\n| **Semantic search** | Optional grepai integration for AI-powered code exploration |\n| **Documentation sync** | Auto-detect stale docs, parallel update with research agents |\n| **Security scanning** | 10 parallel agents scan for leaked secrets and credentials |\n| **Standards review** | Check code against project standards, find duplicates |\n| **Role-based constraints** | DEV/TEST/REVIEW constraints auto-injected into agent prompts |\n\n---\n\n## Brewcode Skills (12)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewcode:setup` | Analyze project, check prerequisites, generate adapted templates and config |\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:review` | Multi-agent code review with quorum (created by setup) |\n| `/brewcode:rules` | Extract rules from KNOWLEDGE to `.claude/rules/` |\n| `/brewcode:grepai` | Semantic code search (setup, status, start, stop, reindex) |\n| `/brewcode:standards-review` | Review code for project standards compliance |\n| `/brewcode:skills` | List, create, and upgrade skills with forced evaluation |\n| `/brewcode:convention` | Extract etalon classes, patterns, architecture into convention docs + rules |\n| `/brewcode:agents` | Interactive agent creation and improvement |\n| `/brewcode:teams` | Create and manage dynamic teams of domain-specific agents |\n| `/brewcode:teardown` | Remove plugin configuration (keeps task data) |\n\n## Brewtools Skills (3)\n\n| Skill | Purpose |\n|-------|---------|\n| `/brewtools:text-optimize` | LLM token efficiency optimization |\n| `/brewtools:text-human` | Remove AI artifacts, humanize code |\n| `/brewtools:secrets-scan` | Scan git-tracked files for leaked secrets |\n\nInstall: `claude plugin install brewtools@claude-brewcode`\n\n## Brewdoc Skills (4)\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\n## Agents (14 total)\n\n### User-facing agents\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\n### brewtools agents\n\n| Agent | Model | Purpose |\n|-------|-------|---------|\n| `text-optimizer` | sonnet | Optimize text and docs for LLM efficiency |\n\n### Internal agents\n\n| Agent | Model | Purpose |\n|-------|-------|---------|\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---\n\n## Task Structure\n\nAfter task creation:\n\n```\n.claude/tasks/{TS}_{NAME}_task/\n  SPEC.md             # Specification (research results)\n  PLAN.md             # Phased execution plan\n  KNOWLEDGE.jsonl     # Accumulated knowledge (survives compactions)\n  .lock               # Execution lock\n  artifacts/          # Reports and outputs by phase\n  backup/             # Backups\n```\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Brewcode README](brewcode/README.md) | Detailed brewcode plugin documentation |\n| [Brewdoc README](brewdoc/README.md) | Brewdoc plugin documentation |\n| [Installation Guide](brewcode/INSTALL.md) | All installation methods |\n| [Commands Reference](brewcode/docs/commands.md) | Detailed skills descriptions with examples |\n| [Flow Diagrams](brewcode/docs/flow.md) | Execution flow diagrams (spec, plan, start) |\n| [Hooks Reference](brewcode/docs/hooks.md) | Hook behavior and configuration |\n| [File Structure](brewcode/docs/file-tree.md) | Complete file tree of plugin and project |\n| [Release Notes](RELEASE-NOTES.md) | Version history |\n\n---\n\n## Development\n\n```bash\n# Run with debug output\nCLAUDE_DEBUG=1 claude --plugin-dir ./brewcode\n\n# Update plugin in marketplace\nbash .claude/scripts/update-plugin.sh\n```\n\n### Version Sync\n\nWhen bumping version, update ALL 5 files with SAME version:\n- `brewcode/.claude-plugin/plugin.json`\n- `brewdoc/.claude-plugin/plugin.json`\n- `brewtools/.claude-plugin/plugin.json`\n- `.claude-plugin/marketplace.json` (all version fields)\n- `brewcode/package.json` (both version fields)\n\n---\n\n## License\n\nMIT - see [LICENSE](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"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"}