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

---
description: Execute tasks sequentially from plan.json file
argument-hint: 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

```bash
cat $FILE
```

Parse JSON, extract:
- `summary`: Overall goal
- `tasks[]`: Task list with status

### Step 2: Find Next Task

```javascript
// 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:

```markdown
## 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:
```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

```json
{
  "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:

```markdown
## 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 |