Docs/patterns/root cause pattern/skills

Root Cause Pattern — Skills

Pattern: Root Cause
Component: skills.md
Version: 1.3 | Updated: 2026-07-29


Skill Path Why required
Debug skills/debug.skill.md Evidence-bound causal chain
Documentation skills/documentation.skill.md RCA retention
Testing skills/testing.skill.md Regression that would have caught it
Observability skills/observability.skill.md Signal → cause linkage

Skill activation triggers

Run after containment. Use Debug to bind cause to evidence. Use Observability to connect signals to that cause. Use Testing for the regression that would have caught it. Use Documentation so the RCA survives the next on-call rotation.

Verification that skills worked

  • Causal chain cites timeline evidence, not blame
  • Follow-up owners and due dates exist before RCA close
  • A regression test or detector would fail on the pre-fix defect

Changelog

  • 1.3 (2026-07-29): Root Cause skill activation and verification rewritten for this envelope.