cc-workspace 4.1.0 → 4.1.2

package/README.md

@@ -1,65 +1,64 @@
-# Claude Code Multi-Workspace Orchestrator v4.1.0
+# cc-workspace
 
-A system to pilot multi-service projects from Claude Code.
-The orchestrator (Opus) never codes in repos. It clarifies, plans,
-delegates to teammates who work in parallel in each repo.
+**Claude Code Multi-Workspace Orchestrator** — turn Claude Code into a team of AI developers that work in parallel across your repos.
 
-> Claude Code v2.1.47+ / Opus 4.6 / Sonnet 4.6 (February 2026).
-> 9 skills, 11 hooks, 3 agents, 3 rules.
+Instead of Claude Code trying to do everything in one session and losing context, `cc-workspace` sets up an orchestrator (Opus) that clarifies requirements, writes a plan, then delegates to teammates (Sonnet) who implement in parallel — each in their own repo, their own worktree, their own context.
+
+> Requires [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v2.1.47+ with Agent Teams.
+> Works with Opus 4.6, Sonnet 4.6, Haiku 4.5 (February 2026).
 
 ---
 
-## Installation
+## Quick start
 
 ### Prerequisites
 
-- **Claude Code** v2.1.47+
+- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** v2.1.47+
 - **Node.js** 18+
 - **jq** (`brew install jq` on macOS, `apt install jq` on Linux)
 
-### 1. Workspace setup
+### Setup a workspace
 
 ```bash
+# Navigate to the parent directory containing your repos
 cd ~/projects/my-workspace
+
+# Initialize the orchestrator (no install needed)
 npx cc-workspace init . "My Project"
 ```
 
-The CLI:
-- Installs skills/rules/agents in `~/.claude/` (if newer version)
-- Creates `orchestrator/` with plans/, templates/, hooks
-- Scans sibling repos (directories with `.git/`)
-- Generates `service-profiles.md`
-- workspace.md and constitution.md in `[UNCONFIGURED]` mode
+This creates an `orchestrator/` directory and installs 9 skills, 3 agents, 11 hooks, and 3 rules into `~/.claude/`.
 
-### 2. Initialization (one time only)
+### Configure (one time)
 
 ```bash
 cd orchestrator/
 claude --agent workspace-init
-# type "go" to start the diagnostic
+# type "go" to start the interactive diagnostic
 ```
 
-The `workspace-init` agent:
-1. Diagnoses the structure (hooks, settings, templates)
-2. Scans sibling repos, detects project types, checks Claude Code readiness
-3. Offers to generate missing CLAUDE.md files (optional)
-4. Interactive configuration of workspace.md (section by section)
-5. Interactive configuration of constitution.md (project rules)
-6. Final report with each check's status
+The init agent will:
+1. Scan sibling repos and detect their tech stacks
+2. Offer to generate missing `CLAUDE.md` files for each repo
+3. Walk you through `workspace.md` configuration (section by section)
+4. Walk you through `constitution.md` (your engineering principles)
 
-### 3. Work sessions
+### Start working
 
 ```bash
 cd orchestrator/
 claude --agent team-lead
-
-# The team-lead offers 4 modes:
-# A -- Full (clarify -> plan -> validate -> dispatch -> QA)
-# B -- Quick plan (specs -> plan -> dispatch)
-# C -- Go direct (immediate dispatch)
-# D -- Single-service (1 repo, no waves)
 ```
 
+The team-lead offers 4 modes:
+
+| Mode | When to use |
+|------|-------------|
+| **A -- Full** | Complex feature, multi-service, needs clarification |
+| **B -- Quick plan** | Clear specs, no questions needed |
+| **C -- Go direct** | Hotfix, quick fix, obvious specs |
+| **D -- Single-service** | Bug or isolated feature in a single repo |
+
 ### Update
 
 ```bash
@@ -68,7 +67,7 @@ npx cc-workspace update
 
 Updates all components if the package version is newer:
 - **Global**: skills, rules, agents in `~/.claude/`
-- **Local** (if orchestrator/ found): hooks, settings.json, CLAUDE.md, templates, _TEMPLATE.md
+- **Local** (if `orchestrator/` found): hooks, settings.json, CLAUDE.md, templates, _TEMPLATE.md
 - **Never overwritten**: workspace.md, constitution.md, plans/
 
 ### Diagnostic
@@ -353,6 +352,19 @@ Both `init` and `update` are safe to re-run:
 
 ---
 
+## Changelog v4.0 -> v4.0.5
+
+| # | Fix | Detail |
+|---|-----|--------|
+| 1 | **Agent frontmatter fix** | `allowed-tools` → `tools` on all 3 agents. `allowed-tools` is the skill field — agents use `tools`. Without this fix, tool restrictions were silently ignored. |
+| 2 | **Removed `effort` field** | `effort: high/medium/low` doesn't exist in Claude Code spec. Removed from all agents. |
+| 3 | **Skill `agent` field** | Added `agent: Explore` or `agent: general-purpose` to 6 skills for proper subagent routing. |
+| 4 | **`Task(type)` restrictions** | team-lead restricted to `Task(implementer, Explore)`, workspace-init to `Task(Explore)`. |
+| 5 | **`update` fixes local files** | `npx cc-workspace update` now also updates local orchestrator/ files (hooks, settings.json, CLAUDE.md, templates, _TEMPLATE.md). Previously only updated globals. |
+| 6 | **Failure handling** | Added failure handling section to spawn-templates: max 2 re-dispatches, escalation criteria. |
+
+---
+
 ## Changelog v3.5.0 -> v4.0
 
 | # | Feature | Detail |

package/bin/cli.js

@@ -199,7 +199,9 @@ function installGlobals(force) {
 // Claude Code hook format: { matcher: { tools: [...] }, hooks: [{ type: "command", command: "...", timeout: N }] }
 // For hooks without tool matcher: { hooks: [{ type: "command", command: "...", timeout: N }] }
 function generateSettings(orchDir) {
-  const hp = ".claude/hooks";
+  // Use $CLAUDE_PROJECT_DIR so hooks resolve correctly even when
+  // subagents run from a different CWD (e.g. worktree in sibling repo)
+  const hp = '${CLAUDE_PROJECT_DIR:-.}/.claude/hooks';
 
   function hook(command, timeout) {
     return { type: "command", command: `bash ${hp}/${command}`, timeout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-workspace",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Claude Code multi-workspace orchestrator — skills, hooks, agents, and templates for multi-service projects",
   "bin": {
     "cc-workspace": "./bin/cli.js"
@@ -20,7 +20,15 @@
     "workspace",
     "monorepo"
   ],
-  "author": "VincVan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VincentVanN/cc-workspace.git"
+  },
+  "homepage": "https://github.com/VincentVanN/cc-workspace#readme",
+  "bugs": {
+    "url": "https://github.com/VincentVanN/cc-workspace/issues"
+  },
+  "author": "VincentVanN",
   "license": "MIT",
   "engines": {
     "node": ">=18"