Claude-Code-Workflow/.codex/prompts/lite-execute.md

description, argument-hint

description	argument-hint
Execute tasks sequentially from plan.json file	FILE=<path>

Workflow Lite-Execute (Codex Version)

Core Principle

Serial Execution: Execute tasks ONE BY ONE in order. Complete current task fully before moving to next. Continue until ALL tasks complete.

Input

Read plan file at $FILE path (e.g., .workflow/.lite-plan/session-id/plan.json)

Autonomous Execution Loop

WHILE tasks remain:
  1. Read plan.json → Get task list
  2. Find FIRST task with status != "completed"
  3. IF task.depends_on exists:
     - Check all dependencies completed
     - IF not met → Skip, find next eligible task
  4. Execute current task fully
  5. Mark task completed in plan.json
  6. Output progress: "[X/N] Task completed: {title}"
  7. CONTINUE to next task (DO NOT STOP)

WHEN all tasks completed:
  Output final summary

Step-by-Step Execution

Step 1: Load Plan

cat $FILE

Parse JSON, extract:

• summary: Overall goal
• tasks[]: Task list with status

Step 2: Find Next Task

// Find first non-completed task with met dependencies
for (task of tasks) {
  if (task.status === "completed") continue
  if (task.depends_on?.every(dep => getTask(dep).status === "completed")) {
    return task  // Execute this one
  }
}
return null  // All done

Step 3: Execute Task

For current task, perform:

## Executing: [task.title]

**Scope**: `[task.scope]` (module/feature level)
**Action**: [task.action]

### Modification Points
For each point in task.modification_points:
- **File**: [point.file]
- **Target**: [point.target] (function/class/line range)
- **Change**: [point.change]

### Implementation
[Follow task.implementation steps]

### Reference Pattern
- Pattern: [task.reference.pattern]
- Files: [task.reference.files]
- Examples: [task.reference.examples]

### Acceptance Criteria
- [ ] [criterion 1]
- [ ] [criterion 2]

Execute all modification points. Verify all acceptance criteria.

Step 4: Mark Completed

Update task status in plan.json:

{
  "id": "task-id",
  "status": "completed"  // Change from "pending"
}

Step 5: Continue

DO NOT STOP. Immediately proceed to Step 2 to find next task.

Output progress:

✓ [2/5] Completed: [task.title]
→ Next: [next_task.title]

Task Format Reference

{
  "id": "T1",
  "title": "Implement auth validation",
  "scope": "src/auth/",
  "action": "Create|Update|Implement|Refactor|Add|Delete|Configure|Test|Fix",
  "description": "What to implement (1-2 sentences)",
  "modification_points": [
    {
      "file": "src/auth/validator.ts",
      "target": "validateToken:45-60",
      "change": "Add expiry check"
    },
    {
      "file": "src/auth/middleware.ts",
      "target": "authMiddleware",
      "change": "Call new validator"
    }
  ],
  "implementation": ["step 1", "step 2", "...max 7 steps"],
  "reference": {
    "pattern": "pattern name",
    "files": ["example1.ts"],
    "examples": "specific guidance"
  },
  "acceptance": ["criterion 1", "criterion 2"],
  "depends_on": ["T0"],
  "status": "pending|completed"
}

Key Fields:

• scope: Module/feature level path (prefer over single file)
• modification_points[]: All files to modify with precise targets
• target: Function/class/line range (e.g., validateToken:45-60)

Execution Rules

1. Never stop mid-workflow - Continue until all tasks complete
2. One task at a time - Fully complete before moving on
3. Respect dependencies - Skip blocked tasks, return later
4. Update status immediately - Mark completed right after finishing
5. Self-verify - Check acceptance criteria before marking done

Final Summary

When ALL tasks completed:

## Execution Complete

**Plan**: $FILE
**Total Tasks**: N
**All Completed**: Yes

### Results
| # | Task | Status |
|---|------|--------|
| 1 | [title] | ✓ |
| 2 | [title] | ✓ |

### Files Modified
- `path/file1.ts`
- `path/file2.ts`

### Summary
[Brief description of what was accomplished]

Error Handling

Situation	Action
File not found	Error and stop
Task blocked (deps not met)	Skip, try next task
All remaining tasks blocked	Report circular dependency
Task execution error	Report error, mark failed, continue to next
Acceptance criteria not met	Retry or report, then continue