bmad-code-review

Run adversarial code review layers and triage findings into structured buckets.

Updated May 17, 2026
One-click install
npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-code-review-thuantan2060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-code-review
Source: https://github.com/thuantan2060/facebook-sale-tracking/tree/main/.agents/skills/bmad-code-review
Command: npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-code-review-thuantan2060

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires resolve_customization.py.

What problem does it solve?

It helps you review code changes rigorously by running parallel adversarial review layers and turning the results into a structured set of actionable triage items.

Core Features & Use Cases

  • Adversarial multi-layer review: Blind Hunter (diff-only), Edge Case Hunter (diff + project read access), and Acceptance Auditor (diff + spec/context) run in parallel to surface different failure modes.
  • Structured triage into next actions: Findings are normalized, deduplicated, and classified into decision-needed, patch, defer, or dismiss (noise).
  • Spec-aware acceptance auditing: When a spec/story file is provided, the workflow checks changes against acceptance criteria and related context docs, and persists findings back into the story.
  • Guided execution with checkpoints: The workflow halts for human confirmation when reviewing targets are unclear, when decisions are needed, and when patches must be handled.

Quick Start

Ask an AI agent to run code review for your changes so it can gather the diff, optionally load a spec, and produce categorized findings ready for action.

Frequently Asked Questions about bmad-code-review

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

FAQPage Schema
How do I run an adversarial code review on my Git diff?

Run an adversarial code review by collecting your Git diff, optionally loading a spec, and executing parallel review layers that triage findings into decision-needed, patch, defer, or dismiss buckets.

What is spec-aware acceptance auditing for pull requests?

Spec-aware acceptance auditing checks your code changes against acceptance criteria and related context docs from a story file, persisting the review findings directly back into the relevant story file.

How do you triage code review findings into actionable items?

Triage code review findings by normalizing, deduplicating, and classifying the results from parallel adversarial review layers into structured categories: decision-needed, patch, defer, and dismiss.

Can I review staged and uncommitted working tree changes?

Yes, you can review staged or uncommitted working tree changes, as the workflow applies to PR, commit, and branch diffs, halting for human confirmation at guided execution checkpoints when targets are unclear.

What are the limitations of automated spec validation during code review?

Automated spec validation requires a workflow resolver step for customization and halts for human confirmation when decisions are needed, meaning it cannot fully auto-apply patches without guided execution checkpoints.

Does bmad-code-review work with parallel subagent orchestration?

Yes, bmad-code-review uses parallel subagent orchestration to run Blind Hunter, Edge Case Hunter, and Acceptance Auditor layers simultaneously to surface different failure modes.