Débogage discipliné par cause racine pour scripts Python, VPS (systemd/Docker/SFTP), pipelines de veille et automatisations maison. À utiliser quand un test échoue, un build casse, un timer ou une tâche planifiée ne produit rien, un script renvoie un résultat inattendu, ou face à toute erreur non comprise. Déclencheurs : "débogue", "ça marche pas", "pourquoi cette erreur", "trouve la cause", "root cause", "ça plantait avant", "le timer ne tourne plus", "sortie vide". Ne pas activer pour une…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Débogage par cause racine
Objectif : trouver et corriger LA cause, pas un symptôme.
Règles citées, en une ligne chacune (détail dans `${CLAUDE_PLUGIN_ROOT}/references/regles.md`) :
- **R22** — au deuxième échec identique, s'arrêter, chercher la cause racine et changer de méthode.
- **R48** — toute erreur rencontrée est consignée en fin de session (symptôme, cause, correctif).
- **R51** — un cache ou une note n'est pas l'état réel : recouper sur la machine avant d'affirmer.
## Méthode (séquentielle)
1. **Reproduire** de façon fiable et minimale (commande et contexte exacts). Non reproductible →
instrumenter d'abord (→ `observability-and-instrumentation`).
2. **Observer les faits avant toute hypothèse** : message complet, stacktrace, logs
(`journalctl -u <unit>`, fichiers `*.log`), code de sortie, état réel (processus, fichiers,
`systemctl list-timers`, `docker ps`).
3. **Une hypothèse falsifiable à la fois** : « si X, alors je verrais Y » → tester Y.
4. **Bissection** : réduire la surface (dry-run, `git bisect`, isoler le sous-script) jusqu'au point
de bascule.
5. **Corriger la cause**, pas le symptôme ; vérifier qu'aucune autre branche n'en dépendait.
…
The line at the top of this page pins the label v1.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_kvaa2dwpamy2to5o
GET https://markdownregistry.com/api/v1/resolve?ref=geekfamilycorp/tricorderkit/debugging-and-error-recovery
GET https://markdownregistry.com/api/v1/blob/8ff855ba07728947f2921b68e87ae51bd78ac08ba61339ced29c68996d9926ab
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
geekfamilycorp/tricorderkit · .claude/skills/vault-token-optimizer/SKILL.md · Optimize any Markdown or Obsidian vault for Claude Code by analyzing structure first, generating manifests, routing…
geekfamilycorp/tricorderkit · cowork-plugins/tk-agent-security/skills/agent-config-audit/SKILL.md · Audit de sécurité en lecture seule de la CONFIGURATION DE L'AGENT lui-même (pas de l'application) — serveurs MCP et…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/graphrag-hybrid/SKILL.md · Répond à une question par recherche hybride locale : similarité vectorielle dans Qdrant, puis expansion du voisinage…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/neo4j-graph-ops/SKILL.md · Interroge et fait évoluer le graphe de connaissances Neo4j d'une stack locale (APOC/GDS) via le serveur MCP officiel…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/scrape-adaptive/SKILL.md · Collecte des pages web de façon robuste et respectueuse avec Scrapling (BSD-3 : parseur adaptatif qui retrouve un…
geekfamilycorp/tricorderkit · cowork-plugins/tk-data-ops/skills/watch-changes/SKILL.md · Met en place et exploite une veille de changements de pages et de flux, en local : changedetection.io (Apache-2.0…
geekfamilycorp/tricorderkit · cowork-plugins/tk-dev-discipline/skills/code-corrector/SKILL.md · Corrige et durcit le code d'une application web de façon disciplinée et mesurée. À utiliser quand l'utilisateur veut…
geekfamilycorp/tricorderkit · cowork-plugins/tk-dev-discipline/skills/dev-protocol/SKILL.md · Applique un protocole de développement discipliné à une tâche non triviale : brainstorm socratique → spec courte → plan…
addyosmani/agent-skills · skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
shashankswe2020-ux/whoop-mcp · .github/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-cursor/.cursor/skills/debugging-and-error-recovery/SKILL.md · Guides systematic root-cause debugging. Use when tests fail, builds break, something that worked yesterday broke…