refactor: remove subagent references and update CLI tool usage across documentation

Author: catlog22

.claude/skills/team-lifecycle-v2/SKILL.md

@@ -34,8 +34,8 @@ Optimized lifecycle: specification → implementation → testing → review. Bu
                                         | fe-qa  |
                                         +--------+
 
-  Subagent (callable by analyst, writer, reviewer):
-    [discuss-subagent]  - multi-perspective critique (3 rounds)
+  ⚠️ ARCHITECTURAL CONSTRAINT: Workers CANNOT spawn subagents.
+  Workers use CLI tools for complex analysis (see "CLI Tool Usage in Workers" section).
 ```
 
 ## Role Router

.claude/skills/team-lifecycle-v2/role-specs/executor.md

@@ -3,7 +3,6 @@ role: executor
 prefix: IMPL
 inner_loop: true
 discuss_rounds: []
-subagents: []
 message_types:
   success: impl_complete
   progress: impl_progress

.claude/skills/team-lifecycle-v2/role-specs/fe-developer.md

@@ -3,7 +3,6 @@ role: fe-developer
 prefix: DEV-FE
 inner_loop: false
 discuss_rounds: []
-subagents: []
 message_types:
   success: dev_fe_complete
   progress: dev_fe_progress

.claude/skills/team-lifecycle-v2/role-specs/fe-qa.md

@@ -3,7 +3,6 @@ role: fe-qa
 prefix: QA-FE
 inner_loop: false
 discuss_rounds: []
-subagents: []
 message_types:
   success: qa_fe_passed
   result: qa_fe_result

.claude/skills/team-lifecycle-v2/role-specs/planner.md

@@ -3,7 +3,6 @@ role: planner
 prefix: PLAN
 inner_loop: true
 discuss_rounds: []
-subagents: []
 message_types:
   success: plan_ready
   revision: plan_revision

.claude/skills/team-lifecycle-v2/role-specs/tester.md

@@ -3,7 +3,6 @@ role: tester
 prefix: TEST
 inner_loop: false
 discuss_rounds: []
-subagents: []
 message_types:
   success: test_result
   fix: fix_required

.claude/skills/team-lifecycle-v2/specs/team-config.json

@@ -6,94 +6,134 @@
   "architecture": "team-worker agent + role-specs",
   "role_structure": "role-specs/{name}.md (Phase 2-4 only)",
   "worker_agent": "team-worker",
-
   "roles": {
     "coordinator": {
       "task_prefix": null,
       "responsibility": "Pipeline orchestration, requirement clarification, task chain creation",
-      "message_types": ["plan_approved", "plan_revision", "task_unblocked", "fix_required", "error", "shutdown"]
+      "message_types": [
+        "plan_approved",
+        "plan_revision",
+        "task_unblocked",
+        "fix_required",
+        "error",
+        "shutdown"
+      ]
     },
     "analyst": {
       "task_prefix": "RESEARCH",
       "role_spec": "role-specs/analyst.md",
       "responsibility": "Seed analysis, codebase exploration, context gathering + discuss",
       "inline_discuss": "DISCUSS-001",
       "inner_loop": false,
-      "message_types": ["research_ready", "research_progress", "error"]
+      "message_types": [
+        "research_ready",
+        "research_progress",
+        "error"
+      ]
     },
     "writer": {
       "task_prefix": "DRAFT",
       "role_spec": "role-specs/writer.md",
       "responsibility": "Product Brief / PRD / Architecture / Epics generation. Discuss at PRD only, self-validate others",
       "inner_loop": true,
-      "inline_discuss": ["DISCUSS-002"],
-      "message_types": ["draft_ready", "draft_revision", "error"]
+      "inline_discuss": [
+        "DISCUSS-002"
+      ],
+      "message_types": [
+        "draft_ready",
+        "draft_revision",
+        "error"
+      ]
     },
     "planner": {
       "task_prefix": "PLAN",
       "role_spec": "role-specs/planner.md",
       "responsibility": "Multi-angle exploration and structured implementation planning",
       "inner_loop": true,
-      "message_types": ["plan_ready", "plan_revision", "error"]
+      "message_types": [
+        "plan_ready",
+        "plan_revision",
+        "error"
+      ]
     },
     "executor": {
       "task_prefix": "IMPL",
       "role_spec": "role-specs/executor.md",
       "responsibility": "Code implementation following approved plans",
       "inner_loop": true,
-      "message_types": ["impl_complete", "impl_progress", "error"]
+      "message_types": [
+        "impl_complete",
+        "impl_progress",
+        "error"
+      ]
     },
     "tester": {
       "task_prefix": "TEST",
       "role_spec": "role-specs/tester.md",
       "responsibility": "Adaptive test-fix cycles, progressive testing",
       "inner_loop": false,
-      "message_types": ["test_result", "fix_required", "error"]
+      "message_types": [
+        "test_result",
+        "fix_required",
+        "error"
+      ]
     },
     "reviewer": {
       "task_prefix": "REVIEW",
-      "additional_prefixes": ["QUALITY", "IMPROVE"],
+      "additional_prefixes": [
+        "QUALITY",
+        "IMPROVE"
+      ],
       "role_spec": "role-specs/reviewer.md",
       "responsibility": "Code review (REVIEW-*) + Spec quality (QUALITY-*) + Improvement (IMPROVE-*) + final discuss",
       "inline_discuss": "DISCUSS-003",
       "inner_loop": false,
-      "message_types": ["review_result", "quality_result", "quality_recheck", "fix_required", "error"]
+      "message_types": [
+        "review_result",
+        "quality_result",
+        "quality_recheck",
+        "fix_required",
+        "error"
+      ]
     },
     "architect": {
       "task_prefix": "ARCH",
       "role_spec": "role-specs/architect.md",
       "responsibility": "Architecture assessment, tech feasibility. Consulting role",
       "role_type": "consulting",
       "inner_loop": false,
-      "message_types": ["arch_ready", "arch_concern", "error"]
+      "message_types": [
+        "arch_ready",
+        "arch_concern",
+        "error"
+      ]
     },
     "fe-developer": {
       "task_prefix": "DEV-FE",
       "role_spec": "role-specs/fe-developer.md",
       "responsibility": "Frontend implementation",
       "role_type": "frontend-pipeline",
       "inner_loop": false,
-      "message_types": ["dev_fe_complete", "dev_fe_progress", "error"]
+      "message_types": [
+        "dev_fe_complete",
+        "dev_fe_progress",
+        "error"
+      ]
     },
     "fe-qa": {
       "task_prefix": "QA-FE",
       "role_spec": "role-specs/fe-qa.md",
       "responsibility": "5-dimension frontend review, GC loop",
       "role_type": "frontend-pipeline",
       "inner_loop": false,
-      "message_types": ["qa_fe_passed", "qa_fe_result", "fix_required", "error"]
+      "message_types": [
+        "qa_fe_passed",
+        "qa_fe_result",
+        "fix_required",
+        "error"
+      ]
     }
   },
-
-  "subagents": {
-    "discuss": {
-      "spec": "subagents/discuss-subagent.md",
-      "type": "cli-discuss-agent",
-      "callable_by": ["analyst", "writer", "reviewer"],
-      "purpose": "Multi-perspective critique (3 rounds: direction, requirements, final gate)"
-    }
-  },
-
   "checkpoint_commands": {
     "revise": {
       "handler": "handleRevise",
@@ -116,17 +156,32 @@
       "cascade": false
     }
   },
-
   "pipelines": {
     "spec-only": {
       "description": "Spec pipeline: research(+D1) -> brief -> prd(+D2) -> arch -> epics -> quality(+D3)",
-      "task_chain": ["RESEARCH-001", "DRAFT-001", "DRAFT-002", "DRAFT-003", "DRAFT-004", "QUALITY-001"],
-      "discuss_points": ["RESEARCH-001", "DRAFT-002", "QUALITY-001"],
+      "task_chain": [
+        "RESEARCH-001",
+        "DRAFT-001",
+        "DRAFT-002",
+        "DRAFT-003",
+        "DRAFT-004",
+        "QUALITY-001"
+      ],
+      "discuss_points": [
+        "RESEARCH-001",
+        "DRAFT-002",
+        "QUALITY-001"
+      ],
       "beats": 6
     },
     "impl-only": {
       "description": "Implementation pipeline: plan -> implement -> test + review",
-      "task_chain": ["PLAN-001", "IMPL-001", "TEST-001", "REVIEW-001"],
+      "task_chain": [
+        "PLAN-001",
+        "IMPL-001",
+        "TEST-001",
+        "REVIEW-001"
+      ],
       "beats": 3
     },
     "full-lifecycle": {
@@ -136,28 +191,50 @@
     },
     "fe-only": {
       "description": "Frontend-only: plan -> dev -> qa",
-      "task_chain": ["PLAN-001", "DEV-FE-001", "QA-FE-001"],
-      "gc_loop": { "max_rounds": 2, "convergence": "score >= 8 && critical === 0" }
+      "task_chain": [
+        "PLAN-001",
+        "DEV-FE-001",
+        "QA-FE-001"
+      ],
+      "gc_loop": {
+        "max_rounds": 2,
+        "convergence": "score >= 8 && critical === 0"
+      }
     },
     "fullstack": {
       "description": "Fullstack: plan -> backend + frontend parallel -> test + qa -> review",
-      "task_chain": ["PLAN-001", "IMPL-001||DEV-FE-001", "TEST-001||QA-FE-001", "REVIEW-001"]
+      "task_chain": [
+        "PLAN-001",
+        "IMPL-001||DEV-FE-001",
+        "TEST-001||QA-FE-001",
+        "REVIEW-001"
+      ]
     },
     "full-lifecycle-fe": {
       "description": "Full lifecycle with frontend",
       "task_chain": "spec-only + fullstack (PLAN-001 blockedBy QUALITY-001)"
     }
   },
-
   "frontend_detection": {
-    "keywords": ["component", "page", "UI", "frontend", "CSS", "HTML", "React", "Vue", "Tailwind", "Svelte", "Next.js"],
+    "keywords": [
+      "component",
+      "page",
+      "UI",
+      "frontend",
+      "CSS",
+      "HTML",
+      "React",
+      "Vue",
+      "Tailwind",
+      "Svelte",
+      "Next.js"
+    ],
     "routing_rules": {
       "frontend_only": "All tasks match frontend keywords",
       "fullstack": "Mix of frontend and backend tasks",
       "backend_only": "No frontend keywords (default impl-only)"
     }
   },
-
   "session_dirs": {
     "base": ".workflow/.team/TLS-{slug}-{YYYY-MM-DD}/",
     "spec": "spec/",

.claude/skills/team-lifecycle-v3/SKILL.md

@@ -78,12 +78,25 @@ Workers use CLI tools for complex analysis:
 
 ### Coordinator-Only Utility Members
 
+**⚠️ COORDINATOR ONLY**: Utility members can only be spawned by Coordinator.
+Workers CANNOT call Agent() to spawn utility members.
+
 Coordinator can spawn utility members for team-level orchestration:
 
-| Utility Member | Purpose | When |
-|----------------|---------|------|
-| explorer | Parallel multi-angle exploration | High complexity analysis |
-| discussant | Aggregate multi-CLI critique | Critical decision points |
+| Utility Member | Purpose | When | Callable By |
+|----------------|---------|------|-------------|
+| explorer | Parallel multi-angle exploration | High complexity analysis | **Coordinator only** |
+| discussant | Aggregate multi-CLI critique | Critical decision points | **Coordinator only** |
+
+### Worker Alternatives
+
+Workers needing similar capabilities must use CLI tools:
+
+| Capability | CLI Command | Example |
+|------------|-------------|---------|
+| Codebase exploration | `ccw cli --tool gemini --mode analysis` | Explore architecture patterns |
+| Multi-perspective critique | Parallel CLI calls | Security + performance + quality reviews |
+| Document generation | `ccw cli --tool gemini --mode write` | Generate PRD from research |
 
 ### Dynamic Role Injection
 

docs/agents/builtin.md

@@ -396,10 +396,10 @@ Task({
 
 **Capabilities**:
 - Orchestrates parallel CLAUDE.md updates
-- Uses ccw tool exec update_module_claude
+- Uses MCP tools directly for module documentation
 - Processes every module path
 
-**Tools**: `Bash`, `ccw tool exec`, `TodoWrite`
+**Tools**: `Bash`, `mcp__ccw-tools__*`, `TodoWrite`
 
 ```javascript
 Task({
@@ -511,7 +511,7 @@ Specialized agents use: `mcp__ace-tool__search_context`, `mcp__ccw-tools__smart_
 
 ### CLI Tools
 
-CLI-capable agents use: `ccw cli`, `ccw tool exec`
+CLI-capable agents use: `ccw cli`, MCP tools directly
 
 ### Workflow Tools
 

docs/features/codexlens.md

@@ -41,21 +41,17 @@
 
 ## Usage
 
-### Indexing Project
+### Via MCP Tool (Recommended)
 
-```bash
-ccw index
-ccw index --watch  # Continuous indexing
-```
-
-### Searching
-
-```bash
-ccw search "authentication logic"
-ccw search "where is user validation" --top 10
+```typescript
+// ACE semantic search
+mcp__ace-tool__search_context({
+  project_root_path: "/path/to/project",
+  query: "authentication logic"
+})
 ```
 
-### Via MCP Tool
+> **Note**: The CLI commands `ccw index` and `ccw search` are deprecated. Use MCP tools directly for semantic search.
 
 ```typescript
 // ACE semantic search