Spell Cause Map
## Summary
**Breadth-first cause decomposition for problems with unknown, multiple, or recurring root causes.** Maps ALL possible causes across categories (fishbone diagram) before investigating any of them. Surfaces systemic issues, cross-cutting causes, and Swiss cheese alignments that single-chain analysis misses.
**Arguments:** `$ARGUMENTS` (required) - Problem statement, symptom, recurring issue, or incident description
**Output:** Structured cause map with ASCII fishbone diagram, categorized causes with evidence grades, cross-cutting analysis, and prioritized investigation plan output directly to the conversation (Write is available if the user requests the output be saved to a file)
---
## Skill References
Before proceeding, load the relevant skill documents for reference:
Read the following files from the repository root:
- `docs/skills/fishbone-analysis.md`
- `docs/skills/root-cause-analysis.md`
---
## Process
### Phase 1: Frame
#### Step 1: Parse the Problem Statement
Extract the **effect** — the specific problem that needs cause mapping. This becomes the "head" of the fishbone.
| Input type | Action |
|------------|--------|
| Specific problem statement | Use directly as the effect. |
| Recurring incident | Frame as the pattern, not a single occurrence (e.g., "Checkout flow fails intermittently" not "Checkout failed at 3pm"). |
| Vague description | Clarify before proceeding (see below). |
**If the problem is unclear:**
Ask the user to describe the problem they want to map causes for: what keeps happening, how often, what's been tried.
**Output the effect statement:**when to use it
Community prompt sourced from the open-source GitHub repo smileynet/sams-genai-spells (MIT). A "Spell Cause Map" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.
tags
businesscommunitygeneral
source
smileynet/sams-genai-spells · MIT