Skip to content

Commit 0a77b5b

Browse files
kochetkov-makochetkov-ma
committed
v3.19.0: strip task execution system -- keep spec+grepai only
- remove orphaned skills/agents skill (README commits to two skills) - spec skill: drop /brewcode:setup + /brewcode:plan deps, hand SPEC to developer agent - grepai skill/docs: drop /brewcode:setup prereq, update injection points to PreToolUse:Bash - utils.mjs: drop dead knowledge/agents.system config + isSystemAgent - delete stale docs flow.md/hooks.md/commands.md; rewrite file-tree.md + grepai.md
1 parent ac5c635 commit 0a77b5b

147 files changed

Lines changed: 449 additions & 18539 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude-plugin/marketplace.json‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@
66
},
77
"metadata": {
88
"description": "Claude Code plugin suite: brewcode for infinite task execution, brewdoc for documentation tools, brewtools for text utilities, brewui for UI/visual/creative tools",
9-
"version": "3.18.4"
9+
"version": "3.19.0"
1010
},
1111
"plugins": [
1212
{
1313
"name": "brewcode",
1414
"description": "Brewcode - full-featured development platform for Claude Code: infinite focus tasks, prompt optimization, skill/agent creation, quorum reviews, rules management",
15-
"version": "3.18.4",
15+
"version": "3.19.0",
1616
"category": "productivity",
1717
"keywords": [
1818
"brewcode",
@@ -46,7 +46,7 @@
4646
{
4747
"name": "brewdoc",
4848
"description": "Brewdoc - Claude Code documentation tools: auto-sync for skills/agents/rules, my-claude installation docs, memory optimization, md-to-pdf conversion",
49-
"version": "3.18.4",
49+
"version": "3.19.0",
5050
"category": "productivity",
5151
"keywords": [
5252
"brewdoc",
@@ -74,7 +74,7 @@
7474
{
7575
"name": "brewtools",
7676
"description": "Brewtools - universal utilities for Claude Code: text optimization, humanization, secrets scanning",
77-
"version": "3.18.4",
77+
"version": "3.19.0",
7878
"category": "productivity",
7979
"keywords": [
8080
"brewtools",
@@ -102,7 +102,7 @@
102102
{
103103
"name": "brewui",
104104
"description": "Placeholder for future UI/visual/creative tools (currently empty, installable)",
105-
"version": "3.18.4",
105+
"version": "3.19.0",
106106
"category": "productivity",
107107
"keywords": [
108108
"ui",

‎README.md‎

Lines changed: 7 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010

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

13-
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. 32 skills. 16 agents. 9 lifecycle hooks.
13+
A lean toolkit for Claude Code: specification authoring, semantic code search, documentation tooling, text utilities, and prompt-injection workflows. Four plugins. 21 skills. 13 agents. 5 lifecycle hooks.
1414

1515
[**Full Documentation**](https://doc-claude.brewcode.app/getting-started/)
1616

@@ -56,7 +56,7 @@ After all commands succeed, run `/reload-plugins`. If `/reload-plugins` is unava
5656

5757
| Plugin | Purpose | Skills | Install |
5858
|--------|---------|--------|---------|
59-
| [brewcode](brewcode/README.md) | Infinite task execution, quorum reviews, skill/agent creation, semantic search | 13 | `claude plugin install brewcode@claude-brewcode` |
59+
| [brewcode](brewcode/README.md) | Specification authoring, semantic code search, lifecycle hooks | 2 | `claude plugin install brewcode@claude-brewcode` |
6060
| [brewdoc](brewdoc/README.md) | Documentation tools: auto-sync, memory optimization, PDF conversion, publishing | 6 | `claude plugin install brewdoc@claude-brewcode` |
6161
| [brewtools](brewtools/README.md) | Universal text utilities: token optimization, humanization, secrets scanning, plugin updates | 13 | `claude plugin install brewtools@claude-brewcode` |
6262
| [brewui](brewui/README.md) | UI/visual/creative tools (placeholder, currently empty) | 0 | `claude plugin install brewui@claude-brewcode` |
@@ -118,17 +118,13 @@ claude --plugin-dir ./brewcode --plugin-dir ./brewdoc --plugin-dir ./brewtools -
118118
119119
## Quick Start
120120

121-
### brewcode -- infinite task execution
121+
### brewcode -- spec authoring + semantic search
122122

123123
```bash
124-
/brewcode:setup # 1. Analyze project, generate templates (one-time)
125-
/brewcode:spec "Implement JWT authorization" # 2. Research codebase + create specification
126-
/brewcode:plan # 3. Generate phased execution plan
127-
/brewcode:start # 4. Execute with infinite context handoff
124+
/brewcode:spec "Implement JWT authorization" # Research codebase + create specification
125+
/brewcode:grepai setup # Set up semantic code search
128126
```
129127

130-
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.
131-
132128
### brewdoc -- documentation tools
133129

134130
```bash
@@ -153,54 +149,14 @@ After `/brewcode:setup`, each task follows the cycle: `spec` -> `plan` -> `start
153149

154150
Placeholder plugin, currently empty. No commands yet -- coming soon.
155151

156-
## How It Works
157-
158-
```
159-
/brewcode:spec --> 5-10 research agents + user Q&A (*) --> SPEC.md
160-
│
161-
/brewcode:plan <──────────────────────────────────────────────┘
162-
│
163-
└──> phased plan + user Q&A (*) ──────────────────> PLAN.md
164-
(*) skip with -n/--noask
165-
│
166-
/brewcode:start <─────────────────────────────────────────────┘
167-
│
168-
v
169-
┌─ Execute phases with agents ──────────────────────────────────┐
170-
│ Phase 1 --> Phase 2 --> ... --> Phase N │
171-
│ │ (context ~90%) │
172-
│ PreCompact: compact KNOWLEDGE + write handoff │
173-
│ │ │
174-
│ [auto-compact] --> same session resumes --> next phase │
175-
└────────────────────────────────────────────────────────────────┘
176-
```
177-
178-
### Knowledge lifecycle
179-
180-
1. Agents accumulate knowledge entries during execution (KNOWLEDGE.jsonl)
181-
2. PreCompact hook compacts and deduplicates before context handoff
182-
3. Pre-task hook injects knowledge into every agent prompt
183-
4. Knowledge accumulates across phases, converted to permanent rules at task end
184-
185152
## Skills Reference
186153

187-
### Brewcode (13 skills)
154+
### Brewcode (2 skills)
188155

189156
| Skill | Purpose |
190157
|-------|---------|
191-
| `/brewcode:setup` | Analyze project, check prerequisites, generate adapted templates |
192158
| `/brewcode:spec` | Research codebase + user dialog -> SPEC.md |
193-
| `/brewcode:plan` | Generate phased PLAN.md from SPEC or Plan Mode |
194-
| `/brewcode:start` | Execute task with infinite context handoff |
195-
| `/brewcode:teams` | Create and manage dynamic teams of domain-specific agents |
196-
| `/brewcode:standards-review` | Review code for project standards compliance |
197-
| `/brewcode:convention` | Extract etalon classes, patterns, architecture into convention docs |
198-
| `/brewcode:rules` | Extract rules from KNOWLEDGE to `.claude/rules/` |
199159
| `/brewcode:grepai` | Semantic code search (setup, status, start, stop, reindex) |
200-
| `/brewcode:skills` | List, create, and upgrade skills |
201-
| `/brewcode:agents` | Interactive agent creation and improvement |
202-
| `/brewcode:e2e` | E2E testing orchestration with BDD scenarios |
203-
| `/brewcode:teardown` | Remove plugin configuration (keeps task data) |
204160

205161
### Brewdoc (6 skills)
206162

@@ -244,7 +200,7 @@ Self-contained `SKILL.md` folders that ship outside the four plugins -- drop the
244200
| `brewpage-publish` | Claude Code | [`skills/brewpage-publish`](skills/brewpage-publish/) |
245201
| `brewpage-publish` | OpenClaw / AgentSkills | [`openclaw/brewpage-publish`](openclaw/brewpage-publish/) |
246202

247-
## Agents (16 total)
203+
## Agents (13 total)
248204

249205
| Agent | Model | Purpose |
250206
|-------|-------|---------|
@@ -259,11 +215,8 @@ Self-contained `SKILL.md` folders that ship outside the four plugins -- drop the
259215
| text-optimizer | sonnet | Optimize text and docs for LLM efficiency |
260216
| ssh-admin | opus | Linux server administration via SSH |
261217
| deploy-admin | opus | GitHub Actions deployment and CI/CD |
262-
| bc-coordinator | haiku | Internal: spawned by /brewcode:start + post-task hook |
263-
| bc-knowledge-manager | haiku | Internal: spawned by /brewcode:start |
264218
| bc-grepai-configurator | opus | Internal: spawned by /brewcode:grepai |
265219
| bd-auto-sync-processor | sonnet | Internal: spawned by /brewdoc:auto-sync |
266-
| bc-rules-organizer | sonnet | Internal: spawned by /brewcode:rules |
267220

268221
## Documentation
269222

‎RELEASE-NOTES.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,28 @@
22

33
---
44

5+
## v3.19.0 (2026-06-29)
6+
7+
> Docs: [brewcode overview](https://doc-claude.brewcode.app/brewcode/overview/) | [spec skill](https://doc-claude.brewcode.app/brewcode/skills/spec/) | [grepai skill](https://doc-claude.brewcode.app/brewcode/skills/grepai/)
8+
9+
### brewcode
10+
#### Removed
11+
- **task execution system:** stripped plan, start, setup, rules, convention, teardown, teams, standards-review, skills, agents, e2e (11 skills removed; 2 kept: spec + grepai)
12+
- **internal agents:** bc-coordinator, bc-knowledge-manager, bc-rules-organizer removed
13+
- **task-system hooks:** pre-task.mjs, post-task.mjs, pre-compact.mjs, stop.mjs removed
14+
- **lib/knowledge.mjs:** removed
15+
- **utils.mjs:** task/lock functions removed; also dropped dead `knowledge`/`agents.system` config and `isSystemAgent`
16+
- **session-start.mjs:** KNOWLEDGE.jsonl + lock-file handoff logic stripped
17+
- **templates:** reports/ and skills/ template dirs removed
18+
- **internal docs:** brewcode/docs/{flow,hooks,commands}.md deleted; file-tree.md + grepai.md rewritten to current state
19+
20+
#### Changed
21+
- **brewcode reframed:** lean skill + prompt-injection toolkit (spec authoring + semantic code search via grepai)
22+
- **spec skill:** no longer depends on `/brewcode:setup` templates or `/brewcode:plan`; hands the finished SPEC to the `developer` agent
23+
- **grepai docs:** injection points updated for macOS CC (PreToolUse:Bash; native Grep/Glob removed)
24+
25+
---
26+
527
## v3.18.4 (2026-06-27)
628

729
> Docs: [brewdoc overview](https://doc-claude.brewcode.app/brewdoc/overview/) | [brewtools overview](https://doc-claude.brewcode.app/brewtools/overview/) | [brewcode overview](https://doc-claude.brewcode.app/brewcode/overview/)

‎brewcode/.claude-plugin/plugin.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "brewcode",
3-
"version": "3.18.4",
3+
"version": "3.19.0",
44
"description": "Brewcode - full-featured development platform for Claude Code: infinite focus tasks, prompt optimization, skill/agent creation, quorum reviews, rules management",
55
"author": {
66
"name": "Maksim Kochetkov",

‎brewcode/INSTALL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -191,4 +191,4 @@ CLAUDE_DEBUG=1 claude --plugin-dir ./brewcode
191191
|----------|-------------|
192192
| [README.md](README.md) | Plugin overview and commands |
193193
| [grepai.md](docs/grepai.md) | Semantic search integration |
194-
| [/brewcode:setup](skills/setup/README.md) | Project setup (includes prerequisites installation as Phase 0) |
194+
| [/brewcode:spec](skills/spec/README.md) | Research codebase + dialog -> SPEC.md |

‎brewcode/README.md‎

Lines changed: 12 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# Brewcode
22

3-
> Infinite task execution plugin for Claude Code -- automatic context handoff, multi-agent workflows, knowledge persistence.
3+
> Lean skill + prompt-injection toolkit for Claude Code -- specification authoring, semantic code search, and lifecycle hooks.
44
55
| Field | Value |
66
|-------|-------|
7-
| Version | 3.18.2 |
8-
| Skills | 13 |
9-
| Agents | 12 |
10-
| Hooks | 9 |
7+
| Version | 3.19.0 |
8+
| Skills | 2 |
9+
| Agents | 9 |
10+
| Hooks | 5 |
1111
| Model | opus |
1212

1313
## Install
@@ -43,9 +43,7 @@ Update anytime with `/brewtools:plugin-update`.
4343

4444
## Overview
4545

46-
Brewcode turns single Claude Code sessions into an infinite task pipeline. When context reaches ~90%, the PreCompact hook saves knowledge, writes handoff state, and the session continues automatically. One cycle: `spec` -- `plan` -- `start` -- and the task runs to completion regardless of how many compaction cycles occur.
47-
48-
13 skills cover the full lifecycle: project analysis, specification creation through parallel research agents, phased plan generation with quorum review, execution with automatic handoff, code review, convention analysis, and project rules management. 12 specialized agents handle implementation, testing, review, architecture, and coordination.
46+
Brewcode is a lean skill plus prompt-injection toolkit. Two focused skills cover specification authoring and semantic code search, backed by a small set of lifecycle hooks that inject plugin context, auto-start grepai, and steer search toward semantic queries. Nine specialized agents handle implementation, testing, review, architecture, and asset creation (skills, agents, hooks, scripts).
4947

5048
## Installation
5149

@@ -65,33 +63,16 @@ claude --plugin-dir ./brewcode
6563
## Quick Start
6664

6765
```bash
68-
/brewcode:setup # 1. Adapt templates for the project (one-time)
69-
/brewcode:spec "Implement JWT authorization" # 2. Research + specification
70-
/brewcode:plan # 3. Generate phased plan
71-
/brewcode:start # 4. Execute with infinite context
66+
/brewcode:spec "Implement JWT authorization" # Research + specification
67+
/brewcode:grepai setup # Semantic code search
7268
```
7369

74-
After `/brewcode:setup`, each task follows the cycle: `spec` -> `plan` -> `start`.
75-
7670
## Skills
7771

7872
| Skill | Purpose |
7973
|-------|---------|
80-
| [`/brewcode:setup`](skills/setup/README.md) | Analyze project, check prerequisites, generate adapted templates and config |
8174
| [`/brewcode:spec`](skills/spec/README.md) | Research codebase + user dialog -> SPEC.md |
82-
| [`/brewcode:plan`](skills/plan/README.md) | Generate phased PLAN.md from SPEC or Plan Mode with quorum review |
83-
| [`/brewcode:start`](skills/start/README.md) | Execute task with infinite context through automatic handoffs |
84-
| [`/brewcode:teams`](skills/teams/README.md) | Dynamic agent team creation, management, and performance tracking |
85-
| [`/brewcode:standards-review`](skills/standards-review/README.md) | Review code for project standards compliance |
86-
| [`/brewcode:convention`](skills/convention/README.md) | Extract etalon classes, patterns, architecture into convention docs and rules |
87-
| [`/brewcode:rules`](skills/rules/README.md) | Extract rules from accumulated knowledge to `.claude/rules/` |
8875
| [`/brewcode:grepai`](skills/grepai/README.md) | Semantic code search (setup, status, start, stop, reindex) |
89-
| [`/brewcode:skills`](skills/skills/README.md) | Skill management: list, create, upgrade with activation optimization |
90-
| [`/brewcode:agents`](skills/agents/README.md) | Interactive agent creation and improvement |
91-
| [`/brewcode:e2e`](skills/e2e/README.md) | E2E testing orchestration with BDD scenarios and quorum review |
92-
| [`/brewcode:teardown`](skills/teardown/README.md) | Plugin configuration cleanup (tasks are preserved) |
93-
94-
> **Note:** `/brewcode:review` is a local skill created in the project during `/brewcode:setup`.
9576

9677
## Agents
9778

@@ -105,30 +86,21 @@ After `/brewcode:setup`, each task follows the cycle: `spec` -> `plan` -> `start
10586
| [agent-creator](agents/agent-creator.md) | opus | Create and improve Claude Code agents |
10687
| [hook-creator](agents/hook-creator.md) | opus | Create and debug Claude Code hooks |
10788
| [bash-expert](agents/bash-expert.md) | opus | Create professional shell scripts |
108-
| bc-coordinator | haiku | Internal: spawned by /brewcode:start + post-task hook |
109-
| bc-knowledge-manager | haiku | Internal: spawned by /brewcode:start |
11089
| bc-grepai-configurator | opus | Internal: spawned by /brewcode:grepai |
111-
| bc-rules-organizer | sonnet | Internal: spawned by /brewcode:rules |
112-
113-
> **Dynamic teams:** Use `/brewcode:teams create` to generate 5-20 project-specific agents with self-selection protocol and performance tracking.
11490

11591
## Architecture
11692

11793
```
11894
brewcode/
11995
+-- .claude-plugin/plugin.json # Plugin manifest
120-
+-- hooks/ # 9 lifecycle hooks
96+
+-- hooks/ # 5 lifecycle hooks
12197
| +-- session-start.mjs # Session initialization
12298
| +-- grepai-session.mjs # Auto-start grepai watch
123-
| +-- pre-task.mjs # Knowledge injection into agents
12499
| +-- grepai-reminder.mjs # grepai reminder
125-
| +-- post-task.mjs # Session binding, 2-step protocol
126-
| +-- pre-compact.mjs # Knowledge compaction, handoff
127-
| +-- stop.mjs # Exit blocking
128100
| +-- forced-eval.mjs # Skill activation
129101
| +-- permission-guard.sh # Manager-mode edit guard
130-
+-- agents/ # 12 agents
131-
+-- skills/ # 13 skills
102+
+-- agents/ # 9 agents
103+
+-- skills/ # 2 skills
132104
+-- templates/ # Rule templates
133105
```
134106

@@ -138,27 +110,10 @@ brewcode/
138110
|------|-------|---------|
139111
| session-start | SessionStart | Initialize session, inject plugin path |
140112
| grepai-session | SessionStart | Auto-start grepai watch process |
141-
| pre-task | PreToolUse:Task | Inject grepai + KNOWLEDGE into agent prompts |
142-
| grepai-reminder | PreToolUse:Glob/Grep | Remind to prefer semantic search |
143-
| post-task | PostToolUse:Task | Bind session, enforce 2-step protocol |
144-
| pre-compact | PreCompact | Compact KNOWLEDGE, write handoff entry |
145-
| stop | Stop | Block if not terminal, clean lock |
113+
| grepai-reminder | PreToolUse:Bash | Remind to prefer semantic search |
146114
| forced-eval | UserPromptSubmit | Skill activation |
147115
| permission-guard | PreToolUse | Manager-mode edit guard for main session |
148116

149-
## Task Structure
150-
151-
```
152-
.claude/tasks/{TS}_{NAME}_task/
153-
SPEC.md # Specification (research results)
154-
PLAN.md # Phased execution plan
155-
KNOWLEDGE.jsonl # Accumulated knowledge (survives compactions)
156-
phases/ # Individual phase files for agents
157-
artifacts/ # Execution reports by phases
158-
backup/ # Backups
159-
.lock # Session lock file
160-
```
161-
162117
## Documentation
163118

164119
Full docs: [doc-claude.brewcode.app/brewcode/overview](https://doc-claude.brewcode.app/brewcode/overview/)
@@ -168,7 +123,6 @@ Full docs: [doc-claude.brewcode.app/brewcode/overview](https://doc-claude.brewco
168123
| Skills reference | [Skills](https://doc-claude.brewcode.app/brewcode/skills/) |
169124
| Agents reference | [Agents](https://doc-claude.brewcode.app/brewcode/agents/) |
170125
| Hooks reference | [Hooks](https://doc-claude.brewcode.app/brewcode/hooks/) |
171-
| Workflow | [Workflow](https://doc-claude.brewcode.app/brewcode/workflow/) |
172126
| Release Notes | [RELEASE-NOTES.md](../RELEASE-NOTES.md) |
173127

174128
Author: Maksim Kochetkov | License: MIT

0 commit comments

Comments
 (0)