v4.0.1: purge v3.19.0 task-system doc debt from site; delete workflow page; reconcile brewcode skill/agent/hook counts; document grepai self-install

Author: kochetkov-ma

.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Claude Code plugin suite: brewcode for infinite task execution, brewdoc for documentation tools, brewtools for text utilities, brewui for UI/visual/creative tools",
-    "version": "4.0.0"
+    "version": "4.0.1"
   },
   "plugins": [
     {
       "name": "brewcode",
       "description": "Brewcode - full-featured development platform for Claude Code: infinite focus tasks, prompt optimization, skill/agent creation, quorum reviews, rules management",
-      "version": "4.0.0",
+      "version": "4.0.1",
       "category": "productivity",
       "keywords": [
         "brewcode",
@@ -46,7 +46,7 @@
     {
       "name": "brewdoc",
       "description": "Brewdoc - Claude Code documentation tools: auto-sync for skills/agents/rules, my-claude installation docs, memory optimization, md-to-pdf conversion",
-      "version": "4.0.0",
+      "version": "4.0.1",
       "category": "productivity",
       "keywords": [
         "brewdoc",
@@ -74,7 +74,7 @@
     {
       "name": "brewtools",
       "description": "Brewtools - universal utilities for Claude Code: text optimization, humanization, secrets scanning",
-      "version": "4.0.0",
+      "version": "4.0.1",
       "category": "productivity",
       "keywords": [
         "brewtools",
@@ -102,7 +102,7 @@
     {
       "name": "brewui",
       "description": "Placeholder for future UI/visual/creative tools (currently empty, installable)",
-      "version": "4.0.0",
+      "version": "4.0.1",
       "category": "productivity",
       "keywords": [
         "ui",

RELEASE-NOTES.md

@@ -2,6 +2,24 @@
 
 ---
 
+## v4.0.1 (2026-06-30)
+
+> Docs-only follow-up to v4.0.0 — purges leftover v3.19.0 task-system documentation debt from the site so docs match the real plugin.
+
+> Docs: [brewcode overview](https://doc-claude.brewcode.app/brewcode/overview/) | [agents](https://doc-claude.brewcode.app/brewcode/agents/) | [grepai](https://doc-claude.brewcode.app/brewcode/skills/grepai/) | [superreview](https://doc-claude.brewcode.app/brewcode/skills/superreview/) | [getting-started](https://doc-claude.brewcode.app/getting-started/) | [quickstart](https://doc-claude.brewcode.app/quickstart/) | [installation](https://doc-claude.brewcode.app/installation/)
+
+### docs
+#### Removed
+- **workflow page:** deleted `brewcode/workflow.mdx` (described the removed KNOWLEDGE/plan/start/handoff pipeline) + its `navigation.ts` entry
+- **dead skill/agent refs:** purged all links to removed skills (`/brewcode:setup`, `/brewcode:plan`, `/brewcode:start`, `/brewcode:standards-review`, `/brewcode:teardown`) and removed agents (`bc-coordinator`, `bc-knowledge-manager`) across getting-started, quickstart, installation, overview, agents, and skill/agent pages
+- **task-system framing:** removed dead KNOWLEDGE auto-accumulation / post-task / coordinator-loop / "infinite task" descriptions
+#### Changed
+- **brewcode counts reconciled:** 9 skills (spec, grepai, convention, rules, superreview, skills, agents, teams, e2e), 10 agents, 2 hooks; suite total 4 hooks
+- **grepai:** documented self-install behavior on its MDX page
+- **superreview:** now documented as the generator of the project-tailored deep-review skill (review + standards merged)
+
+---
+
 ## v4.0.0 (2026-06-30)
 
 > **MAJOR / breaking** — injection-hook architecture removed across all plugins; plugin-root now resolved natively via `${CLAUDE_PLUGIN_ROOT}`.

brewcode/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "brewcode",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Brewcode - full-featured development platform for Claude Code: infinite focus tasks, prompt optimization, skill/agent creation, quorum reviews, rules management",
   "author": {
     "name": "Maksim Kochetkov",

brewcode/README.md

@@ -4,7 +4,7 @@
 
 | Field | Value |
 |-------|-------|
-| Version | 4.0.0 |
+| Version | 4.0.1 |
 | Skills | 13 |
 | Agents | 12 |
 | Hooks | 2 |

brewcode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin-brewcode",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Infinite task execution with automatic handoff for Claude Code",
   "keywords": [
     "claude-code",
@@ -36,6 +36,6 @@
   },
   "claude-plugin": {
     "name": "brewcode",
-    "version": "4.0.0"
+    "version": "4.0.1"
   }
 }

brewdoc/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "brewdoc",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Brewdoc - Claude Code documentation tools: auto-sync for skills/agents/rules, my-claude installation docs, memory optimization",
   "author": {
     "name": "Maksim Kochetkov",

brewtools/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "brewtools",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Brewtools - universal utilities for Claude Code: text optimization, humanization, secrets scanning",
   "author": {
     "name": "Maksim Kochetkov",

brewui/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "brewui",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Brewui -- placeholder for future UI/visual/creative tools",
   "author": {
     "name": "Maksim Kochetkov",

web/docs/src/content/docs/brewcode/agents.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Agents"
-description: "All 12 Brewcode agents: models, triggers, tools"
+description: "All 10 Brewcode agents: models, triggers, tools"
 order: 12
 ---
 
@@ -24,10 +24,8 @@ from developer to task coordination.
 | 6 | agent-creator | opus | Read, Write, Edit | Agent creation and improvement |
 | 7 | hook-creator | opus | Read, Write, Edit, Bash | Hook creation and debugging |
 | 8 | bash-expert | opus | Read, Write, Edit, Bash | Bash/sh script creation |
-| 9 | bc-coordinator | haiku | Read, Write, Edit, Bash | Internal: spawned by /brewcode:start + post-task hook |
-| 10 | bc-knowledge-manager | haiku | Read, Write | Internal: spawned by /brewcode:start |
-| 11 | bc-grepai-configurator | opus | Read, Write, Edit, Bash | Internal: spawned by /brewcode:grepai |
-| 12 | bc-rules-organizer | sonnet | Read, Write, Edit, Bash | Internal: spawned by /brewcode:rules |
+| 9 | bc-grepai-configurator | opus | Read, Write, Edit, Bash | Internal: spawned by /brewcode:grepai |
+| 10 | bc-rules-organizer | sonnet | Read, Write, Edit, Bash | Internal: spawned by /brewcode:rules |
 
 <CardGrid>
   <Card title="developer" icon="code" href="/brewcode/agents/developer/">
@@ -57,7 +55,7 @@ from developer to task coordination.
 </CardGrid>
 
 :::note[Internal agents]
-`bc-coordinator`, `bc-knowledge-manager`, `bc-grepai-configurator`, and `bc-rules-organizer` are internal. They are spawned automatically by brewcode skills and hooks, are not user-invokable, and have no dedicated page.
+`bc-grepai-configurator` and `bc-rules-organizer` are internal. They are spawned automatically by brewcode skills and hooks, are not user-invokable, and have no dedicated page.
 :::
 
 ## Models and cost
@@ -66,12 +64,10 @@ from developer to task coordination.
 |-------|--------|-------------|
 | **opus** | [developer](/brewcode/agents/developer/), [reviewer](/brewcode/agents/reviewer/), [architect](/brewcode/agents/architect/), [skill-creator](/brewcode/agents/skill-creator/), [agent-creator](/brewcode/agents/agent-creator/), [hook-creator](/brewcode/agents/hook-creator/), [bash-expert](/brewcode/agents/bash-expert/), bc-grepai-configurator | Complex tasks, deep analysis, code generation |
 | **sonnet** | [tester](/brewcode/agents/tester/), bc-rules-organizer | Balanced tasks, review, optimization |
-| **haiku** | bc-coordinator, bc-knowledge-manager | Lightweight operations: statuses, knowledge extraction, compaction |
 
 <Callout type="tip" title="Automatic selection">
-  Agents are selected automatically based on the Phase Registry in PLAN.md.
-  The [/brewcode:start](/brewcode/skills/start/) skill reads agent assignments from the phase table
-  and launches the corresponding agents via Task API.
+  Agents are launched automatically by brewcode skills via the Task API.
+  Each skill spawns the relevant agent for its domain — no manual agent selection required.
 </Callout>
 
 <Callout type="note" title="Moved Agents">

web/docs/src/content/docs/brewcode/agents/agent-creator.mdx

@@ -123,7 +123,7 @@ Description patterns by ambiguity level:
 | Some — 1-2 other agents | Single-line + detailed Triggers | `"Creates bash scripts. Triggers: create script, bash script, shell script"` |
 | High — creator/meta agents | Multi-line + 2-3 `<example>` blocks | See agent-creator.md source |
 
-Subagent spawn constraint: CC 2.1.172 allows nested subagent spawning up to 5 levels deep. However, brewcode workflow requires spawning only from the main conversation — the 2-step report protocol (`post-task.mjs`) binds the task lock to one session and delivers report/coordinator instructions back to the spawning conversation. Nested spawns bypass session binding, `KNOWLEDGE` injection, and the coordinator loop. This is a **brewcode workflow policy**, not a Claude Code platform limitation.
+Subagent spawn note: CC allows nested subagent spawning, but prefer spawning from the main conversation so the orchestrator can integrate each agent's result directly. Brewcode agents are stateless and resolve plugin paths via `${CLAUDE_PLUGIN_ROOT}`.
 
 Known active bugs: [#29423](https://github.com/anthropics/claude-code/issues/29423) (subagents skip CLAUDE.md), [#27736](https://github.com/anthropics/claude-code/issues/27736) (`skills:` in plugin agents), [#31392](https://github.com/anthropics/claude-code/issues/31392) (global agents not discovered in v2.1.70+).
 </details>