zekiriabd/sdd-pro/debugging-failed-pipeline

Skill — Debugging a Failed SDDPro Pipeline

Auto-trigger : pipeline RED détecté ou rapporté par utilisateur.

Anti-pattern strict : ne JAMAIS "réparer le code" sans avoir lu

le rapport du gate qui a produit le RED. Le rapport contient déjà

le diagnostic + suggestion FIX (3 lignes ERROR/CAUSE/FIX avec

classe d'erreur préfixée [CLASS]).

Procédure 4 phases (emprunt superpowers systematic-debugging)

Phase 1 — Investigation racine (avant tout fix)

1. Lire le message d'erreur mot à mot. Pas de scan rapide. Pas

d'hypothèse "je sais ce que c'est". Lire la classe d'erreur entre crochets.

1. Reproduire : que le Tech Lead relance la commande, ou lire le

rapport disque (toutes les erreurs sont persistées 3L).

1. Vérifier les changements récents :

``bash git log --oneline -10 git diff HEAD~1 `` Beaucoup de pipelines RED viennent d'un changement récent (stack.md modifié, US éditée sans re-validate, lib ajoutée hors §2.4).

1. Identifier le gate qui bloque :

``bash /sdd-status {n} # tree ASCII : quel phase est en échec /sdd-help {n} # guidance "what's next" basée sur l'état ``

Phase 2 — Lire le bon rapport

Selon la classe d'erreur dans le chat :

Phase 3 — Appliquer le FIX du rapport

Chaque rapport contient une section FIX: (1L) avec l'action exacte. Suivre ce FIX, pas inventer un fix créatif.

Si FIX ambigu OU plusieurs options :

• Préférer la commande SDD_Pro idempotente (/dev-backend {n}-{m},

/qa-generate {n} --filter X) sur l'édit manuel

• Édit manuel autorisé sous workspace/src/ pour bug ponctuel,

mais Edit-augment (jamais réécriture intégrale)

Phase 4 — Vérifier (evidence over claims)

Après le fix, NE PAS dire "ça devrait marcher". Au lieu de ça :

# Re-run l'étape qui avait échoué
/dev-run {n}              # OU
/qa-generate {n}          # OU
/sdd-review {n}

Lire le verdict (🟢/🟡/🔴) AVANT de déclarer la résolution. Pattern emprunt superpowers : verification-before-completion.

Red flags — rationalizations à refuser

Pointeurs

• @.sdd/rules/error-classification.md — taxonomie complète 188 classes
• @.sdd/rules/build-and-loop.md §2 — boucle correction API Gate
• /sdd-help {n} — guidance contextuelle
• /sdd-status {n} — tree ASCII état FEAT
• query_console_db.py {dimension} --feat {n} --format md — rapports humains rendus à la demande depuis console.db (2026-07-06 : plus de dossier qa/)
• workspace/.sys/.validation/{n}-* — JSON auditors transitoires (ingérés puis supprimés)

Règle mentale : "Le rapport contient déjà le diagnostic.

Lire avant d'agir. Pas de fix créatif sans avoir lu CAUSE + FIX."