# Project guidelines
cat CLAUDE.md

# Get PR info
PR_NUM={pr_number}
gh pr view ${PR_NUM}
gh pr diff ${PR_NUM}

## Code Review: PR #{pr_number}

### Summary
Brief overview of changes and their purpose.

### Strengths
- What's done well
- Good patterns used

### Issues Found

#### Critical (Must Fix)
| File | Line | Issue | Suggested Fix |
|------|------|-------|---------------|
| ... | ... | ... | ... |

#### Suggestions (Should Consider)
| File | Line | Suggestion | Rationale |
|------|------|------------|-----------|
| ... | ... | ... | ... |

#### Nitpicks (Optional)
- Minor style/formatting notes

### Architecture Notes
How this change fits (or doesn't) with the handler/embed/thread architecture.

### Test Coverage
- Typecheck: Pass/Fail
- Build: Pass/Fail

### Verdict
- [ ] Approve - Ready to merge
- [ ] Request Changes - Issues must be addressed
- [ ] Comment - Feedback only, author decides

gh pr comment ${PR_NUM} --body "$(cat <<'EOF'
## Code Review: PR #XX

[Your review content here]
EOF
)"

REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)

cat << 'EOF' | gh api repos/${REPO}/pulls/${PR_NUM}/reviews --method POST --input -
{
  "body": "Review summary...",
  "event": "COMMENT",
  "comments": [
    {"path": "src/handlers/pr.ts", "line": 42, "body": "Inline comment"}
  ]
}
EOF

# Create issue for EVERY critical finding (with required labels)
gh issue create --title "fix(scope): [Brief description of bug]" \
  --label "complexity: [low|medium|high]" \
  --label "testing: [low|medium|high]" \
  --body "## Critical Issue from PR #${PR_NUM} Review

**File:** \`src/handlers/example.ts\`
**Line:** XX

**Problem:**
[Description of the bug/issue]

**Impact:**
[Why this is critical - e.g., causes incorrect behavior, crashes, etc.]

**Suggested Fix:**
\`\`\`typescript
// Proposed code change
\`\`\`

---
*Found during agent review of PR #${PR_NUM}*"

For each suggestion:
├── Can fix in < 5 minutes AND low risk?
│   └── YES → Fix it now, commit with description
│   └── NO  → Create GitHub issue (MANDATORY)

# Create issue for EVERY non-addressed suggestion (with required labels)
gh issue create --title "refactor(scope): [suggestion title]" \
  --label "complexity: [low|medium|high]" \
  --label "testing: [low|medium|high]" \
  --label "from-review" \
  --body "## From PR #${PR_NUM} Agent Review

**Suggestion:** [description]

**File:** \`src/handlers/example.ts\`
**Line(s):** XX-YY

**Rationale:** [why this matters]

**Suggested approach:**
\`\`\`typescript
// Example code if applicable
\`\`\`

---
*Found during agent review of PR #${PR_NUM}*"

# Create issue for non-addressed nitpicks (can batch multiple into one issue)
# Nitpicks are typically low complexity and low testing
gh issue create --title "style: Minor polish items from PR #${PR_NUM}" \
  --label "complexity: low" \
  --label "testing: low" \
  --label "from-review" \
  --body "## Nitpicks from PR #${PR_NUM} Agent Review

Minor style/formatting items identified during review:

- [ ] Item 1: [description] (\`src/handlers/example.ts:XX\`)
- [ ] Item 2: [description] (\`src/handlers/example.ts:YY\`)
- [ ] Item 3: [description] (\`src/embeds/builders.ts:ZZ\`)

**Priority:** Low - address when convenient

---
*Found during agent review of PR #${PR_NUM}*"

gh pr comment ${PR_NUM} --body "$(cat <<'EOF'
## Agent Review Follow-up Issues Created

The following items from the agent review have been captured as GitHub issues:

| Issue | Type | Complexity | Testing | Description |
|-------|------|------------|---------|-------------|
| #XXX | Critical | medium | high | [title] |
| #YYY | Suggestion | low | medium | [title] |
| #ZZZ | Nitpicks | low | low | [title] |

All items are now tracked with complexity/testing labels for prioritization.
EOF
)"

1. User requests: "Review PR #{number}"

2. Gather context:
   - Read CLAUDE.md for project guidelines
   - Get PR diff and view changes

3. Review against criteria:
   - Code quality
   - Architecture alignment
   - Integration consistency
   - Testing
   - Performance

4. Generate review document:
   - Summary of changes
   - Strengths identified
   - Issues found (critical/suggestions/nitpicks)
   - Architecture notes
   - Verdict

5. Post review on PR:
   gh pr comment {pr_number} --body "[review]"

6. Handle critical issues (REQUIRED for each):
   a. Create GitHub issue for tracking
   b. Fix the issue in PR branch
   c. Commit with "closes #XXX" reference
   d. Reply to review noting fix and issue closure

7. Handle suggestions (for EACH suggestion):
   a. Can fix quickly (< 5 min, low risk)? → Fix it now
   b. Otherwise → Create GitHub issue (MANDATORY)

8. Handle nitpicks (for EACH nitpick):
   a. Can fix in seconds? → Fix it now
   b. Otherwise → Create GitHub issue (can batch multiple)

9. Post follow-up comment linking all created issues

10. Report to user:
    - Verdict (Approve/Request Changes/Comment)
    - Critical issues: X found, X fixed, issues #A, #B
    - Suggestions: X found, Y fixed, Z deferred to issues #C, #D
    - Nitpicks: X found, Y fixed, Z deferred to issue #E
    - Link to posted review

User: "Run agent review on PR #13"

1. Read CLAUDE.md - Note Attribution Policy, handler patterns, thread architecture
2. gh pr view 13 - Get PR title, description
3. gh pr diff 13 - Review all changed files

4. Evaluate each file against criteria

5. Generate and post review:
   ## Code Review: PR #13
   - Summary, Strengths, Issues, Verdict

6. Found: 0 critical, 3 suggestions, 2 nitpicks

7. Suggestions:
   - #1: Simple rename → Fix now (commit abc123)
   - #2: Complex refactor → Create issue #45
   - #3: Multi-file change → Create issue #46

8. Nitpicks:
   - #1: Add type annotation → Fix now (commit abc123)
   - #2: Style preference → Create issue #47 (batched)

9. Post follow-up comment:
   "Issues created: #45, #46, #47"

10. Report to user:
    "Agent review posted on PR #13
    - Verdict: Approve
    - Critical: 0
    - Suggestions: 3 found (1 fixed, 2 → issues #45, #46)
    - Nitpicks: 2 found (1 fixed, 1 → issue #47)
    - Review: [url]"

# Gather context
cat CLAUDE.md

# Get PR info
gh pr view {pr_number}
gh pr diff {pr_number}

# Post review comment
gh pr comment {pr_number} --body "[review]"

# Create GitHub issue (REQUIRED for all non-addressed items)
# MUST include complexity and testing labels!
gh issue create --title "type(scope): Brief description" \
  --label "complexity: [low|medium|high]" \
  --label "testing: [low|medium|high]" \
  --label "from-review" \
  --body "From PR #{pr_number} review..."

# Commit fix with issue reference
git commit -m "fix(scope): Description - closes #{issue_number}"

# Post formal review with inline comments
REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
cat << 'EOF' | gh api repos/${REPO}/pulls/{pr_number}/reviews --method POST --input -
{
  "body": "Review summary",
  "event": "COMMENT",
  "comments": [{"path": "src/handlers/pr.ts", "line": 42, "body": "Comment"}]
}
EOF