claude-code-workflow 6.3.54 → 7.0.0

package/.claude/commands/memory/update-related.md

@@ -1,332 +0,0 @@
----
-name: update-related
-description: Update CLAUDE.md for git-changed modules using batched agent execution (4 modules/agent) with gemini→qwen→codex fallback, <15 modules uses direct execution
-argument-hint: "[--tool gemini|qwen|codex]"
----
-
-# Related Documentation Update (/memory:update-related)
-
-## Overview
-
-Orchestrates context-aware CLAUDE.md updates for changed modules using batched agent execution with automatic tool fallback (gemini→qwen→codex).
-
-**Parameters**:
-- `--tool <gemini|qwen|codex>`: Primary tool (default: gemini)
-
-**Execution Flow**:
-1. Change Detection → 2. Plan Presentation → 3. Batched Agent Execution → 4. Safety Verification
-
-## Core Rules
-
-1. **Detect Changes First**: Use git diff to identify affected modules
-2. **Wait for Approval**: Present plan, no execution without user confirmation
-3. **Execution Strategy**:
-   - <15 modules: Direct parallel execution (max 4 concurrent per depth, no agent overhead)
-   - ≥15 modules: Agent batch processing (4 modules/agent, 73% overhead reduction)
-4. **Tool Fallback**: Auto-retry with fallback tools on failure
-5. **Depth Sequential**: Process depths N→0, parallel batches within depth (both modes)
-6. **Related Mode**: Update only changed modules and their parent contexts
-
-## Tool Fallback Hierarchy
-
-```javascript
---tool gemini  →  [gemini, qwen, codex]  // default
---tool qwen    →  [qwen, gemini, codex]
---tool codex   →  [codex, gemini, qwen]
-```
-
-**Trigger**: Non-zero exit code from update script
-
-## Phase 1: Change Detection & Analysis
-
-```javascript
-// Detect changed modules
-Bash({command: "ccw tool exec detect_changed_modules '{\"format\":\"list\"}'", run_in_background: false});
-
-// Cache git changes
-Bash({command: "git add -A 2>/dev/null || true", run_in_background: false});
-```
-
-**Parse output** `depth:N|path:<PATH>|change:<TYPE>` to extract affected modules.
-
-**Smart filter**: Auto-detect and skip tests/build/config/docs based on project tech stack (Node.js/Python/Go/Rust/etc).
-
-**Fallback**: If no changes detected, use recent modules (first 10 by depth).
-
-## Phase 2: Plan Presentation
-
-**Present filtered plan**:
-```
-Related Update Plan:
-  Tool: gemini (fallback: qwen → codex)
-  Changed: 4 modules | Batching: 4 modules/agent
-
-  Will update:
-  - ./src/api/auth (5 files) [new module]
-  - ./src/api (12 files) [parent of changed auth/]
-  - ./src (8 files) [parent context]
-  - . (14 files) [root level]
-
-  Auto-skipped (12 paths):
-  - Tests: ./src/api/auth.test.ts (8 paths)
-  - Config: tsconfig.json (3 paths)
-  - Other: node_modules (1 path)
-
-  Agent allocation:
-  - Depth 3 (1 module): 1 agent [1]
-  - Depth 2 (1 module): 1 agent [1]
-  - Depth 1 (1 module): 1 agent [1]
-  - Depth 0 (1 module): 1 agent [1]
-
-  Confirm execution? (y/n)
-```
-
-**Decision logic**:
-- User confirms "y": Proceed with execution
-- User declines "n": Abort, no changes
-- <15 modules: Direct execution
-- ≥15 modules: Agent batch execution
-
-## Phase 3A: Direct Execution (<15 modules)
-
-**Strategy**: Parallel execution within depth (max 4 concurrent), no agent overhead.
-
-**CRITICAL**: All Bash commands use `run_in_background: false` for synchronous execution.
-
-```javascript
-for (let depth of sorted_depths.reverse()) {  // N → 0
-  let batches = batch_modules(modules_by_depth[depth], 4);
-
-  for (let batch of batches) {
-    let parallel_tasks = batch.map(module => {
-      return async () => {
-        for (let tool of tool_order) {
-          Bash({
-            command: `cd ${module.path} && ccw tool exec update_module_claude '{"strategy":"single-layer","path":".","tool":"${tool}"}'`,
-            run_in_background: false
-          });
-          if (bash_result.exit_code === 0) {
-            report(`✅ ${module.path} updated with ${tool}`);
-            return true;
-          }
-        }
-        report(`❌ FAILED: ${module.path} failed all tools`);
-        return false;
-      };
-    });
-    await Promise.all(parallel_tasks.map(task => task()));
-  }
-}
-```
-
----
-
-## Phase 3B: Agent Batch Execution (≥15 modules)
-
-### Batching Strategy
-
-```javascript
-// Batch modules into groups of 4
-function batch_modules(modules, batch_size = 4) {
-  let batches = [];
-  for (let i = 0; i < modules.length; i += batch_size) {
-    batches.push(modules.slice(i, i + batch_size));
-  }
-  return batches;
-}
-// Examples: 10→[4,4,2] | 8→[4,4] | 3→[3]
-```
-
-### Coordinator Orchestration
-
-```javascript
-let modules_by_depth = group_by_depth(changed_modules);
-let tool_order = construct_tool_order(primary_tool);
-
-for (let depth of sorted_depths.reverse()) {  // N → 0
-  let batches = batch_modules(modules_by_depth[depth], 4);
-  let worker_tasks = [];
-
-  for (let batch of batches) {
-    worker_tasks.push(
-      Task(
-        subagent_type="memory-bridge",
-        description=`Update ${batch.length} modules at depth ${depth}`,
-        prompt=generate_batch_worker_prompt(batch, tool_order, "related")
-      )
-    );
-  }
-
-  await parallel_execute(worker_tasks);  // Batches run in parallel
-}
-```
-
-### Batch Worker Prompt Template
-
-```
-PURPOSE: Update CLAUDE.md for assigned modules with tool fallback (related mode)
-
-TASK:
-Update documentation for the following modules based on recent changes. For each module, try tools in order until success.
-
-MODULES:
-{{module_path_1}}
-{{module_path_2}}
-{{module_path_3}}
-{{module_path_4}}
-
-TOOLS (try in order):
-1. {{tool_1}}
-2. {{tool_2}}
-3. {{tool_3}}
-
-EXECUTION:
-For each module above:
-  1. Try tool 1:
-     Bash({
-       command: `cd "{{module_path}}" && ccw tool exec update_module_claude '{"strategy":"single-layer","path":".","tool":"{{tool_1}}"}'`,
-       run_in_background: false
-     })
-     → Success: Report "✅ {{module_path}} updated with {{tool_1}}", proceed to next module
-     → Failure: Try tool 2
-  2. Try tool 2:
-     Bash({
-       command: `cd "{{module_path}}" && ccw tool exec update_module_claude '{"strategy":"single-layer","path":".","tool":"{{tool_2}}"}'`,
-       run_in_background: false
-     })
-     → Success: Report "✅ {{module_path}} updated with {{tool_2}}", proceed to next module
-     → Failure: Try tool 3
-  3. Try tool 3:
-     Bash({
-       command: `cd "{{module_path}}" && ccw tool exec update_module_claude '{"strategy":"single-layer","path":".","tool":"{{tool_3}}"}'`,
-       run_in_background: false
-     })
-     → Success: Report "✅ {{module_path}} updated with {{tool_3}}", proceed to next module
-     → Failure: Report "❌ FAILED: {{module_path}} failed all tools", proceed to next module
-
-REPORTING:
-Report final summary with:
-- Total processed: X modules
-- Successful: Y modules
-- Failed: Z modules
-- Tool usage: {{tool_1}}:X, {{tool_2}}:Y, {{tool_3}}:Z
-```
-
-## Phase 4: Safety Verification
-
-```javascript
-// Check only CLAUDE.md modified
-Bash({command: 'git diff --cached --name-only | grep -v "CLAUDE.md" || echo "Only CLAUDE.md files modified"', run_in_background: false});
-
-// Display statistics
-Bash({command: "git diff --stat", run_in_background: false});
-```
-
-**Aggregate results**:
-```
-Update Summary:
-  Total: 4 | Success: 4 | Failed: 0
-
-  Tool usage:
-  - gemini: 4 modules
-  - qwen: 0 modules (fallback)
-  - codex: 0 modules
-
-  Changes:
-  src/api/auth/CLAUDE.md  | 45 +++++++++++++++++++++
-  src/api/CLAUDE.md       | 23 +++++++++--
-  src/CLAUDE.md           | 12 ++++--
-  CLAUDE.md               | 8 ++--
-  4 files changed, 82 insertions(+), 6 deletions(-)
-```
-
-## Execution Summary
-
-**Module Count Threshold**:
-- **<15 modules**: Coordinator executes Phase 3A (Direct Execution)
-- **≥15 modules**: Coordinator executes Phase 3B (Agent Batch Execution)
-
-**Agent Hierarchy** (for ≥15 modules):
-- **Coordinator**: Handles batch division, spawns worker agents per depth
-- **Worker Agents**: Each processes 4 modules with tool fallback (related mode)
-
-## Error Handling
-
-**Batch Worker**:
-- Tool fallback per module (auto-retry)
-- Batch isolation (failures don't propagate)
-- Clear per-module status reporting
-
-**Coordinator**:
-- No changes: Use fallback (recent 10 modules)
-- User decline: No execution
-- Safety check fail: Auto-revert staging
-- Partial failures: Continue execution, report failed modules
-
-**Fallback Triggers**:
-- Non-zero exit code
-- Script timeout
-- Unexpected output
-
-## Tool Reference
-
-| Tool   | Best For                       | Fallback To    |
-|--------|--------------------------------|----------------|
-| gemini | Documentation, patterns        | qwen → codex   |
-| qwen   | Architecture, system design    | gemini → codex |
-| codex  | Implementation, code quality   | gemini → qwen  |
-
-## Usage Examples
-
-```bash
-# Daily development update
-/memory:update-related
-
-# After feature work with specific tool
-/memory:update-related --tool qwen
-
-# Code quality review after implementation
-/memory:update-related --tool codex
-```
-
-## Key Advantages
-
-**Efficiency**: 30 modules → 8 agents (73% reduction)
-**Resilience**: 3-tier fallback per module
-**Performance**: Parallel batches, no concurrency limits
-**Context-aware**: Updates based on actual git changes
-**Fast**: Only affected modules, not entire project
-
-## Coordinator Checklist
-
-- Parse `--tool` (default: gemini)
-- Refresh code index for accurate change detection
-- Detect changed modules via detect_changed_modules.sh
-- **Smart filter modules** (auto-detect tech stack, skip tests/build/config/docs)
-- Cache git changes
-- Apply fallback if no changes (recent 10 modules)
-- Construct tool fallback order
-- **Present filtered plan** with skip reasons and change types
-- **Wait for y/n confirmation**
-- Determine execution mode:
-  - **<15 modules**: Direct execution (Phase 3A)
-    - For each depth (N→0): Sequential module updates with tool fallback
-  - **≥15 modules**: Agent batch execution (Phase 3B)
-    - For each depth (N→0): Batch modules (4 per batch), spawn batch workers in parallel
-- Wait for depth/batch completion
-- Aggregate results
-- Safety check (only CLAUDE.md modified)
-- Display git diff statistics + summary
-
-## Comparison with Full Update
-
-| Aspect | Related Update | Full Update |
-|--------|----------------|-------------|
-| **Scope** | Changed modules only | All project modules |
-| **Speed** | Fast (minutes) | Slower (10-30 min) |
-| **Use case** | Daily development | Major refactoring |
-| **Mode** | `"related"` | `"full"` |
-| **Trigger** | After commits | After major changes |
-| **Batching** | 4 modules/agent | 4 modules/agent |
-| **Fallback** | gemini→qwen→codex | gemini→qwen→codex |
-| **Complexity threshold** | ≤15 modules | ≤20 modules |

package/.claude/commands/view.md

@@ -1,367 +0,0 @@
----
-name: ccw view
-description: Dashboard - Open CCW workflow dashboard for managing tasks and sessions
-category: general
----
-
-# CCW View Command
-
-Open the CCW workflow dashboard for visualizing and managing project tasks, sessions, and workflow execution status.
-
-## Description
-
-`ccw view` launches an interactive web dashboard that provides:
-- **Workflow Overview**: Visualize current workflow status and command chain execution
-- **Session Management**: View and manage active workflow sessions
-- **Task Tracking**: Monitor TODO items and task progress
-- **Workspace Switching**: Switch between different project workspaces
-- **Real-time Updates**: Live updates of command execution and status
-
-## Usage
-
-```bash
-# Open dashboard for current workspace
-ccw view
-
-# Specify workspace path
-ccw view --path /path/to/workspace
-
-# Custom port (default: 3456)
-ccw view --port 3000
-
-# Bind to specific host
-ccw view --host 0.0.0.0 --port 3456
-
-# Open without launching browser
-ccw view --no-browser
-
-# Show URL without opening browser
-ccw view --no-browser
-```
-
-## Options
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `--path <path>` | Current directory | Workspace path to display |
-| `--port <port>` | 3456 | Server port for dashboard |
-| `--host <host>` | 127.0.0.1 | Server host/bind address |
-| `--no-browser` | false | Don't launch browser automatically |
-| `-h, --help` | - | Show help message |
-
-## Features
-
-### Dashboard Sections
-
-#### 1. **Workflow Overview**
-- Current workflow status
-- Command chain visualization (with Minimum Execution Units marked)
-- Live progress tracking
-- Error alerts
-
-#### 2. **Session Management**
-- List active sessions by type (workflow, review, tdd)
-- Session details (created time, last activity, session ID)
-- Quick actions (resume, pause, complete)
-- Session logs/history
-
-#### 3. **Task Tracking**
-- TODO list with status indicators
-- Progress percentage
-- Task grouping by workflow stage
-- Quick inline task updates
-
-#### 4. **Workspace Switcher**
-- Browse available workspaces
-- Switch context with one click
-- Recent workspaces list
-
-#### 5. **Command History**
-- Recent commands executed
-- Execution time and status
-- Quick re-run options
-
-### Keyboard Shortcuts
-
-| Shortcut | Action |
-|----------|--------|
-| `R` | Refresh dashboard |
-| `Cmd/Ctrl + J` | Jump to session search |
-| `Cmd/Ctrl + K` | Open command palette |
-| `?` | Show help |
-
-## Multi-Instance Support
-
-The dashboard supports multiple concurrent instances:
-
-```bash
-# Terminal 1: Workspace A on port 3456
-ccw view --path ~/projects/workspace-a
-
-# Terminal 2: Workspace B on port 3457
-ccw view --path ~/projects/workspace-b --port 3457
-
-# Switching workspaces on the same port
-ccw view --path ~/projects/workspace-c  # Auto-switches existing server
-```
-
-When the server is already running and you execute `ccw view` with a different path:
-1. Detects running server on the port
-2. Sends workspace switch request
-3. Updates dashboard to new workspace
-4. Opens browser with updated context
-
-## Server Lifecycle
-
-### Startup
-
-```
-ccw view
-  ├─ Check if server running on port
-  │  ├─ If yes: Send switch-path request
-  │  └─ If no: Start new server
-  ├─ Launch browser (unless --no-browser)
-  └─ Display dashboard URL
-```
-
-### Running
-
-The dashboard server continues running until:
-- User explicitly stops it (Ctrl+C)
-- All connections close after timeout
-- System shutdown
-
-### Multiple Workspaces
-
-Switching to a different workspace keeps the same server instance:
-```
-Server State Before: workspace-a on port 3456
-ccw view --path ~/projects/workspace-b
-Server State After: workspace-b on port 3456 (same instance)
-```
-
-## Environment Variables
-
-```bash
-# Set default port
-export CCW_VIEW_PORT=4000
-ccw view  # Uses port 4000
-
-# Set default host
-export CCW_VIEW_HOST=localhost
-ccw view --port 3456  # Binds to localhost:3456
-
-# Disable browser launch by default
-export CCW_VIEW_NO_BROWSER=true
-ccw view  # Won't auto-launch browser
-```
-
-## Integration with CCW Workflows
-
-The dashboard is fully integrated with CCW commands:
-
-### Viewing Workflow Progress
-
-```bash
-# Start a workflow
-ccw "Add user authentication"
-
-# In another terminal, view progress
-ccw view  # Shows execution progress in real-time
-```
-
-### Session Management from Dashboard
-
-- Start new session: Click "New Session" button
-- Resume paused session: Sessions list → Resume button
-- View session logs: Click session name
-- Complete session: Sessions list → Complete button
-
-### Real-time Command Execution
-
-- View active command chain execution
-- Watch command transition through Minimum Execution Units
-- See error alerts and recovery options
-- View command output logs
-
-## Troubleshooting
-
-### Port Already in Use
-
-```bash
-# Use different port
-ccw view --port 3457
-
-# Or kill existing server
-lsof -i :3456  # Find process
-kill -9 <pid>   # Kill it
-ccw view        # Start fresh
-```
-
-### Dashboard Not Loading
-
-```bash
-# Try without browser
-ccw view --no-browser
-
-# Check server logs
-tail -f ~/.ccw/logs/dashboard.log
-
-# Verify network access
-curl http://localhost:3456/api/health
-```
-
-### Workspace Path Not Found
-
-```bash
-# Use full absolute path
-ccw view --path "$(pwd)"
-
-# Or specify explicit path
-ccw view --path ~/projects/my-project
-```
-
-## Related Commands
-
-- **`/ccw`** - Main workflow orchestrator
-- **`/workflow:session:list`** - List workflow sessions
-- **`/workflow:session:resume`** - Resume paused session
-- **`/memory:compact`** - Compact session memory for dashboard display
-
-## Examples
-
-### Basic Dashboard View
-
-```bash
-cd ~/projects/my-app
-ccw view
-# → Launches http://localhost:3456 in browser
-```
-
-### Network-Accessible Dashboard
-
-```bash
-# Allow remote access
-ccw view --host 0.0.0.0 --port 3000
-# → Dashboard accessible at http://machine-ip:3000
-```
-
-### Multiple Workspaces on Different Ports
-
-```bash
-# Terminal 1: Main project
-ccw view --path ~/projects/main --port 3456
-
-# Terminal 2: Side project
-ccw view --path ~/projects/side --port 3457
-
-# View both simultaneously
-# → http://localhost:3456 (main)
-# → http://localhost:3457 (side)
-```
-
-### Headless Dashboard
-
-```bash
-# Run dashboard without browser
-ccw view --port 3000 --no-browser
-echo "Dashboard available at http://localhost:3000"
-
-# Share URL with team
-# Can be proxied through nginx/port forwarding
-```
-
-### Environment-Based Configuration
-
-```bash
-# Script for CI/CD
-export CCW_VIEW_HOST=0.0.0.0
-export CCW_VIEW_PORT=8080
-ccw view --path /workspace
-
-# → Dashboard accessible on port 8080 to all interfaces
-```
-
-## Dashboard Pages
-
-### Overview Page (`/`)
-- Current workflow status
-- Active sessions summary
-- Recent commands
-- System health indicators
-
-### Sessions Page (`/sessions`)
-- All sessions (grouped by type)
-- Session details and metadata
-- Session logs viewer
-- Quick actions (resume/complete)
-
-### Tasks Page (`/tasks`)
-- Current TODO items
-- Progress tracking
-- Inline task editing
-- Workflow history
-
-### Workspace Page (`/workspace`)
-- Current workspace info
-- Available workspaces
-- Workspace switcher
-- Workspace settings
-
-### Settings Page (`/settings`)
-- Port configuration
-- Theme preferences
-- Auto-refresh settings
-- Export settings
-
-## Server Health Monitoring
-
-The dashboard includes health monitoring:
-
-```bash
-# Check health endpoint
-curl http://localhost:3456/api/health
-# → { "status": "ok", "uptime": 12345 }
-
-# Monitor metrics
-curl http://localhost:3456/api/metrics
-# → { "sessions": 3, "tasks": 15, "lastUpdate": "2025-01-29T10:30:00Z" }
-```
-
-## Advanced Usage
-
-### Custom Port with Dynamic Discovery
-
-```bash
-# Find next available port
-available_port=$(find-available-port 3456)
-ccw view --port $available_port
-
-# Display in CI/CD
-echo "Dashboard: http://localhost:$available_port"
-```
-
-### Dashboard Behind Proxy
-
-```bash
-# Configure nginx reverse proxy
-# Proxy http://proxy.example.com/dashboard → http://localhost:3456
-
-ccw view --host 127.0.0.1 --port 3456
-
-# Access via proxy
-# http://proxy.example.com/dashboard
-```
-
-### Session Export from Dashboard
-
-- View → Sessions → Export JSON
-- Exports session metadata and progress
-- Useful for record-keeping and reporting
-
-## See Also
-
-- **CCW Commands**: `/ccw` - Auto workflow orchestration
-- **Session Management**: `/workflow:session:start`, `/workflow:session:list`
-- **Task Tracking**: `TodoWrite` tool for programmatic task management
-- **Workflow Status**: `/workflow:status` for CLI-based status view