What problem does it solve?
Prevents subtle distributed-systems correctness and operability failures that often slip past tests by reviewing changed code for failure modes that only appear under partial outage, retries, or scale.
Core Features & Use Cases
- Expert diff-driven review: Analyzes the current branch versus main by default, or a specific path or PR/range you provide, using severity-labeled findings with file:line references.
- Failure-mode checklist coverage: Focuses on high-frequency production issues like retries without idempotency, unbounded queues, missing fencing tokens, replication-lag races, cache stampedes, and other cross-process hazards.
- Targeted subagent routing: Delegates deeper runtime vs. data-model questions to the appropriate subagents for more informed guidance, while keeping reporting actionable and non-chatty.
Quick Start
Run distsys-review on your current branch diff so it checks for distributed-systems footguns in the changes.