investigue
Investiguer méthodiquement un bug en 4 phases validées : localiser/reproduire, 3 hypothèses classées sur la cause racine, logs ciblés, fix minimal. Utilise sur /investigue, ou dès que l'utilisateur décrit un symptôme ("ça plante quand…", "je vois X mais j'attends Y", "comportement inattendu", "pourquoi ça crash", "investigue ce bug", "debug ça", "analyse le bug"). Ne propose jamais de fix immédiat — chaque phase s'arrête et attend une validation explicite avant de passer à la suivante.
- Installs
- 498
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/naiersaidane/claude-mastery --skill investigue- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads investigue automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Avant 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.
FAQ
What does the investigue skill do?
Investiguer méthodiquement un bug en 4 phases validées : localiser/reproduire, 3 hypothèses classées sur la cause racine, logs ciblés, fix minimal. Utilise sur /investigue, ou dès que l'utilisateur décrit un symptôme ("ça plante quand…", "je vois X mais j'attends Y", "comportement inattendu", "pourquoi ça crash", "investigue ce bug", "debug ça", "analyse le bug"). Ne propose jamais de fix immédiat — chaque phase s'arrête et attend une validation explicite avant de passer à la suivante.
How do I install investigue?
Run npx skills add https://github.com/naiersaidane/claude-mastery --skill investigue in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/investigue/ (personal) or .claude/skills/investigue/ (project).
Which AI agents can use investigue?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is investigue safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains investigue?
It is published by naiersaidane in naiersaidane/claude-mastery. It has 498 recorded installs.
More from naiersaidane/claude-mastery
design
naiersaidane/claude-mastery
Consulte sur le système de design d'un produit et produit docs/DESIGN.md + un preview HTML (spécimen typo + palette + 1 mockup d'écran). Propose un système cohérent et opinioné (aesthetic, typographie, color, layout, spacing, motion) avec breakdown SAFE/RISK. Utilise sur /design, "crée le design system", "écris DESIGN.md", "design depuis zéro", "système de design", "design consultation", "fais-moi un design system", ou dès qu'il faut formaliser l'identité visuelle d'un projet. Pair naturel de /cadre (PRD amont) et /planifie (plan d'impl aval).
cadre
naiersaidane/claude-mastery
Cadrer un projet par questionnement structuré et produire ou étendre docs/PRD.md selon un template fixe en 8 sections (Problème, Solution, Utilisateur cible, User Stories, Critères de succès, Hors périmètre, Décisions d'implémentation, Notes complémentaires). Utilise sur /cadre, "cadre ce projet", "écris le PRD", "fais-moi un PRD", "crée le PRD", "produis le PRD", "étends le PRD", ou dès qu'il faut formaliser le cadrage d'un projet dans un document versionné. Pair naturel de /interroge (amont) et /planifie (aval).
interroge
naiersaidane/claude-mastery
Questionnement structuré pour cadrer une feature ou brainstormer une app : une question à la fois, descend l'arbre de décision, recommandation justifiée. Utilise sur /interroge, "aide-moi à planifier", "j'ai une idée de feature/app".
illustre
naiersaidane/claude-mastery
Cree des diagrammes et visuels Excalidraw (schemas, process flows, slides, illustrations) avec rendu PNG/SVG haute resolution. Utilise quand l'utilisateur veut creer un diagramme, un schema, un visuel pour illustrer un concept — que ce soit pour une lecon, un cours, un article, une presentation, une video YouTube, une doc technique ou un slide. Aussi quand l'utilisateur mentionne 'illustre', 'Excalidraw', 'schema', 'diagramme', 'process flow', 'visuel pedagogique', 'illustration', ou veut illustrer une idee avec un visuel.
planifie
naiersaidane/claude-mastery
Découper un PRD en phases indépendamment livrables par tranches verticales (tracer bullets), puis produire ou étendre docs/PLAN.md selon un template fixe (décisions architecturales + phases avec user stories, livrable, critères d'acceptation, dépendances). Utilise sur /planifie, "découpe le PRD", "fais le plan d'implémentation", "casse-moi ça en phases", "écris le plan", "étends le plan", "tracer bullets", "vertical slices", ou dès qu'il faut transformer un PRD en plan d'exécution versionné. Aval naturel de /cadre.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.