code-review-phased

Reviews codebases in three approval-gated phases and writes findings to code.md.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill code-review-phased-pulak999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review-phased
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/cursor-skills/code-review-phased
Command: npx skills add https://github.com/pulak999/ai-tooling --skill code-review-phased-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large code reviews often overwhelm reviewers and produce shallow results. This Skill structures a senior-level systems code review into three gated phases, ensuring thorough coverage of architecture, individual files, and cross-cutting issues without losing rigor. ## Core Features & Use Cases - Phased Review Workflow: Runs a repo overview, file-by-file drill down, and cross-cutting analysis as separate phases, pausing for explicit user approval between each. - Persistent Findings File: Writes all findings to a single code.md file, appending per phase so results survive long sessions. - L6-Style Systems Focus: Targets logical errors, unhandled edge cases, architectural mismatches, and future breakpoints rather than style nits. - Use Case: Point it at an unfamiliar repository before a major refactor; get a structured architecture map first, approve it, then receive per-file and cross-cutting analysis you can act on incrementally. ## Quick Start Ask the assistant to run a phased code review of this repository and write the findings to code.md.

Frequently Asked Questions about code-review-phased

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a phased code review on a repository?

Invoke the skill and point it at your repository. It runs Phase 1 (repo overview) first, writes findings to code.md, then waits for you to reply 'approved' or 'next' before continuing to file-by-file and cross-cutting phases.

What does a senior systems code review focus on?

It focuses on logical errors, unhandled edge cases, architectural mismatches, and assumptions that could break in the future. It avoids line-by-line style commentary and instead flags what is wrong or surprising in each file.

Where are the code review findings saved?

All findings are written to a single Markdown file named code.md, created or overwritten at the start and appended after each phase. The chat only summarizes results and points you to the file.

Can I control which files get reviewed first?

Yes. In Phase 2 you can specify a file order, or let the skill propose 'most critical files first' based on entry points discovered in Phase 1. You approve or adjust the proposed order before the drill down begins.

When should I not use a phased code review?

Avoid it for quick single-file checks or style-only linting, where the three-phase approval workflow adds unnecessary overhead. It is designed for full-repository, architecture-level reviews that benefit from staged analysis.