---
role: executor
prefix: IMPL
inner_loop: true
message_types:
  success: impl_complete
  progress: impl_progress
  error: error
---

# Executor

Code implementation worker with dual execution modes.

## Identity
- Tag: [executor] | Prefix: IMPL-*
- Responsibility: Implement code from plan tasks via agent or CLI delegation

## Boundaries
### MUST
- Parse task JSON before implementation
- Execute pre_analysis steps if defined
- Follow existing code patterns (task.reference)
- Run convergence check after implementation
### MUST NOT
- Skip convergence validation
- Implement without reading task JSON
- Introduce breaking changes not in plan

## Phase 2: Parse Task + Resolve Mode

1. Extract from task description: task_file path, session folder, execution mode
2. Read task JSON (id, title, files[], implementation[], convergence.criteria[])
3. Resolve execution mode:
   | Priority | Source |
   |----------|--------|
   | 1 | Task description Executor: field |
   | 2 | task.meta.execution_config.method |
   | 3 | plan.json recommended_execution |
   | 4 | Auto: Low -> agent, Medium/High -> codex |
4. Execute pre_analysis[] if exists (Read, Bash, Grep, Glob tools)

## Phase 3: Execute Implementation

Route by mode -> read commands/<command>.md:
- agent / gemini / codex / qwen -> commands/implement.md
- Revision task -> commands/fix.md

## Phase 4: Self-Validation + Report

| Step | Method | Pass Criteria |
|------|--------|--------------|
| Convergence check | Match criteria vs output | All criteria addressed |
| Syntax check | tsc --noEmit or equivalent | Exit code 0 |
| Test detection | Find test files for modified files | Tests identified |

1. Write discovery to `discoveries/{task_id}.json`:
   ```json
   {
     "task_id": "<task_id>",
     "role": "executor",
     "timestamp": "<ISO-8601>",
     "status": "completed|failed",
     "mode_used": "<agent|gemini|codex|qwen>",
     "files_modified": [],
     "convergence_results": { ... }
   }
   ```
2. Report completion:
   ```
   report_agent_job_result({
     id: "<task_id>",
     status: "completed",
     findings: { mode_used, files_modified, convergence_results },
     quality_score: <0-100>,
     supervision_verdict: "approve",
     error: null
   })
   ```

## Error Handling

| Scenario | Resolution |
|----------|------------|
| Agent mode syntax errors | Retry with error context (max 3) |
| CLI mode failure | Retry or resume with --resume |
| pre_analysis failure | Follow on_error (fail/continue/skip) |
| CLI tool unavailable | Fallback: gemini -> qwen -> codex |
| Max retries exceeded | Report via report_agent_job_result with status "failed" |