Agent debug Navin : cause racine prouvée, branche isolée et rapport HTML

L'agent debug de Navin ne patch pas au hasard : il verrouille le signal, reproduit le bug, prouve la cause racine avec des preuves, isole le travail sur une branche, puis livre un rapport HTML avec des choix de fix numérotés. Vous dites #1, l'agent corrige. Pas de shotgun.

Quand l'utiliser

Quand quelque chose casse et que vous voulez la cause racine avec preuve : test qui échoue, stack, status code, champ pourri, requête SQL, comportement flaky. Pas pour « améliore un peu le code ».

Comment lancer

• Mode Debug + texte libre (préfixé en /debug).
• /debug [signal|chemin|scope].
• Actions → Debug quand disponible.

Le rôle de modèle est deep (UI mode debug). L'outil dédié est debug_repair.

Le process, étape par étape

1. Verrouiller le signal - erreur exacte, test en échec, stack, status code, mauvais champ/requête, ou étapes de repro. Sinon : git status / diff, logs récents, scripts du package.
2. Reproduire avec exec - test, typecheck, lint, ou commande cassée. Capturer stdout/stderr/codes de sortie. Pour SQL : schéma / requêtes / migrations. Pour API : handler → validation → DB. Pour frontend : props/state → réseau → serveur.
3. Inspecter - debug_repair(action=mcp_status) : si DebugMCP est up (preset debugmcp → http://127.0.0.1:3001/mcp), breakpoints / variables / evaluate ; sinon logs / pdb. Preuves réelles uniquement.
4. Isoler - debug_repair(action=start_branch) avant toute édition de code.
5. Réduire - read_file, git blame/diff, logs, metrics ; la plus petite instrumentation qui prouve la cause. Surveiller races, mauvais cache, mauvais env, tests flaky, N+1, fuites de connexion, tempêtes timeout/retry.
6. Board - chaque défaut confirmé en tâche (status=fix) si le board projet est actif.
7. Clôturer avec debug_repair(action=report, …) : debug-report-[date].html ouvert automatiquement (cause racine + preuves, bugs latents, choix #N). Demander par quel # commencer.

Code appliqué seulement si demandé ; sinon l'agent peut basculer en Agent et pointer vers /forge après votre choix.

Ce que le rapport contient

Comme Review et Security : rapport HTML autonome (CSS inline, pas de JS externe), résumé exécutif, preuve de cause racine, bugs latents découverts en chemin, plan de fix numéroté (effort, risque si différé, premier pas). Le chat reste court : 3 à 6 phrases + « Start with #1 ? ».

Debug vs patch au feeling

Debug + board + autonomie

Les findings deviennent des tâches. Avec l'autonomie du board : branche navin/task-*, tests verts, PR, issue fermée. La cause racine ne meurt pas dans le chat.

FAQ

Faut-il DebugMCP ?

Non. Sans MCP, l'agent utilise logs, pdb, tests et lecture de code. Avec MCP, breakpoints et évaluation en live accélèrent.

L'agent corrige-t-il tout seul ?

Non par défaut. Il prouve, rapporte, et attend votre numéro. Auto-fix seulement si vous le demandez.

Quelle différence avec le mode Agent ?

Agent implémente. Debug prouve d'abord. Enchaînez : Debug → choisir #1 → Agent / /forge.

Télécharger Navin · Fonctionnalités · Documentation

Maillage interne

• Revue experte → agent revue
• Audit AppSec → agent sécurité
• Cycle complet → module Code
• Pipeline de livraison → board autonome

Conclusion

Un debug qui verrouille le signal, reproduit, prouve, isole et livre un plan numéroté : c'est la fin des patches aléatoires, et le début d'un pipeline où chaque bug a une preuve avant un fix.