bmad-code-review

Review code changes adversarially and triage findings into actionable categories.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-code-review-imaginerlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-code-review
Source: https://github.com/ImaginerLabs/skill-manager/tree/main/.trae/skills/bmad-code-review
Command: npx skills add https://github.com/ImaginerLabs/skill-manager --skill bmad-code-review-imaginerlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates rigorous, adversarial code reviews by launching multiple reviewer layers, consolidating findings, and converting them into clear, actionable backlog items so engineering teams can find, prioritize, and fix logical, edge-case, and acceptance issues faster.

Core Features & Use Cases

  • Parallel adversarial reviews: Runs Blind Hunter, Edge Case Hunter, and Acceptance Auditor roles in parallel to surface different classes of problems.
  • Structured triage and deduplication: Normalizes, deduplicates, and classifies findings into decision_needed, patch, defer, or dismiss buckets.
  • Diff construction and spec awareness: Builds diffs from staged/uncommitted changes, branches, commit ranges, or provided diffs, and audits changes against spec files and sprint context.
  • Workflow integration: Writes findings back to story files, appends deferred items, and can sync story status in sprint tracking artifacts.
  • Use Case: Run this on a pull request or local branch to get a disciplined, triaged review that yields actionable tasks for engineers and product owners.

Quick Start

Ask the skill: Please run code review on the current branch against main and include the related spec file if available.

Frequently Asked Questions about bmad-code-review

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

FAQPage Schema
How do I automate adversarial code review on a pull request?

Adversarial code review on a pull request is automated by launching parallel reviewer roles to surface different problem classes. Findings are then deduplicated and triaged into decision_needed, patch, defer, or dismiss buckets for engineers.

What is triage in the context of automated diff analysis?

Triage in automated diff analysis is the process of normalizing and deduplicating code review findings. It classifies issues into decision_needed, patch, defer, or dismiss buckets so engineering teams can prioritize and fix acceptance and logical problems faster.

How do I review uncommitted changes against a spec file?

To review uncommitted changes against a spec file, the Skill constructs a diff from your local workspace and audits it with spec awareness. It runs an Acceptance Auditor role to ensure your code changes align with the defined sprint context and story requirements.

Can I sync triaged code review findings directly to sprint tracking?

Yes, triaged code review findings can be synced to sprint tracking artifacts. The workflow integration writes categorized findings back to story files, appends deferred items, and updates story status to keep engineering backlogs current.

Does automated code review work with commit ranges and local branches?

Automated code review works with commit ranges, local branches, staged changes, and provided diffs. It constructs the diff from these inputs to run parallel adversarial reviews and audit the changes against your spec files and sprint context.