← ClaudeAtlas

add-investigationlisted

Use when investigating vague symptoms or information-flow bugs requiring differential diagnosis before fixes. Applies to hotfix triage, audit deep-dive, review follow-up. Consumed by add.diagnose.
brabos-ai/code-addiction · ★ 8 · Code & Development · score 75
Install: claude install-skill brabos-ai/code-addiction
# Investigation Skill <!-- uses: - agent: architecture-agent - agent: feature-history-agent - agent: git-history-agent - command: /add.diagnose - command: /add.hotfix - skill: add-investigation/references/5-whys.md - skill: add-investigation/references/agans-9-rules.md - skill: add-investigation/references/backward-tracing.md - skill: add-investigation/references/differential-diagnosis.md - skill: add-investigation/references/flow-tracing.md - skill: add-investigation/references/symptom-disambiguation.md --> ## Overview Vague symptoms, hard-to-find bugs, and information-flow inconsistencies are NOT solved by jumping into code — they require rigorous disambiguation, backward tracing, and differential diagnosis BEFORE any fix or route decision. This skill encodes a 5-phase methodology with a hard Iron Law (see Credits for attribution). ## ⛔ Iron Law ``` NO ROUTE RECOMMENDATION WITHOUT DIFFERENTIAL DIAGNOSIS FIRST ``` Corollaries: - No "I think it is X" without at least 3 candidate hypotheses ranked. - No code change proposal without backward tracing the data flow. - No "this is a bug" classification without reproducing the observable predicate. - After 3 failed hypothesis tests → STOP and question the framing (not the code). ## When to Use - Vague symptom reports: "something seems off in X", "I don't know if this is a bug or missing feature", "this behavior looks weird". - Pre-decision triage: before opening feature, hotfix, or dismissing as no-action. - Pre-hotfix inve