About investigue
investigue is a debugging skill for coding agents that structures investigation before changes. It requires a reproducible symptom and expected behavior, then gates each phase on user approval, from locating the bug through a minimal fix.
Key features
- 01Checks for symptom and expected behavior
- 02Locates likely code areas and reproduction steps
- 03Ranks three falsifiable root-cause hypotheses
- 04Adds tagged logs to test the leading hypothesis
- 05Proposes a minimal fix after confirmation
Use cases
- 01Investigating a bug before editing code
- 02Narrowing causes with observable predictions
- 03Keeping debugging steps subject to user review
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/investiguein Claude Code to confirm it loaded.
Details
From the project READMEAvant de commencer, vérifie que tu disposes de deux éléments :
- Le symptôme : ce qui se passe concrètement (message d'erreur, comportement observé, valeur retournée…)
- Le comportement attendu : ce qui devrait se passer à la place
Si l'un ou l'autre manque, demande-le explicitement avant d'aller plus loin.
Avant tout fix, déroule ces 4 phases dans l'ordre. Arrête-toi à la fin de chacune et attends ma validation.
PHASE 1 : Localiser et reproduire.
À partir du symptôme, explore le code (utilise le sous-agent Explore si nécessaire) pour identifier les 2-3 zones les plus susceptibles d'héberger la cause. Liste-les avec une phrase de justification chacune. Puis décris en 3 lignes le scénario minimal qui rejoue ce bug à coup sûr. Si tu ne peux pas le reproduire de manière fiable, dis-le et propose un plan pour y arriver.
PHASE 2 : 3 hypothèses classées sur la cause racine.
Propose 3 hypothèses sur la cause racine (pas le symptôme), classées de la plus probable à la moins probable. Pour chacune : hypothèse en 1 phrase, puis prédiction falsifiable — « si cette hypothèse est vraie, on observerait <observation précise> ; si on observe l'inverse, on l'élimine ».
PHASE 3 : Tester l'hypothèse #1.
Ajoute des logs ciblés pour vérifier l'hypothèse #1. Préfixe chaque log par le tag [DEBUG-a4f2] (4 caractères au hasard) pour suppression en bulk plus tard. Ne propose pas de fix à cette phase. Dis-moi ce que je dois observer pour confirmer ou infirmer.
Règle des 3 strikes : si les 3 hypothèses sont fausses, STOP. Ce n'est plus un bug de code, c'est une question d'architecture. On change d'angle.
PHASE 4 : Fix minimal.
Une fois l'hypothèse confirmée, propose les modifications les plus courtes qui traitent la cause racine. Pas d'optimisation collatérale, pas de refactor opportuniste. Rédige le message de commit en expliquant la cause racine, pas le symptôme.