root-cause-by-layer

What problem does it solve?

Five-layer root-cause analysis helps engineers avoid symptom patches by forcing explicit causal reasoning across symptom, mechanism, contract, structural origin, and conceptual origin.

Core Features & Use Cases

• Five-layer diagnostic ladder: sequentially examines symptom, mechanism, contract, structural origin, and conceptual origin to locate the true cause.
• Guardrails for fixes: prevents quick-and-dirty patches by ensuring changes address the real root cause at the appropriate layer.
• Use cases: red or flaky tests, unexpected exceptions, CI gate failures, or time-pressured debugging where surface edits would be insufficient.

Quick Start

Walk the five-layer ladder on the current bug report, document findings for layers 1–5, and name a targeted fix at the appropriate layer.