feat: add deep analysis to PR reviewer instructions

[abhex]

Summary

This PR enhances the PR reviewer instructions by adding a 'Deep
Analysis' section to improve the quality of reviews by identifying
logical issues and providing actionable suggestions.

Type of change

• New Claude agent
• New / updated Claude rules
• New / updated Claude skill
• Documentation update
• Other (describe below)

What was added / changed

• Added a new step '4. Perform Deep Analysis' in
  .github/workflows/pr-reviewer.md after '3. Check Contributing
  Guidelines Compliance', focusing on documentation alignment,
  performance/scalability of code snippets, and logical issues.
• Updated the PR review comment template to include a 'Deep Analysis'
  section for reporting issues with brief suggestions and diff context.
• Included examples for Deep Analysis to guide reviewers on how to
  report documentation misalignment and performance issues.

This update aims to catch substantive flaws beyond basic compliance,
ensuring logical consistency and code quality in pull requests.

Checklist

• File is placed in the correct directory
• Filename follows the naming convention for its type
  (kebab-case)
• YAML frontmatter is present and valid (for agents and skills)
• Content is accurate, concise, and free of typos
• No sensitive information (credentials, internal URLs,
  proprietary data) is included
• README updated if this addition warrants a mention

Related issues / references

• This PR addresses the design spec outlined in docs/superpowers/spec s/2026-04-16-pr-reviewer-deep-analysis-design.md.
• Implementation plan followed from
  docs/superpowers/plans/2026-04-16-pr-reviewer-deep-analysis.md.

[github-actions]

🤖 Automated PR Review

PR Template Compliance

✅ Template looks good.

Contributing Guidelines

✅ Guidelines followed.

Sensitive Information Check

✅ No sensitive information detected.

Deep Analysis

• Duplicate section numbering: New "4. Perform Deep Analysis" inserted before existing "4. Scan for Sensitive Information", resulting in two section 4s. Suggestion: Renumber "Scan for Sensitive Information" to "5." and adjust subsequent sections if needed. Diff context:

  +### 4. Perform Deep Analysis
  ...
  ### 4. Scan for Sensitive Information
  

✅ No other issues found.

Summary

Solid enhancement to reviewer instructions with practical deep analysis guidance. Fix the section numbering duplication and this is ready to merge.

Generated by PR Reviewer for issue #7 · ● 2.3K · ◷

[github-actions]

🤖 Automated PR Review

PR Template Compliance

✅ Template looks good. Summary, type (Documentation update), changes, checklist (all checked), and references are all properly filled.

Contributing Guidelines

✅ Guidelines followed. Single logical change to workflow docs, correct location (.github/workflows/), kebab-case filename, no YAML needed, content accurate, no sensitive info, README update not required for this minor enhancement.

Sensitive Information Check

✅ No sensitive information detected. Changes are purely instructional text with generic examples.

Deep Analysis

✅ No issues found. Enhances reviewer quality logically; examples align with repo (rules install paths); numbering updated correctly; references to design docs are appropriate even if not in-repo.

Summary

Excellent enhancement to PR review process—improves depth without overcomplicating. Ready for merge.

Generated by PR Reviewer for issue #7 · ● 2.5K · ◷