# Darwin Code Review

> Code and MR/PR review workflow for plan mode. Use when reviewing merge requests, pull requests, or code changes. Use when this capability is needed.

- Skill: `tomevault-io/darwin-code-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/darwin-code-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/darwin-code-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/darwin-code-review

---


# Darwin Code Review Workflow

## When to Use

You are in review mode. The Brain wants a code review, NOT an implementation plan. Do NOT produce a plan or write code.

## Review Process

1. **Fetch the diff**: Obtain the MR/PR diff for the changes under review
2. **Read the context**: Check related files to understand the impact
3. **Assess each change** against the criteria below

## Review Criteria

For each finding, assign a severity:

- **HIGH**: Security issues, data loss risk, breaking changes, missing error handling
- **MEDIUM**: Logic errors, missing edge cases, performance concerns, API contract violations
- **LOW**: Style issues, naming, documentation gaps, minor improvements

## Output Format

Structure your review as:

```text
## Review Summary
<1-2 sentence overview>

## Findings
| Severity | File | Issue |
| -------- | ---- | ----- |
| HIGH     | path/to/file.py:42 | Description of the issue |
| MEDIUM   | path/to/file.py:88 | Description of the issue |

## Recommendation
<APPROVE / REQUEST CHANGES / NEEDS DISCUSSION>
<Brief justification>
```

## Rules

- Do NOT produce an implementation plan. This is a review, not a planning task.
- Do NOT modify any files. Read-only analysis.
- Be specific: cite file paths and line numbers for every finding.
- If the changes look good, say so. Do not invent issues.
- Use `team_send_results` to deliver your review to the Brain.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/the-darwin-project) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->