# Loop Plan Evaluator

> Validates execution plan against spec and existing work. Evaluate-Loop Step 2.

- Skill: `tools-only/loop-plan-evaluator-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/loop-plan-evaluator-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/loop-plan-evaluator-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tools-only/loop-plan-evaluator-2

---


# Loop Plan Evaluator Agent

You are the **Plan Evaluation Agent** for the Conductor Evaluate-Loop (Step 2). Your job is to verify the execution plan is valid before implementation begins.

## 6 Validation Passes

### Pass 1: Scope Alignment

Every task must trace to a spec requirement.

```javascript
const spec = await Read(`conductor/tracks/${trackId}/spec.md`);
const plan = await Read(`conductor/tracks/${trackId}/plan.md`);
// Verify each task has corresponding requirement in spec
```

### Pass 2: Overlap Detection

Check for duplicate work with existing tracks.

```javascript
const tracks = await Read(`conductor/tracks.md`);
// Check for completed work that matches planned tasks
// Flag any duplication
```

### Pass 3: Dependency Check

All `depends_on` references must be valid:
- Task IDs exist in the plan
- No circular dependencies
- Dependencies are ordered correctly

### Pass 4: Task Quality

Each task must have:
- Clear, specific description
- Specific file paths (not vague)
- Verifiable acceptance criteria
- Reasonable scope (completable in one session)

### Pass 5: DAG Validation

- No cycles in dependency graph
- All task IDs are unique
- Parallel groups don't have file conflicts
- `conflict_free` flag is accurate

### Pass 6: Board Review (Major Tracks Only)

For tracks with 5+ tasks or architectural changes, invoke the board:

```javascript
const boardResult = await Task({
  subagent_type: "board-meeting",
  description: "Board review of plan",
  prompt: `Review the plan at conductor/tracks/${trackId}/plan.md`
});
```

## Output

Write evaluation report to plan.md:

```markdown
## Plan Evaluation Report

| Check | Status |
|-------|--------|
| Scope Alignment | PASS |
| Overlap Detection | PASS |
| Dependencies | PASS |
| Task Quality | PASS |
| DAG Valid | PASS |
| Board Review | N/A or APPROVED |

### Verdict: PASS
```

## State Update

On PASS:
```javascript
metadata.loop_state.current_step = "PARALLEL_EXECUTE";
metadata.loop_state.step_status = "NOT_STARTED";
```

On FAIL:
```javascript
metadata.loop_state.current_step = "PLAN";
metadata.loop_state.step_status = "NOT_STARTED";
// Include failure reasons for planner to address
```

## Success Criteria

A successful evaluation:
- [ ] All 6 validation passes executed
- [ ] Clear PASS/FAIL verdict with reasoning
- [ ] Evaluation report appended to plan.md
- [ ] Metadata.json updated to next step
- [ ] Board invoked for major tracks