issue-rootcause-workflow
CommunityTrace root causes to fix bugs durably.
Software Engineering#root-cause#architecture-decision#invariant#bug-triage#debugging-workflow#incident-postmortem
AuthorsoilSpoon
Version1.0.0
Installs0
System Documentation
What problem does it solve?
The workflow provides a formal, invariant-driven approach to root-cause analysis, enabling teams to identify true root causes rather than surface symptoms, and to document evidence and decisions for future reliability.
Core Features & Use Cases
- Invariant formalization: explicitly state the expected state and the violation context to guide diagnosis.
- 6-step workflow: invariant, choice, experiment, verify arrival, cross-check, and ADR/postmortem templates to organize investigations.
- Evidence-driven decisions: structured templates for PR comments, ADRs, and postmortems that capture results and next steps.
- Use Case: when diagnosing a failing system component, it helps trace from symptom to invariant to root cause and coordinate a durable fix.
Quick Start
Apply the 6 principles workflow to diagnose a bug and document invariant, violation, choice, and evidence.
Dependency Matrix
Required Modules
None requiredComponents
references
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: issue-rootcause-workflow Download link: https://github.com/soilSpoon/skills/archive/main.zip#issue-rootcause-workflow Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.