claude-code-workflow 6.3.54 → 7.0.0

package/.claude/agents/issue-plan-agent.md

@@ -26,6 +26,10 @@ color: green
 
 ### 1.1 Input Context
 
+**Project Context** (load at startup):
+- Read `.workflow/project-tech.json` (if exists) → tech_stack, architecture
+- Read `.workflow/specs/*.md` (if exists) → constraints, conventions
+
 ```javascript
 {
   issue_ids: string[],    // Issue IDs only (e.g., ["GH-123", "GH-124"])
@@ -226,13 +230,13 @@ function decomposeTasks(issue, exploration) {
     scope: inferScope(group),              // Module path
     action: inferAction(group),            // Create | Update | Implement | ...
     description: group.description,
-    modification_points: mapModificationPoints(group),
+    files: mapFiles(group),                // [{path, target, change, action?, conflict_risk?}]
     implementation: generateSteps(group),  // Step-by-step guide
     test: {
       unit: generateUnitTests(group),
       commands: ['npm test']
     },
-    acceptance: {
+    convergence: {
       criteria: generateCriteria(group),   // Quantified checklist
       verification: generateVerification(group)
     },
@@ -242,7 +246,7 @@ function decomposeTasks(issue, exploration) {
       message_template: generateCommitMsg(group)
     },
     depends_on: inferDependencies(group, tasks),
-    priority: calculatePriority(group)     // 1-5 (1=highest)
+    priority: calculatePriorityEnum(group) // "critical"|"high"|"medium"|"low"
   }));
 
   // GitHub Reply Task: Add final task if issue has github_url
@@ -254,20 +258,20 @@ function decomposeTasks(issue, exploration) {
       scope: 'github',
       action: 'Notify',
       description: `Comment on GitHub issue to report completion status`,
-      modification_points: [],
+      files: [],
       implementation: [
         `Generate completion summary (tasks completed, files changed)`,
         `Post comment via: gh issue comment ${issue.github_number || extractNumber(issue.github_url)} --body "..."`,
         `Include: solution approach, key changes, verification results`
       ],
       test: { unit: [], commands: [] },
-      acceptance: {
+      convergence: {
         criteria: ['GitHub comment posted successfully', 'Comment includes completion summary'],
         verification: ['Check GitHub issue for new comment']
       },
       commit: null,  // No commit for notification task
       depends_on: lastTaskId ? [lastTaskId] : [],  // Depends on last implementation task
-      priority: 5    // Lowest priority (run last)
+      priority: "low"    // Lowest priority (run last)
     });
   }
 
@@ -344,7 +348,7 @@ Write({ file_path: filePath, content: newContent })
 .workflow/issues/solutions/{issue-id}.jsonl
 ```
 
-Each line is a solution JSON containing tasks. Schema: `cat .claude/workflows/cli-templates/schemas/solution-schema.json`
+Each line is a solution JSON containing tasks. Schema: `cat ~/.ccw/workflows/cli-templates/schemas/solution-schema.json`
 
 ### 2.2 Return Summary
 
@@ -370,10 +374,10 @@ Each line is a solution JSON containing tasks. Schema: `cat .claude/workflows/cl
 ### 3.2 Validation Checklist
 
 - [ ] ACE search performed for each issue
-- [ ] All modification_points verified against codebase
+- [ ] All files[] paths verified against codebase
 - [ ] Tasks have 2+ implementation steps
 - [ ] All 5 lifecycle phases present
-- [ ] Quantified acceptance criteria with verification
+- [ ] Quantified convergence criteria with verification
 - [ ] Dependencies form valid DAG
 - [ ] Commit follows conventional commits
 
@@ -384,12 +388,12 @@ Each line is a solution JSON containing tasks. Schema: `cat .claude/workflows/cl
 
 **ALWAYS**:
 1. **Search Tool Priority**: ACE (`mcp__ace-tool__search_context`) → CCW (`mcp__ccw-tools__smart_search`) / Built-in (`Grep`, `Glob`, `Read`)
-2. Read schema first: `cat .claude/workflows/cli-templates/schemas/solution-schema.json`
+2. Read schema first: `cat ~/.ccw/workflows/cli-templates/schemas/solution-schema.json`
 3. Use ACE semantic search as PRIMARY exploration tool
 4. Fetch issue details via `ccw issue status <id> --json`
 5. **Analyze failure history**: Check `issue.feedback` for type='failure', stage='execute'
 6. **For replanning**: Reference previous failures in `solution.approach`, add prevention steps
-7. Quantify acceptance.criteria with testable conditions
+7. Quantify convergence.criteria with testable conditions
 8. Validate DAG before output
 9. Evaluate each solution with `analysis` and `score`
 10. Write solutions to `.workflow/issues/solutions/{issue-id}.jsonl` (append mode)

package/.claude/agents/memory-bridge.md

@@ -42,8 +42,8 @@ TodoWrite([
 # 3. Launch parallel jobs (max 4)
 
 # Depth 5 example (Layer 3 - use multi-layer):
-ccw tool exec update_module_claude '{"strategy":"multi-layer","path":"./.claude/workflows/cli-templates/prompts/analysis","tool":"gemini"}' &
-ccw tool exec update_module_claude '{"strategy":"multi-layer","path":"./.claude/workflows/cli-templates/prompts/development","tool":"gemini"}' &
+ccw tool exec update_module_claude '{"strategy":"multi-layer","path":"./~/.ccw/workflows/cli-templates/prompts/analysis","tool":"gemini"}' &
+ccw tool exec update_module_claude '{"strategy":"multi-layer","path":"./~/.ccw/workflows/cli-templates/prompts/development","tool":"gemini"}' &
 
 # Depth 1 example (Layer 2 - use single-layer):
 ccw tool exec update_module_claude '{"strategy":"single-layer","path":"./src/auth","tool":"gemini"}' &

package/.claude/agents/tdd-developer.md

@@ -36,14 +36,6 @@ You are a TDD-specialized code execution agent focused on implementing high-qual
   "meta": {
     "tdd_workflow": true,              // REQUIRED: Enables TDD mode
     "max_iterations": 3,                // Green phase test-fix cycle limit
-    "cli_execution_id": "{session}-{task}",  // CLI session ID for resume
-    "cli_execution": {                  // CLI execution strategy
-      "strategy": "new|resume|fork|merge_fork",
-      "resume_from": "parent-cli-id"    // For resume/fork strategies; array for merge_fork
-      // Note: For merge_fork, resume_from is array: ["id1", "id2", ...]
-    }
-  },
-  "context": {
     "tdd_cycles": [                     // Test cases and coverage targets
       {
         "test_count": 5,
@@ -51,39 +43,41 @@ You are a TDD-specialized code execution agent focused on implementing high-qual
         "implementation_scope": "...",
         "expected_coverage": ">=85%"
       }
-    ],
-    "focus_paths": [...],               // Absolute or clear relative paths
-    "requirements": [...],
-    "acceptance": [...]                 // Test commands for validation
-  },
-  "flow_control": {
-    "pre_analysis": [...],              // Context gathering steps
-    "implementation_approach": [        // Red-Green-Refactor steps
-      {
-        "step": 1,
-        "title": "Red Phase: Write failing tests",
-        "tdd_phase": "red",             // REQUIRED: Phase identifier
-        "description": "Write 5 test cases: [...]",
-        "modification_points": [...],
-        "command": "..."                // Optional CLI command
-      },
-      {
-        "step": 2,
-        "title": "Green Phase: Implement to pass tests",
-        "tdd_phase": "green",           // Triggers test-fix cycle
-        "description": "Implement N functions...",
-        "modification_points": [...],
-        "command": "..."
-      },
-      {
-        "step": 3,
-        "title": "Refactor Phase: Improve code quality",
-        "tdd_phase": "refactor",
-        "description": "Apply N refactorings...",
-        "modification_points": [...]
-      }
     ]
-  }
+  },
+  "cli_execution": {                    // CLI execution strategy
+    "id": "{session}-{task}",           // CLI session ID for resume
+    "strategy": "new|resume|fork|merge_fork",
+    "resume_from": "parent-cli-id"      // For resume/fork strategies; array for merge_fork
+  },
+  "description": "...",                 // Goal + requirements
+  "focus_paths": [...],                 // Absolute or clear relative paths
+  "convergence": {
+    "criteria": [...]                   // Test commands for validation
+  },
+  "pre_analysis": [...],               // Context gathering steps
+  "implementation": [                   // Red-Green-Refactor steps (polymorphic: string or object)
+    {
+      "step": "1",
+      "description": "Red Phase: Write failing tests - Write 5 test cases: [...]",
+      "tdd_phase": "red",              // REQUIRED: Phase identifier
+      "actions": ["Create test files", "Write test cases"],
+      "test_fix_cycle": null
+    },
+    {
+      "step": "2",
+      "description": "Green Phase: Implement to pass tests - Implement N functions...",
+      "tdd_phase": "green",            // Triggers test-fix cycle
+      "actions": ["Implement functions", "Pass tests"],
+      "test_fix_cycle": { "max_iterations": 3 }
+    },
+    {
+      "step": "3",
+      "description": "Refactor Phase: Improve code quality - Apply N refactorings...",
+      "tdd_phase": "refactor",
+      "actions": ["Refactor code", "Verify no regressions"]
+    }
+  ]
 }
 ```
 
@@ -106,16 +100,16 @@ ELSE:
 // Extract TDD configuration
 const tddConfig = {
   maxIterations: taskJson.meta.max_iterations || 3,
-  cliExecutionId: taskJson.meta.cli_execution_id,
-  cliStrategy: taskJson.meta.cli_execution?.strategy,
-  resumeFrom: taskJson.meta.cli_execution?.resume_from,
-  testCycles: taskJson.context.tdd_cycles || [],
-  acceptanceTests: taskJson.context.acceptance || []
+  cliExecutionId: taskJson.cli_execution?.id,
+  cliStrategy: taskJson.cli_execution?.strategy,
+  resumeFrom: taskJson.cli_execution?.resume_from,
+  testCycles: taskJson.meta.tdd_cycles || [],
+  acceptanceTests: taskJson.convergence?.criteria || []
 }
 
-// Identify phases
-const phases = taskJson.flow_control.implementation_approach
-  .filter(step => step.tdd_phase)
+// Identify phases (implementation[] supports polymorphic: string or object)
+const phases = taskJson.implementation
+  .filter(step => typeof step === 'object' && step.tdd_phase)
   .map(step => ({
     step: step.step,
     phase: step.tdd_phase,  // "red", "green", or "refactor"
@@ -127,10 +121,10 @@ const phases = taskJson.flow_control.implementation_approach
 ```
 REQUIRED CHECKS:
 - [ ] meta.tdd_workflow is true
-- [ ] flow_control.implementation_approach has exactly 3 steps
-- [ ] Each step has tdd_phase field ("red", "green", "refactor")
-- [ ] context.acceptance includes test command
-- [ ] Green phase has modification_points or command
+- [ ] implementation[] has exactly 3 object entries with tdd_phase
+- [ ] Each entry has tdd_phase field ("red", "green", "refactor")
+- [ ] convergence.criteria includes test command
+- [ ] Green phase has actions or description
 
 IF validation fails:
   → Report invalid TDD task structure
@@ -154,17 +148,21 @@ STEP 1: Parse Red Phase Requirements
   → Load existing test patterns from focus_paths
 
 STEP 2: Execute Red Phase Implementation
-  IF step.command exists:
-    → Execute CLI command with session resume
-    → Build CLI command: ccw cli -p "..." --resume {resume_from} --tool {tool} --mode write
+  const executionMethod = task.meta?.execution_config?.method || 'agent';
+
+  IF executionMethod === 'cli':
+    // CLI Handoff: Full context passed via buildCliHandoffPrompt
+    → const cliPrompt = buildCliHandoffPrompt(preAnalysisResults, task, taskJsonPath)
+    → const cliCommand = buildCliCommand(task, cliTool, cliPrompt)
+    → Bash({ command: cliCommand, run_in_background: false, timeout: 3600000 })
   ELSE:
-    → Direct agent implementation
+    // Execute directly
     → Create test files in modification_points
     → Write test cases following test_cases enumeration
-    → Use context.shared_context.conventions for test style
+    → Use shared_context.conventions (from plan.json) for test style
 
 STEP 3: Validate Red Phase (Test Must Fail)
-  → Execute test command from context.acceptance
+  → Execute test command from convergence.criteria
   → Parse test output
   IF tests pass:
     ⚠️ WARNING: Tests passing in Red phase - may not test real behavior
@@ -195,11 +193,16 @@ STEP 1: Parse Green Phase Requirements
   → Set max_iterations from meta.max_iterations (default: 3)
 
 STEP 2: Initial Implementation
-  IF step.command exists:
-    → Execute CLI command with session resume
-    → Build CLI command: ccw cli -p "..." --resume {resume_from} --tool {tool} --mode write
+  const executionMethod = task.meta?.execution_config?.method || 'agent';
+
+  IF executionMethod === 'cli':
+    // CLI Handoff: Full context passed via buildCliHandoffPrompt
+    → const cliPrompt = buildCliHandoffPrompt(preAnalysisResults, task, taskJsonPath)
+    → const cliCommand = buildCliCommand(task, cliTool, cliPrompt)
+    → Bash({ command: cliCommand, run_in_background: false, timeout: 3600000 })
+
   ELSE:
-    → Direct agent implementation
+    // Execute implementation steps directly
     → Implement functions in modification_points
     → Follow logic_flow sequence
     → Use minimal code to pass tests (no over-engineering)
@@ -208,7 +211,7 @@ STEP 3: Test-Fix Cycle (CRITICAL TDD FEATURE)
   FOR iteration in 1..meta.max_iterations:
 
     STEP 3.1: Run Test Suite
-      → Execute test command from context.acceptance
+      → Execute test command from convergence.criteria
       → Capture test output (stdout + stderr)
       → Parse test results (pass count, fail count, coverage)
 
@@ -293,10 +296,15 @@ STEP 1: Parse Refactor Phase Requirements
   → Load refactoring scope from modification_points
 
 STEP 2: Execute Refactor Implementation
-  IF step.command exists:
-    → Execute CLI command with session resume
+  const executionMethod = task.meta?.execution_config?.method || 'agent';
+
+  IF executionMethod === 'cli':
+    // CLI Handoff: Full context passed via buildCliHandoffPrompt
+    → const cliPrompt = buildCliHandoffPrompt(preAnalysisResults, task, taskJsonPath)
+    → const cliCommand = buildCliCommand(task, cliTool, cliPrompt)
+    → Bash({ command: cliCommand, run_in_background: false, timeout: 3600000 })
   ELSE:
-    → Direct agent refactoring
+    // Execute directly
     → Apply refactorings from logic_flow
     → Follow refactoring best practices:
       • Extract functions for clarity
@@ -306,7 +314,7 @@ STEP 2: Execute Refactor Implementation
       • Add documentation where needed
 
 STEP 3: Regression Testing (REQUIRED)
-  → Execute test command from context.acceptance
+  → Execute test command from convergence.criteria
   → Verify all tests still pass
   IF tests fail:
     ⚠️ REGRESSION DETECTED: Refactoring broke tests
@@ -326,47 +334,15 @@ STEP 3: Regression Testing (REQUIRED)
 
 ### 3. CLI Execution Integration
 
-**CLI Session Resumption** (when step.command exists):
-
-**Build CLI Command with Resume Strategy**:
-```javascript
-function buildCliCommand(step, tddConfig) {
-  const baseCommand = step.command  // From task JSON
-
-  // Parse cli_execution strategy
-  switch (tddConfig.cliStrategy) {
-    case "new":
-      // First task - start fresh conversation
-      return `ccw cli -p "${baseCommand}" --tool ${tool} --mode write --id ${tddConfig.cliExecutionId}`
-
-    case "resume":
-      // Single child - continue same conversation
-      return `ccw cli -p "${baseCommand}" --resume ${tddConfig.resumeFrom} --tool ${tool} --mode write`
-
-    case "fork":
-      // Multiple children - branch with parent context
-      return `ccw cli -p "${baseCommand}" --resume ${tddConfig.resumeFrom} --id ${tddConfig.cliExecutionId} --tool ${tool} --mode write`
-
-    case "merge_fork":
-      // Multiple parents - merge contexts
-      // resume_from is an array for merge_fork strategy
-      const mergeIds = Array.isArray(tddConfig.resumeFrom)
-        ? tddConfig.resumeFrom.join(',')
-        : tddConfig.resumeFrom
-      return `ccw cli -p "${baseCommand}" --resume ${mergeIds} --id ${tddConfig.cliExecutionId} --tool ${tool} --mode write`
-
-    default:
-      // Fallback - no resume
-      return `ccw cli -p "${baseCommand}" --tool ${tool} --mode write`
-  }
-}
-```
+**CLI Functions** (inherited from code-developer):
+- `buildCliHandoffPrompt(preAnalysisResults, task, taskJsonPath)` - Assembles CLI prompt with full context
+- `buildCliCommand(task, cliTool, cliPrompt)` - Builds CLI command with resume strategy
 
 **Execute CLI Command**:
 ```javascript
 // TDD agent runs in foreground - can receive hook callbacks
 Bash(
-  command=buildCliCommand(step, tddConfig),
+  command=buildCliCommand(task, cliTool, cliPrompt),
   timeout=3600000,  // 60 min for CLI execution
   run_in_background=false  // Agent can receive task completion hooks
 )
@@ -375,13 +351,14 @@ Bash(
 ### 4. Context Loading (Inherited from code-developer)
 
 **Standard Context Sources**:
-- Task JSON: `context.requirements`, `context.acceptance`, `context.focus_paths`
+- Task JSON: `description`, `convergence.criteria`, `focus_paths`
 - Context Package: `context_package_path` → brainstorm artifacts, exploration results
-- Tech Stack: `context.shared_context.tech_stack` (skip auto-detection if present)
+- Tech Stack: `meta.shared_context.tech_stack` (skip auto-detection if present)
 
 **TDD-Enhanced Context**:
-- `context.tdd_cycles`: Test case enumeration and coverage targets
+- `meta.tdd_cycles`: Test case enumeration and coverage targets
 - `meta.max_iterations`: Test-fix cycle configuration
+- `implementation[]`: Red-Green-Refactor steps with `tdd_phase` markers
 - Exploration results: `context_package.exploration_results` for critical_files and integration_points
 
 ### 5. Quality Gates (TDD-Enhanced)
@@ -504,7 +481,7 @@ Before completing any TDD task, verify:
 - Use test-fix cycle in Green phase
 - Auto-revert on max iterations failure
 - Generate TDD-enhanced summaries
-- Use CLI resume strategies when step.command exists
+- Use CLI resume strategies when meta.execution_config.method is "cli"
 - Log all test-fix iterations to .process/
 
 **Bash Tool (CLI Execution in TDD Agent)**: