external-agents

External CLI Reviewers/Agents (Codex / Gemini)

Use Codex and Gemini CLIs as external reviewers for gated review chunks. They read prompt files and write reports.

When to Use

• Before major implementation: Get external review of spec changes, architecture decisions
• After spec updates: Validate changes before implementing code
• Gated review chunks: When plan specifies external review gate
• Second opinion: When uncertain about approach

Codex (Preferred - more reliable)

codex exec --dangerously-bypass-approvals-and-sandbox "Read prompts/task.md and write report to reports/task-report.md"

• --dangerously-bypass-approvals-and-sandbox enables writes (required)
• Codex correctly interprets and executes instructions
• Use for: code review, spec validation, architecture critique

Gemini (Secondary - less reliable for execution)

gemini --yolo "Read prompts/task.md and write report to reports/task-report.md"

• --yolo auto-approves all actions
• May copy files instead of executing instructions - verify output
• Use for: second opinion after Codex, simple reviews

Workflow Pattern

1. Write prompt to prompts/review-task.md with clear instructions
2. Run Codex (primary): codex exec --dangerously-bypass-approvals-and-sandbox "Read prompts/review-task.md and write report to reports/codex-task-report.md"
3. Optionally run Gemini: gemini --yolo "Read prompts/review-task.md and write report to reports/gemini-task-report.md"
4. Check reports/ for outputs
5. Gate: If issues found, iterate before proceeding

Prompt Template

# Review Task: [Title]

## Context
[What's being reviewed and why]

## Files to Review
- `path/to/file1.md`
- `path/to/file2.yml`

## Questions to Answer
1. [Specific question]
2. [Specific question]

## Output
Write your review to `reports/[name]-report.md` with:
- Summary of findings
- Issues identified (if any)
- Recommendations