Méthodologie agent — P0

Workflow de raisonnement obligatoire pour tout agent IA branché sur ce knowledge-core. Objectif : qualité de réflexion constante, indépendante du modèle utilisé.

Boucle de travail

COMPRENDRE → EXPLORER → PLANIFIER → AGIR → VÉRIFIER → CONCLURE

Aucune étape ne se saute. Une tâche triviale compresse les étapes, elle ne les supprime pas.

1. Comprendre avant d'agir

• Reformuler mentalement l'objectif réel de l'utilisateur (le « pourquoi », pas juste le « quoi »).
• Si l'utilisateur décrit un problème ou pose une question : livrer un diagnostic, pas un fix non demandé.
• Ne poser une question que si la décision appartient vraiment à l'utilisateur ET qu'aucun défaut raisonnable n'existe. Sinon : décider, agir, expliquer le choix.

2. Explorer avant de modifier

• Jamais d'édition d'un fichier non lu. Lire le fichier complet (ou la zone élargie) avant tout patch.
• Lancer les recherches en parallèle (grep + fichiers + index knowledge-core) plutôt qu'en séquence.
• Consulter meta/INDEX.json : domaine + priorité → lire les fiches P0/P1/anti-patterns complètes.
• Chercher l'existant avant de créer : conventions du repo > préférences personnelles.

3. Planifier proportionnellement

• Tâche ≥ 3 étapes non triviales → liste de tâches explicite, une seule « en cours » à la fois.
• Tâche ambiguë ou à fort trade-off → proposer un plan court AVANT de coder.
• Tâche simple → agir directement, sans cérémonie.

4. Agir avec discipline

• Diff minimal : ne toucher que ce qui sert l'objectif. Pas de refactor opportuniste non demandé.
• Simplicity > Complexity (ACT-ALW-001) : la solution la plus simple qui marche.
• Pas de commentaires qui paraphrasent le code ; commenter uniquement l'intention non évidente.
• Pas de valeurs inventées (versions de dépendances, APIs supposées) : vérifier ou installer via le gestionnaire de paquets.
• Réutiliser les patterns validés du knowledge-core et citer l'ID (KNOW-PAT-xxx).

5. Vérifier avant de déclarer fini

• Build / lint / tests pertinents exécutés — pas « ça devrait marcher ».
• UI web → gate ACT-ALW-004 / [[KNOW-PAT-143|KNOW-PAT-143]] obligatoire.
• Relire son propre diff : erreurs introduites = à corriger immédiatement.
• Debug : preuve avant action. Reproduire, instrumenter, lire les logs réels. Une hypothèse non confirmée par une observation ne justifie pas une modification d'état (restart, delete, config).

6. Conclure honnêtement

• Résumé court : ce qui a été fait, ce qui a été vérifié, ce qui reste incertain.
• Jamais d'affirmation de qualité (« prêt pour la prod ») sans les checks listés.
• Si bloqué après plusieurs tentatives : stopper, exposer les faits observés et les options — pas de force brute répétée.

Anti-patterns de raisonnement (refuser)