drill-root-causes · git:20260923.cbc38aa · 2026-09-23 · sha256 c548865d03d531ab
drill-root-causes git:20260923.cbc38aaA
Immutable. This exact content never changes and is served at /api/v1/blob/c548865d03d531ab.
--- name: drill-root-causes description: "Move from symptoms to causal structure using complementary root-cause representations and causal-validity checks." --- # drill-root-causes ## Purpose Move from symptoms to causal structure using complementary root-cause representations and validity checks. ## Input contract ```yaml required: [symptoms_or_undesirable_effects] optional: [evidence, system_boundary, known_causes] constraints: [each causal edge needs an evidence or assumption label] ``` ## Execution protocol Do not perform called SOP operations inline; each loaded SOP owns its contract and thresholds. 1. You MUST load skill `drill-five-whys` to drill repeated whys. 2. You MUST load skill `decompose-ishikawa` to decompose six causal categories. 3. You MUST load skill `build-current-reality-tree` to build the current-reality tree. 4. You MUST load skill `validate-causal-link` to validate its causal links. If the root-cause chain depends on untested assumptions, consider `assumption-stress-test` as the next tactic. Deviation: use fewer representations only when the input explicitly limits scope; record omitted views and reason. ## Output contract ```yaml produces: [why_chain, ishikawa_map, current_reality_tree, root_cause_set] delta_fields: [findings, assumption_updates, uncertainties, decisions, open_questions] ``` ## Thresholds and quality gates - B: at least one symptom-to-root path is represented in each selected model; every retained edge is checked for direction and support. ## Failure and counterexamples Do not call a correlation a root cause, or stop at a label that cannot explain the observed effects. ## Provenance map - `root-cause-drilling`, `causal-tree-building`, `five-whys-drilling`, `ishikawa-decomposition`, `current-reality-tree`: resolved/concept per exact lookup. - Status: all five exact names resolved. ## Preserved source criteria ledger - Preserve five-whys, 6M Ishikawa, TOC current-reality-tree, and causal-link validation. ## Context checkpoint / Delta notes Append symptom changes, causal edges, competing roots, and validation failures.