investigate
Investigate guides you through a disciplined five-phase debugging process: collect evidence, form ranked hypotheses, verify each one methodically, apply a minimal fix only after confirming root cause, then verify resolution. The workflow prevents guess-and-fix cycles by enforcing evidence gathering before hypothesis formation and a three-strike rule that forces re-collection rather than endless speculation.
Investigate provides a five-phase debugging workflow that prioritizes root-cause discovery before attempting any fix.
AI-generated summary based on this skill's SKILL.md
Install
blueberrycongee/termcanvas/investigate · repository language: TypeScript
git clone https://github.com/blueberrycongee/termcanvas
cp -r termcanvas/skills/skills/investigate ~/.claude/skills/investigatenpx skillfed install blueberrycongee/termcanvas/investigateFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I debug a bug systematically with Investigate?
Investigate teaches a five-phase debugging process: collect evidence first, form ranked hypotheses from that evidence, verify each hypothesis methodically, apply a minimal fix only after confirming root cause, then verify the fix resolves the issue. This structured approach prevents guess-and-fix cycles by enforcing evidence gathering before hypothesis formation and stopping endless speculation with a three-strike rule that forces re-collection of evidence.
What is the root cause analysis workflow in Investigate?
Investigate's root cause analysis follows a disciplined sequence: gather concrete evidence about the failure, rank multiple hypotheses by likelihood based on that evidence, test each hypothesis systematically rather than guessing, confirm which one is actually the root cause, and only then apply a minimal targeted fix. This methodology ensures you diagnose code issues properly instead of applying premature fixes to symptoms.
How does Investigate help me investigate unexpected behavior?
Investigate guides you to investigate unexpected behavior by collecting evidence first, then forming ranked hypotheses about what caused it. You verify each hypothesis methodically before moving to the next, avoiding the pitfall of skipping phases. The three-strike rule prevents endless speculation—after three failed hypotheses, you must re-collect evidence rather than continue guessing, ensuring you develop debugging discipline.
Can Investigate help me debug without guessing?
Yes. Investigate's structured debugging methodology eliminates guessing by enforcing an evidence-first approach. You collect concrete data about the failure, form ranked hypotheses from that evidence, then verify each one systematically. Only after confirming the actual root cause do you apply a fix. This prevents the common pitfall of skipping phases and teaches debugging discipline that avoids premature fixes and wasted troubleshooting.
What makes Investigate's debugging approach different?
Investigate enforces a five-phase process that separates evidence gathering from hypothesis formation, preventing guess-and-fix cycles. Its three-strike rule stops endless speculation by forcing re-collection of evidence after three failed hypotheses. By requiring verification before applying any fix, Investigate ensures you diagnose root cause properly and apply only minimal, targeted solutions—teaching debugging best practices that avoid common pitfalls.
How does Investigate verify a fix resolves the issue?
Investigate's final phase verifies resolution after you apply the minimal fix. This completes the five-phase workflow: evidence collection, hypothesis ranking, verification of root cause, minimal fix application, and confirmation that the fix actually resolves the original failure. This systematic approach ensures your debugging process is complete and the issue is truly resolved, not just masked.
SKILL.md
rendered from the published skill — quoted content, verbatim
Investigate
Systematic debugging workflow. Do not guess-and-fix — find the root cause first.
Phase 1: Collect
Gather all available evidence before forming any hypothesis.
- Read the error message, stack trace, or symptom description exactly as given
- Identify the affected code path — read the relevant source files
- Check
git log --oneline -20in the affected area for recent changes - If reproducible, reproduce the issue and capture the exact output
- List what you know and what you do not know
Deliverable: a structured symptom summary with affected files, error output, and recent changes.
Phase 2: Hypothesize
Form up to 3 ranked hypotheses. For each:
- State the hypothesis in one sentence
- Identify the single cheapest check that would confirm or refute it
- Do NOT start fixing yet
Phase 3: Verify
Test hypotheses in rank order. For each:
- Run the cheapest check
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/skills/investigate/SKILL.md