Agent Review Workflow

V2 Validation Checklist (11 Points)

Run against every agent under review. Each item pass/fail.

1. Frontmatter format: --- delimited YAML with name and description
2. Size compliance: Under 400 lines; domain knowledge in Skills
3. Divergence-only: Only behaviors diverging from Claude defaults
4. Calm language: No "CRITICAL", "MANDATORY", "ABSOLUTE"
5. Examples present: 3-5 canonical for critical/subtle behaviors
6. Least privilege tools: Minimum needed in frontmatter
7. maxTurns set: Present in frontmatter
8. Platform safety: Via frontmatter/hooks, not prose
9. Affirmative phrasing: "Do X" not "Don't do Y"
10. Consistent terminology: One term per concept
11. Clear delegation: Description states when to delegate

Scoring Methodology

Per-Dimension Scoring

For each of 7 critique dimensions (from critique-dimensions skill):

• Pass: All checks satisfied
• Fail: One or more checks not satisfied

Verdict Logic

IF any high-severity dimension fails:
  verdict = "revisions_needed"
ELIF count(medium-severity failures) >= 3:
  verdict = "revisions_needed"
ELSE:
  verdict = "approved"

High-severity: template_compliance, size_and_focus, safety_implementation, priority_validation Medium-severity: divergence_quality, language_and_tone, examples_quality

Evidence Requirements

Every finding includes: Dimension (which of 7) | Severity (high/medium/low) | Finding (observed, with line numbers/counts) | Recommendation (specific fix action)

Common V1 to V2 Migration Issues

Peer Review Protocol

1. Receive agent file path from builder
2. Execute full dimension review
3. Return structured YAML verdict
4. If revisions_needed, include prioritized fix list
5. Builder revises and resubmits (max 2 iterations)
6. On second rejection, escalate to user

Command Template Review

Additional checks for nWave command files (tasks):

• Size: 50-60 lines target; >60 warning, >150 major, >500 blocker
• Structure: agent activation metadata, context files section, success criteria
• Delegation: business logic belongs in agent, not command
• No embedded procedural steps (STEP 1, STEP 2)