What problem does it solve?
Use when tests fail or are flaky. Goal: get back to a stable green build with minimal behavior change. Do NOT 'fix' by weakening assertions unless justified.
Core Features & Use Cases
- Reproduce failures by running the repository's standard test commands and isolating the failing project or suite.
- Classify the failure into categories such as logic/assertion mismatch, race condition, environment/config differences, data dependence, snapshot drift, or external dependency issues not isolated.
- Minimize the repro to the smallest failing unit: a single test, a single project, or a minimal seed dataset.
- Fix with a product-focused approach: prioritize deterministic tests, guardrails, and regression coverage; document root cause.
- Prevent recurrence by introducing guards (timeouts, retries for known flaky issues) and by recording root cause in concise notes.
Quick Start
Follow the workflow to reproduce failures, classify causes, minimize the failure, and implement fixes to restore a stable green build.