reviewing-code-perfectly

name	reviewing-code-perfectly
description	Reviews pull requests using the PERFECT code review methodology — 7 principles applied in strict priority order (Purpose, Edge Cases, Reliability, Form, Evidence, Clarity, Taste). Use when reviewing a PR, conducting code review, or when the user mentions PERFECT review methodology.
allowed-tools	Bash, Read, Grep, Glob

Reviewing Code with PERFECT Methodology

Structured PR review applying 7 principles in strict priority order to maximize review value while reducing cognitive load. Based on Daniil Bastrich's PERFECT methodology.

Quick Start

reviewing-code-perfectly <PR-ID or PR-URL>

1. Fetch PR data via gh CLI
2. Analyze changes against each PERFECT principle in order
3. Produce structured review with pass/fail per principle

Inputs

• PR ID (number): e.g., 42 (must be in the target repo's directory)
• PR URL: e.g., https://github.com/org/repo/pull/42 (works from any directory)

URL parsing is deterministic — handled by gh-pr-parse, not the LLM.

Workflow

Step 1: Gather PR Data

# Parse PR reference and check out code into an isolated worktree.
# Outputs: REVIEW_DIR, OWNER, REPO, PR_NUMBER
# For URLs: creates a bare clone if not in the target repo.
eval ""


REPO_FLAG=
 [ -n  ] && [ -n  ]; 
    REPO_FLAG=



gh  view   --json title,body,files,additions,deletions,baseRefName,headRefName,url,state,reviewDecision


gh  diff  


gh  view   --json files --jq