bmad-code-review

Review code diffs adversarially and triage findings into actionable categories.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-code-review-amitmishra-byldd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-code-review
Source: https://github.com/amitmishra-byldd/Bmad-Note-Maker/tree/main/_bmad/bmm/4-implementation/bmad-code-review
Command: npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-code-review-amitmishra-byldd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a disciplined, adversarial code review workflow that surfaces blind spots, edge cases, and acceptance-criteria violations so teams can triage and act on precise, actionable findings instead of noisy, unstructured feedback.

Core Features & Use Cases

  • Parallel adversarial reviews: Runs Blind Hunter (diff-only), Edge Case Hunter (project-aware), and Acceptance Auditor (spec-aware) reviews in parallel to maximize coverage.
  • Structured triage and normalization: Merges, deduplicates, and classifies findings into decision_needed, patch, defer, or dismiss buckets with clear handling rules.
  • Integration with development artifacts: Builds diffs from staged/uncommitted/branch/commit-range or provided diffs, writes findings to story files, appends deferred work, and can sync sprint-status when available.
  • Human-in-the-loop checkpoints: Halts for confirmations on review scope, spec presence, chunking large diffs, decision-needed resolutions, and patch application.

Quick Start

Run an adversarial code review of the current branch diff and produce triaged findings written to the story file.

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 for branch diffs?

Adversarial code review for branch diffs is automated by running parallel Blind Hunter, Edge Case Hunter, and Acceptance Auditor reviews. The system merges and deduplicates findings, then classifies them into decision_needed, patch, defer, or dismiss buckets for actionable triage.

What is adversarial multi-layer code review?

Adversarial multi-layer code review is a process that runs parallel diff-only, project-aware, and spec-aware assessments to maximize coverage. It surfaces blind spots, edge cases, and acceptance-criteria violations, producing structured triage reports instead of noisy, unstructured feedback.

How do I triage code review findings into actionable categories?

Code review findings are triaged by merging and deduplicating results from parallel review passes, then classifying each issue into decision_needed, patch, defer, or dismiss buckets. This structured normalization ensures teams act on precise findings with clear handling rules.

Can I apply code review to specific commit ranges or staged changes?

Yes, code review can be applied to staged changes, uncommitted changes, branch diffs, specific commit ranges, or user-provided diffs. The system builds the diff from the specified source and optionally halts for confirmation on review scope and chunking large diffs.

Does this code review workflow integrate with sprint tracking and story files?

Yes, the code review workflow integrates with development artifacts by writing findings to story files, appending deferred work items, and syncing sprint-status updates when available. This connects triaged review findings directly to ongoing development workflows.

What are the limitations of automated code review triage?

Automated code review triage requires human-in-the-loop checkpoints for confirmations on review scope, spec presence, large diff chunking, and decision-needed resolutions. Users must manually resolve decision-needed findings and approve patch applications before the workflow proceeds.