claude-code-workflow 6.3.37 → 6.3.39

package/.codex/skills/ccw-loop/phases/actions/action-develop.md

@@ -0,0 +1,183 @@
+# Action: DEVELOP
+
+Execute development task and record progress to develop.md.
+
+## Purpose
+
+- Execute next pending development task
+- Implement code changes
+- Record progress to Markdown file
+- Update task status in state
+
+## Preconditions
+
+- [ ] state.status === 'running'
+- [ ] state.skill_state !== null
+- [ ] state.skill_state.develop.tasks.some(t => t.status === 'pending')
+
+## Execution Steps
+
+### Step 1: Verify Control Signals
+
+```javascript
+const state = JSON.parse(Read(`.workflow/.loop/${loopId}.json`))
+
+if (state.status !== 'running') {
+  return {
+    action: 'DEVELOP',
+    status: 'failed',
+    message: `Cannot develop: status is ${state.status}`,
+    next_action: state.status === 'paused' ? 'PAUSED' : 'STOPPED'
+  }
+}
+```
+
+### Step 2: Find Next Pending Task
+
+```javascript
+const tasks = state.skill_state.develop.tasks
+const currentTask = tasks.find(t => t.status === 'pending')
+
+if (!currentTask) {
+  return {
+    action: 'DEVELOP',
+    status: 'success',
+    message: 'All development tasks completed',
+    next_action: mode === 'auto' ? 'VALIDATE' : 'MENU'
+  }
+}
+
+// Mark as in_progress
+currentTask.status = 'in_progress'
+```
+
+### Step 3: Execute Development Task
+
+```javascript
+console.log(`Executing task: ${currentTask.description}`)
+
+// Use appropriate tools based on task type
+// - ACE search_context for finding patterns
+// - Read for loading files
+// - Edit/Write for making changes
+
+// Record files changed
+const filesChanged = []
+
+// Implementation logic...
+```
+
+### Step 4: Record Changes to Log (NDJSON)
+
+```javascript
+const changesLogPath = `${progressDir}/changes.log`
+const timestamp = getUtc8ISOString()
+
+const changeEntry = {
+  timestamp: timestamp,
+  task_id: currentTask.id,
+  description: currentTask.description,
+  files_changed: filesChanged,
+  result: 'success'
+}
+
+// Append to NDJSON log
+const existingLog = Read(changesLogPath) || ''
+Write(changesLogPath, existingLog + JSON.stringify(changeEntry) + '\n')
+```
+
+### Step 5: Update Progress Document
+
+```javascript
+const progressPath = `${progressDir}/develop.md`
+const iteration = state.skill_state.develop.completed + 1
+
+const progressEntry = `
+### Iteration ${iteration} - ${currentTask.description} (${timestamp})
+
+#### Task Details
+
+- **ID**: ${currentTask.id}
+- **Tool**: ${currentTask.tool}
+- **Mode**: ${currentTask.mode}
+
+#### Implementation Summary
+
+[Implementation description]
+
+#### Files Changed
+
+${filesChanged.map(f => `- \`${f}\``).join('\n') || '- No files changed'}
+
+#### Status: COMPLETED
+
+---
+
+`
+
+const existingProgress = Read(progressPath)
+Write(progressPath, existingProgress + progressEntry)
+```
+
+### Step 6: Update State
+
+```javascript
+currentTask.status = 'completed'
+currentTask.completed_at = timestamp
+currentTask.files_changed = filesChanged
+
+state.skill_state.develop.completed += 1
+state.skill_state.develop.current_task = null
+state.skill_state.develop.last_progress_at = timestamp
+state.skill_state.last_action = 'DEVELOP'
+state.skill_state.completed_actions.push('DEVELOP')
+state.updated_at = timestamp
+
+Write(`.workflow/.loop/${loopId}.json`, JSON.stringify(state, null, 2))
+```
+
+## Output Format
+
+```
+ACTION_RESULT:
+- action: DEVELOP
+- status: success
+- message: Task completed: {task_description}
+- state_updates: {
+    "develop.completed": {N},
+    "develop.last_progress_at": "{timestamp}"
+  }
+
+FILES_UPDATED:
+- .workflow/.loop/{loopId}.json: Task status updated
+- .workflow/.loop/{loopId}.progress/develop.md: Progress entry added
+- .workflow/.loop/{loopId}.progress/changes.log: Change entry added
+
+NEXT_ACTION_NEEDED: {DEVELOP | DEBUG | VALIDATE | MENU}
+```
+
+## Auto Mode Next Action Selection
+
+```javascript
+const pendingTasks = tasks.filter(t => t.status === 'pending')
+
+if (pendingTasks.length > 0) {
+  return 'DEVELOP'  // More tasks to do
+} else {
+  return 'DEBUG'    // All done, check for issues
+}
+```
+
+## Error Handling
+
+| Error Type | Recovery |
+|------------|----------|
+| Task execution failed | Mark task as failed, continue to next |
+| File write failed | Retry once, then report error |
+| All tasks done | Move to DEBUG or VALIDATE |
+
+## Next Actions
+
+- More pending tasks: `DEVELOP`
+- All tasks complete: `DEBUG` (auto) or `MENU` (interactive)
+- Task failed: `DEVELOP` (retry) or `DEBUG` (investigate)

package/.codex/skills/ccw-loop/phases/actions/action-init.md

@@ -0,0 +1,164 @@
+# Action: INIT
+
+Initialize CCW Loop session, create directory structure and initial state.
+
+## Purpose
+
+- Create session directory structure
+- Initialize state file with skill_state
+- Analyze task description to generate development tasks
+- Prepare execution environment
+
+## Preconditions
+
+- [ ] state.status === 'running'
+- [ ] state.skill_state === null
+
+## Execution Steps
+
+### Step 1: Verify Control Signals
+
+```javascript
+const state = JSON.parse(Read(`.workflow/.loop/${loopId}.json`))
+
+if (state.status !== 'running') {
+  return {
+    action: 'INIT',
+    status: 'failed',
+    message: `Cannot init: status is ${state.status}`,
+    next_action: state.status === 'paused' ? 'PAUSED' : 'STOPPED'
+  }
+}
+```
+
+### Step 2: Create Directory Structure
+
+```javascript
+const progressDir = `.workflow/.loop/${loopId}.progress`
+
+// Directories created by orchestrator, verify they exist
+// mkdir -p ${progressDir}
+```
+
+### Step 3: Analyze Task and Generate Tasks
+
+```javascript
+// Analyze task description
+const taskDescription = state.description
+
+// Generate 3-7 development tasks based on analysis
+// Use ACE search or smart_search to find relevant patterns
+
+const tasks = [
+  {
+    id: 'task-001',
+    description: 'Task description based on analysis',
+    tool: 'gemini',
+    mode: 'write',
+    status: 'pending',
+    priority: 1,
+    files: [],
+    created_at: getUtc8ISOString(),
+    completed_at: null
+  }
+  // ... more tasks
+]
+```
+
+### Step 4: Initialize Progress Document
+
+```javascript
+const progressPath = `${progressDir}/develop.md`
+
+const progressInitial = `# Development Progress
+
+**Loop ID**: ${loopId}
+**Task**: ${taskDescription}
+**Started**: ${getUtc8ISOString()}
+
+---
+
+## Task List
+
+${tasks.map((t, i) => `${i + 1}. [ ] ${t.description}`).join('\n')}
+
+---
+
+## Progress Timeline
+
+`
+
+Write(progressPath, progressInitial)
+```
+
+### Step 5: Update State
+
+```javascript
+const skillState = {
+  current_action: 'init',
+  last_action: null,
+  completed_actions: [],
+  mode: mode,
+
+  develop: {
+    total: tasks.length,
+    completed: 0,
+    current_task: null,
+    tasks: tasks,
+    last_progress_at: null
+  },
+
+  debug: {
+    active_bug: null,
+    hypotheses_count: 0,
+    hypotheses: [],
+    confirmed_hypothesis: null,
+    iteration: 0,
+    last_analysis_at: null
+  },
+
+  validate: {
+    pass_rate: 0,
+    coverage: 0,
+    test_results: [],
+    passed: false,
+    failed_tests: [],
+    last_run_at: null
+  },
+
+  errors: []
+}
+
+state.skill_state = skillState
+state.updated_at = getUtc8ISOString()
+Write(`.workflow/.loop/${loopId}.json`, JSON.stringify(state, null, 2))
+```
+
+## Output Format
+
+```
+ACTION_RESULT:
+- action: INIT
+- status: success
+- message: Session initialized with {N} development tasks
+
+FILES_UPDATED:
+- .workflow/.loop/{loopId}.json: skill_state initialized
+- .workflow/.loop/{loopId}.progress/develop.md: Progress document created
+
+NEXT_ACTION_NEEDED: {DEVELOP (auto) | MENU (interactive)}
+```
+
+## Error Handling
+
+| Error Type | Recovery |
+|------------|----------|
+| Directory creation failed | Report error, stop |
+| Task analysis failed | Create single generic task |
+| State write failed | Retry once, then stop |
+
+## Next Actions
+
+- Success (auto mode): `DEVELOP`
+- Success (interactive): `MENU`
+- Failed: Report error

package/.codex/skills/ccw-loop/phases/actions/action-menu.md

@@ -0,0 +1,205 @@
+# Action: MENU
+
+Display interactive action menu for user selection.
+
+## Purpose
+
+- Show current state summary
+- Display available actions
+- Wait for user selection
+- Return selected action
+
+## Preconditions
+
+- [ ] state.status === 'running'
+- [ ] state.skill_state !== null
+- [ ] mode === 'interactive'
+
+## Execution Steps
+
+### Step 1: Verify Control Signals
+
+```javascript
+const state = JSON.parse(Read(`.workflow/.loop/${loopId}.json`))
+
+if (state.status !== 'running') {
+  return {
+    action: 'MENU',
+    status: 'failed',
+    message: `Cannot show menu: status is ${state.status}`,
+    next_action: state.status === 'paused' ? 'PAUSED' : 'STOPPED'
+  }
+}
+```
+
+### Step 2: Generate Status Summary
+
+```javascript
+// Development progress
+const developProgress = state.skill_state.develop.total > 0
+  ? `${state.skill_state.develop.completed}/${state.skill_state.develop.total} (${((state.skill_state.develop.completed / state.skill_state.develop.total) * 100).toFixed(0)}%)`
+  : 'Not started'
+
+// Debug status
+const debugStatus = state.skill_state.debug.confirmed_hypothesis
+  ? 'Root cause found'
+  : state.skill_state.debug.iteration > 0
+    ? `Iteration ${state.skill_state.debug.iteration}`
+    : 'Not started'
+
+// Validation status
+const validateStatus = state.skill_state.validate.passed
+  ? 'PASSED'
+  : state.skill_state.validate.test_results.length > 0
+    ? `FAILED (${state.skill_state.validate.failed_tests.length} failures)`
+    : 'Not run'
+```
+
+### Step 3: Display Menu
+
+```javascript
+const menuDisplay = `
+================================================================
+  CCW Loop - ${loopId}
+================================================================
+
+  Task: ${state.description}
+  Iteration: ${state.current_iteration}
+
+  +-----------------------------------------------------+
+  |  Phase          |  Status                           |
+  +-----------------------------------------------------+
+  |  Develop        |  ${developProgress.padEnd(35)}|
+  |  Debug          |  ${debugStatus.padEnd(35)}|
+  |  Validate       |  ${validateStatus.padEnd(35)}|
+  +-----------------------------------------------------+
+
+================================================================
+
+MENU_OPTIONS:
+1. [develop] Continue Development - ${state.skill_state.develop.total - state.skill_state.develop.completed} tasks pending
+2. [debug] Start Debugging - ${debugStatus}
+3. [validate] Run Validation - ${validateStatus}
+4. [status] View Detailed Status
+5. [complete] Complete Loop
+6. [exit] Exit (save and quit)
+`
+
+console.log(menuDisplay)
+```
+
+## Output Format
+
+```
+ACTION_RESULT:
+- action: MENU
+- status: success
+- message: ${menuDisplay}
+
+MENU_OPTIONS:
+1. [develop] Continue Development - {N} tasks pending
+2. [debug] Start Debugging - {status}
+3. [validate] Run Validation - {status}
+4. [status] View Detailed Status
+5. [complete] Complete Loop
+6. [exit] Exit (save and quit)
+
+NEXT_ACTION_NEEDED: WAITING_INPUT
+```
+
+## User Input Handling
+
+When user provides input, orchestrator sends it back via `send_input`:
+
+```javascript
+// User selects "develop"
+send_input({
+  id: agent,
+  message: `
+## USER INPUT RECEIVED
+
+Action selected: develop
+
+## EXECUTE SELECTED ACTION
+
+Execute DEVELOP action.
+`
+})
+```
+
+## Status Detail View
+
+If user selects "status":
+
+```javascript
+const detailView = `
+## Detailed Status
+
+### Development Progress
+
+${Read(`${progressDir}/develop.md`)?.substring(0, 1000) || 'No progress recorded'}
+
+### Debug Status
+
+${state.skill_state.debug.hypotheses.length > 0
+  ? state.skill_state.debug.hypotheses.map(h => `  ${h.id}: ${h.status} - ${h.description.substring(0, 50)}...`).join('\n')
+  : '  No debugging started'}
+
+### Validation Results
+
+${state.skill_state.validate.test_results.length > 0
+  ? `  Last run: ${state.skill_state.validate.last_run_at}
+  Pass rate: ${state.skill_state.validate.pass_rate}%`
+  : '  No validation run yet'}
+`
+
+console.log(detailView)
+
+// Return to menu
+return {
+  action: 'MENU',
+  status: 'success',
+  message: detailView,
+  next_action: 'MENU'  // Show menu again
+}
+```
+
+## Exit Handling
+
+If user selects "exit":
+
+```javascript
+// Save current state
+state.status = 'user_exit'
+state.updated_at = getUtc8ISOString()
+Write(`.workflow/.loop/${loopId}.json`, JSON.stringify(state, null, 2))
+
+return {
+  action: 'MENU',
+  status: 'success',
+  message: 'Session saved. Use --loop-id to resume.',
+  next_action: 'COMPLETED'
+}
+```
+
+## Action Mapping
+
+| User Selection | Next Action |
+|----------------|-------------|
+| develop | DEVELOP |
+| debug | DEBUG |
+| validate | VALIDATE |
+| status | MENU (after showing details) |
+| complete | COMPLETE |
+| exit | COMPLETED (save and exit) |
+
+## Error Handling
+
+| Error Type | Recovery |
+|------------|----------|
+| Invalid selection | Show menu again |
+| User cancels | Return to menu |
+
+## Next Actions
+
+Based on user selection - forwarded via `send_input` by orchestrator.