branch-review

Review a branch's implementation against its branch plan for fidelity gaps.

2|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/soumyaray/ray-ai-skills --skill branch-review-soumyaray
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-review
Source: https://github.com/soumyaray/ray-ai-skills/tree/main/ray-branch-review
Command: npx skills add https://github.com/soumyaray/ray-ai-skills --skill branch-review-soumyaray

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review a branch's implementation against its branch plan to identify fidelity gaps, context issues, and security concerns.

Core Features & Use Cases

  • Plan fidelity checks: Compare implemented changes against tasks in the branch plan to ensure completed work matches the plan.
  • Context-aware review: Surface potential fresh-context bugs and scenario misalignments introduced by AI-authored changes.
  • Diff & scope analysis: Highlight scope drift and changes outside the plan, with guidance for remediation.
  • Security & quality considerations: Flag risky changes or insecure patterns and suggest safer alternatives when appropriate.

Quick Start

Run /branch-review to assess the current branch against its branch plan.

Frequently Asked Questions about branch-review

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

FAQPage Schema
How do I review a Git feature branch against its original implementation plan?

AI-assisted branch review compares your implemented Git branch changes against a local plan file to identify fidelity gaps, context issues, and security concerns automatically.

What is plan fidelity checking in AI-assisted code review?

Plan fidelity checking compares implemented code changes against the tasks defined in a branch plan to ensure completed work accurately matches the planned scope and surfaces any misalignments.

How do I detect scope drift and fresh-context bugs in AI-authored code diffs?

Context-aware diff analysis evaluates branch changes against the plan to surface scope drift, fresh-context bugs, and scenario misalignments introduced by AI-authored code, providing remediation guidance.

Do I need a specific plan file format to run an automated branch review?

Yes, automated branch review requires a locally referenced PLAN.<branch-name>.md file, plus access to the base and branch diffs, to perform plan fidelity checks and produce a structured review.

Can branch review flag security risks and insecure patterns in my feature branch?

Branch review includes security and quality considerations that flag risky changes or insecure patterns within the implementation, suggesting safer alternatives when appropriate during the review process.

What's the best way to verify that completed Git PR tasks match the planned implementation?

The best way to verify completed PR tasks match the implementation is to run an automated plan fidelity check that compares the branch diff against the original plan to identify any gaps or drift.