Que fait Pit-Stop ?
Pit-stop F1 pour codebases : entrez, faites réparer, ressortez plus rapide. Une seule instruction exécute lire → trouver → corriger → vérifier → rapporter sans questions en cours de route. L'utilisateur donne le feu vert ; vous revenez une fois avec un rapport.
Le déroulement (dans l'ordre, sans saut)
- Charger : lire README/AGENTS.md (ou équivalent) +
git status+ zones chaudes des commits récents. Écrire une ligne en premier : MODE = ce qui compte comme constat ici, ce qui est rejeté d'office. Il manque un fait clé ? Demander UNE FOIS, puis poursuivre avec les valeurs par défaut les plus strictes. - Trouver : délimiter avant de scanner (cible nommée > zones chaudes git > arbre complet).
Chaque constat nécessite une preuve
chemin:ligne. Ignorer les décisions enregistrées sauf si une friction justifie leur réouverture. Étiqueter chaque élément :delete/stdlib/native/yagni/shrink/security/obs, forceStrong/Worth/Speculative. Spéculatif = rapport uniquement, jamais de correction. Rien trouvé : direLean already. Ship.— jamais de remplissage. - Proposer : uniquement les éléments forts. Chacun = symptôme + preuve + impact + correction minimale + coût. Plus une liste de ce qui N'EST PAS fait avec ses conditions de déclenchement.
- Corriger : boucle revue→correction avec un relecteur indépendant (angle différent bat les mêmes yeux) ;
s'arrêter à un état propre ou
--max-rounds(par défaut 3). Registre inter-tours, pas de corrections répétées. Deux tours stagnants → escalader vers « nécessite un humain », arrêter. Voirreferences/guardrails.md. - Rapport : en-tête
Généré entièrement automatiquement par pit-stop. Quatre blocs — modifié / vérifié (sortie d'outil) / non vérifié / restant. Aucune affirmation sans sortie fraîche d'outil. Suppression des secrets/tokens/PII dans tout ce qui est collé. Voirtemplates/report.md.
Lois de fer
- Preuve avant affirmation, toujours. Pas d'exécution de vérification dans ce tour = pas d'affirmation de succès.
- Le « fait » d'un sous-agent n'est pas fait. Lire son diff avant de rapporter.
- Les zones floues sont rétrogradées, jamais devinées. Écrire « nécessite un humain », continuer.
- Push/commit jamais automatique. Les modifications attendent dans le répertoire de travail un seul mot explicite.
- Fusible de dépense unique : une phase brûlant plus de 20 $ → arrêter la phase, écrire le rapport.
Détails : references/phases.md, references/guardrails.md, references/verification.md.