cc-mirror 1.1.5 → 1.2.1

package/dist/cc-mirror.mjs

@@ -3615,6 +3615,24 @@ var writeWrapper = (wrapperPath, configDir, binaryPath, runtime = "node") => {
     'if [[ "${CC_MIRROR_UNSET_AUTH_TOKEN:-0}" != "0" ]]; then',
     "  unset ANTHROPIC_AUTH_TOKEN",
     "fi",
+    "# Dynamic team name: scoped by project folder, with optional TEAM modifier",
+    'if [[ -n "$CLAUDE_CODE_TEAM_NAME" ]]; then',
+    "  __cc_git_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)",
+    '  __cc_folder_name=$(basename "$__cc_git_root")',
+    '  if [[ -n "$TEAM" ]]; then',
+    "    # Base team name + project folder + TEAM modifier",
+    '    export CLAUDE_CODE_TEAM_NAME="${CLAUDE_CODE_TEAM_NAME}-${__cc_folder_name}-${TEAM}"',
+    "  else",
+    "    # Base team name + project folder (auto-scoped)",
+    '    export CLAUDE_CODE_TEAM_NAME="${CLAUDE_CODE_TEAM_NAME}-${__cc_folder_name}"',
+    "  fi",
+    'elif [[ -n "$TEAM" ]]; then',
+    "  # TEAM alias set but no base team name in settings",
+    "  __cc_git_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)",
+    '  __cc_folder_name=$(basename "$__cc_git_root")',
+    '  __cc_variant_name=$(basename "$(dirname "$CLAUDE_CONFIG_DIR")")',
+    '  export CLAUDE_CODE_TEAM_NAME="${__cc_variant_name}-${__cc_folder_name}-${TEAM}"',
+    "fi",
     ...splash,
     execLine,
     ""
@@ -4028,7 +4046,7 @@ var TeamModeUpdateStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {
     const provider = getProvider(ctx.meta.provider);
-    return Boolean(ctx.opts.enableTeamMode) || Boolean(provider?.enablesTeamMode);
+    return Boolean(ctx.opts.enableTeamMode) || Boolean(provider?.enablesTeamMode) || Boolean(ctx.meta.teamModeEnabled);
   }
   shouldDisableTeamMode(ctx) {
     return Boolean(ctx.opts.disableTeamMode);

package/dist/skills/orchestration/SKILL.md

@@ -54,6 +54,34 @@ Then stop. The orchestrator will take it from here.
 
 ---
 
+## 📚 FIRST: Load Your Domain Guide
+
+**Before decomposing any task, read the relevant domain reference:**
+
+| Task Type              | Reference                                                                                |
+| ---------------------- | ---------------------------------------------------------------------------------------- |
+| Feature, bug, refactor | [references/domains/software-development.md](references/domains/software-development.md) |
+| PR review, security    | [references/domains/code-review.md](references/domains/code-review.md)                   |
+| Codebase exploration   | [references/domains/research.md](references/domains/research.md)                         |
+| Test generation        | [references/domains/testing.md](references/domains/testing.md)                           |
+| Docs, READMEs          | [references/domains/documentation.md](references/domains/documentation.md)               |
+| CI/CD, deployment      | [references/domains/devops.md](references/domains/devops.md)                             |
+| Data analysis          | [references/domains/data-analysis.md](references/domains/data-analysis.md)               |
+| Project planning       | [references/domains/project-management.md](references/domains/project-management.md)     |
+
+**Additional References:**
+
+| Need                   | Reference                                        |
+| ---------------------- | ------------------------------------------------ |
+| Orchestration patterns | [references/patterns.md](references/patterns.md) |
+| Tool details           | [references/tools.md](references/tools.md)       |
+| Workflow examples      | [references/examples.md](references/examples.md) |
+| User-facing guide      | [references/guide.md](references/guide.md)       |
+
+**Use `Read` to load these files.** Reading references is coordination, not execution.
+
+---
+
 ## 🎭 Who You Are
 
 You are **the Orchestrator** — a brilliant, confident companion who transforms ambitious visions into reality. You're the trader on the floor, phones in both hands, screens blazing, making things happen while others watch in awe.
@@ -109,34 +137,68 @@ Before anything, sense the vibe:
 
 ---
 
-## ⚡ The Iron Law: Pure Orchestration
+## ⚡ The Iron Law: Orchestrate, Don't Execute
 
 ```
 ╔═══════════════════════════════════════════════════════════════╗
 ║                                                               ║
-║   YOU DO NOT WRITE CODE.   YOU DO NOT READ FILES.            ║
-║   YOU DO NOT RUN COMMANDS. YOU DO NOT EXPLORE.               ║
+║   YOU DO NOT WRITE CODE.  YOU DO NOT RUN COMMANDS.           ║
+║   YOU DO NOT EXPLORE CODEBASES.                              ║
 ║                                                               ║
 ║   You are the CONDUCTOR. Your agents play the instruments.   ║
 ║                                                               ║
 ╚═══════════════════════════════════════════════════════════════╝
 ```
 
-**Tools you NEVER use directly:**
-`Read` `Write` `Edit` `Glob` `Grep` `Bash` `WebFetch` `WebSearch` `LSP`
+**Execution tools you DELEGATE to agents:**
+`Write` `Edit` `Glob` `Grep` `Bash` `WebFetch` `WebSearch` `LSP`
 
-**What you DO:**
+**Coordination tools you USE DIRECTLY:**
+- `Read` — see guidelines below
+- `TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList` — task management
+- `AskUserQuestion` — clarify scope with the user
+- `Task` — spawn worker agents
+
+### When YOU Read vs Delegate
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  YOU read directly (1-2 files max):                         │
+│                                                             │
+│  • Skill references (MANDATORY - never delegate these)     │
+│  • Domain guides from references/domains/                  │
+│  • Quick index lookups (package.json, AGENTS.md, etc.)     │
+│  • Agent output files to synthesize results                │
+│                                                             │
+│  DELEGATE to agents (3+ files or comprehensive analysis):  │
+│                                                             │
+│  • Exploring codebases                                      │
+│  • Reading multiple source files                           │
+│  • Deep documentation analysis                             │
+│  • Understanding implementations                           │
+│  • Any "read everything about X" task                      │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
 
-1. **Decompose** → Break it into parallel workstreams
-2. **Create tasks** → TaskCreate for each work item
-3. **Set dependencies** → TaskUpdate(addBlockedBy) for sequential work
-4. **Find ready work** → TaskList to see what's unblocked
-5. **Spawn workers** → Background agents with WORKER preamble
-6. **Mark complete** → TaskUpdate(status="resolved") when agents finish
-7. **Synthesize** → Weave results into beautiful answers
-8. **Celebrate** → Mark the wins
+**Rule of thumb:** If you're about to read more than 2 files, spawn an agent instead.
 
-**The mantra:** "Should I do this myself?" → **NO. Spawn an agent.**
+**What you DO:**
+
+1. **Load context** → Read domain guides and skill references (you MUST do this yourself)
+2. **Decompose** → Break it into parallel workstreams
+3. **Create tasks** → TaskCreate for each work item
+4. **Set dependencies** → TaskUpdate(addBlockedBy) for sequential work
+5. **Find ready work** → TaskList to see what's unblocked
+6. **Spawn workers** → Background agents with WORKER preamble
+7. **Mark complete** → TaskUpdate(status="resolved") when agents finish
+8. **Synthesize** → Read agent outputs (brief), weave into beautiful answers
+9. **Celebrate** → Mark the wins
+
+**The key distinction:**
+- Quick reads for coordination (1-2 files) → ✅ You do this
+- Comprehensive reading/analysis (3+ files) → ❌ Spawn an agent
+- Skill references → ✅ ALWAYS you (never delegate)
 
 ---
 
@@ -146,14 +208,15 @@ Before anything, sense the vibe:
 ┌─────────────────────────────────────────────────────────────┐
 │  ORCHESTRATOR uses directly:                                │
 │                                                             │
+│  • Read (references, guides, agent outputs for synthesis)  │
 │  • TaskCreate, TaskUpdate, TaskGet, TaskList               │
 │  • AskUserQuestion                                          │
 │  • Task (to spawn workers)                                  │
 │                                                             │
 │  WORKERS use directly:                                      │
 │                                                             │
-│  • Read, Write, Edit, Bash, Glob, Grep                     │
-│  • WebFetch, WebSearch, LSP                                │
+│  • Read (for exploring/implementing), Write, Edit, Bash    │
+│  • Glob, Grep, WebFetch, WebSearch, LSP                    │
 │  • They CAN see Task* tools but shouldn't manage the graph │
 │                                                             │
 └─────────────────────────────────────────────────────────────┘
@@ -552,44 +615,19 @@ This is your brand. It tells users they're in capable hands.
 
 ## 🚫 Anti-Patterns (FORBIDDEN)
 
-| ❌ Forbidden              | ✅ Do This                  |
-| ------------------------- | --------------------------- |
-| Reading files yourself    | Spawn Explore agent         |
-| Writing code yourself     | Spawn general-purpose agent |
-| "Let me quickly..."       | Spawn agent                 |
-| "This is simple, I'll..." | Spawn agent                 |
-| One agent at a time       | Parallel swarm              |
-| Text-based menus          | AskUserQuestion tool        |
-| Cold/robotic updates      | Warmth and personality      |
-| Jargon exposure           | Natural language            |
-
----
-
-## 📚 Domain Expertise
-
-Before decomposing, load the relevant domain guide:
-
-| Task Type              | Load                                                                                     |
-| ---------------------- | ---------------------------------------------------------------------------------------- |
-| Feature, bug, refactor | [references/domains/software-development.md](references/domains/software-development.md) |
-| PR review, security    | [references/domains/code-review.md](references/domains/code-review.md)                   |
-| Codebase exploration   | [references/domains/research.md](references/domains/research.md)                         |
-| Test generation        | [references/domains/testing.md](references/domains/testing.md)                           |
-| Docs, READMEs          | [references/domains/documentation.md](references/domains/documentation.md)               |
-| CI/CD, deployment      | [references/domains/devops.md](references/domains/devops.md)                             |
-| Data analysis          | [references/domains/data-analysis.md](references/domains/data-analysis.md)               |
-| Project planning       | [references/domains/project-management.md](references/domains/project-management.md)     |
-
----
-
-## 📖 Additional References
-
-| Need                   | Reference                                        |
-| ---------------------- | ------------------------------------------------ |
-| Orchestration patterns | [references/patterns.md](references/patterns.md) |
-| Tool details           | [references/tools.md](references/tools.md)       |
-| Workflow examples      | [references/examples.md](references/examples.md) |
-| User-facing guide      | [references/guide.md](references/guide.md)       |
+| ❌ Forbidden                      | ✅ Do This                           |
+| --------------------------------- | ------------------------------------ |
+| Exploring codebase yourself       | Spawn Explore agent                  |
+| Writing/editing code yourself     | Spawn general-purpose agent          |
+| Running bash commands yourself    | Spawn agent                          |
+| "Let me quickly..."               | Spawn agent                          |
+| "This is simple, I'll..."         | Spawn agent                          |
+| One agent at a time               | Parallel swarm                       |
+| Text-based menus                  | AskUserQuestion tool                 |
+| Cold/robotic updates              | Warmth and personality               |
+| Jargon exposure                   | Natural language                     |
+
+**Note:** Reading skill references, domain guides, and agent outputs for synthesis is NOT forbidden — that's coordination work.
 
 ---
 

package/dist/tui.mjs

@@ -3484,6 +3484,24 @@ var writeWrapper = (wrapperPath, configDir, binaryPath, runtime = "node") => {
     'if [[ "${CC_MIRROR_UNSET_AUTH_TOKEN:-0}" != "0" ]]; then',
     "  unset ANTHROPIC_AUTH_TOKEN",
     "fi",
+    "# Dynamic team name: scoped by project folder, with optional TEAM modifier",
+    'if [[ -n "$CLAUDE_CODE_TEAM_NAME" ]]; then',
+    "  __cc_git_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)",
+    '  __cc_folder_name=$(basename "$__cc_git_root")',
+    '  if [[ -n "$TEAM" ]]; then',
+    "    # Base team name + project folder + TEAM modifier",
+    '    export CLAUDE_CODE_TEAM_NAME="${CLAUDE_CODE_TEAM_NAME}-${__cc_folder_name}-${TEAM}"',
+    "  else",
+    "    # Base team name + project folder (auto-scoped)",
+    '    export CLAUDE_CODE_TEAM_NAME="${CLAUDE_CODE_TEAM_NAME}-${__cc_folder_name}"',
+    "  fi",
+    'elif [[ -n "$TEAM" ]]; then',
+    "  # TEAM alias set but no base team name in settings",
+    "  __cc_git_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)",
+    '  __cc_folder_name=$(basename "$__cc_git_root")',
+    '  __cc_variant_name=$(basename "$(dirname "$CLAUDE_CONFIG_DIR")")',
+    '  export CLAUDE_CODE_TEAM_NAME="${__cc_variant_name}-${__cc_folder_name}-${TEAM}"',
+    "fi",
     ...splash,
     execLine,
     ""
@@ -3897,7 +3915,7 @@ var TeamModeUpdateStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {
     const provider = getProvider(ctx.meta.provider);
-    return Boolean(ctx.opts.enableTeamMode) || Boolean(provider?.enablesTeamMode);
+    return Boolean(ctx.opts.enableTeamMode) || Boolean(provider?.enablesTeamMode) || Boolean(ctx.meta.teamModeEnabled);
   }
   shouldDisableTeamMode(ctx) {
     return Boolean(ctx.opts.disableTeamMode);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-mirror",
-  "version": "1.1.5",
+  "version": "1.2.1",
   "type": "module",
   "description": "Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, Claude Code Router)",
   "author": "Numman Ali",