Al0olo/Agents-village

Passage de relais

L'objectif : l'agent suivant, sans mémoire de cette conversation, continue sans rien demander à personne et sans rien redériver.

Au début

1. Lis docs/HANDOFF.md en entier, puis les 3 premières entrées de docs/handoff/LOG.md.
2. Vérifie le tout face à la réalité : git status, git log --oneline -10, git branch -a, et les PRs ouvertes (gh api repos/al0olo/agents-village/pulls --jq '.[].title').
3. Si le passage de relais et la réalité divergent, crois la réalité, puis corrige le passage de relais avant de commencer un nouveau travail et note-le dans le journal.
4. Reformule la prochaine étape en une ou deux phrases à l'utilisateur, puis exécute-la.

Pendant le travail

Mets à jour docs/HANDOFF.md immédiatement quand l'un des événements suivants se produit : une unité de travail se termine, une décision est prise, une approche échoue, tu découvres une bizarrerie de l'environnement, tu ouvres ou fusionnes une PR.

À la fin (ou quand tu es interrompu)

1. Réécris docs/HANDOFF.md en utilisant le modèle ci-dessous. Il s'agit de l'état courant, pas de l'historique : remplace les lignes obsolètes, ne les entasse pas.
2. Ajoute en tête une entrée datée dans docs/handoff/LOG.md (la plus récente en premier) : ce que tu as fait, pourquoi, ce qui a échoué, les liens. L'historique y réside.
3. Exécute scripts/check-handoff.sh et valide le passage de relais avec le travail.
4. Message final à l'utilisateur : ce qui est fait, ce qui suit, tout élément nécessitant sa décision.

Modèle pour docs/HANDOFF.md

# Passage de relais
Mis à jour : AAAA-MM-JJ par <agent/modèle> · Branche : <nom> · Dernier commit : <sha>

## Objectif
Un paragraphe : ce que le projet essaie d'accomplir en ce moment.

## État
- Terminé : élément (PR #n)
- En cours : élément, exactement où ça s'est arrêté, fichiers non commités s'il y en a
- Non commencé : élément

## Prochaine étape
La seule action suivante, suffisamment concrète pour commencer immédiatement, avec les commandes.

## File d'attente
Liste ordonnée après la prochaine étape.

## Décisions en suspens (le propriétaire doit décider)
Question, options, ma recommandation.

## Pièges
Bizarreries de l'environnement, approches échouées et pourquoi, choses qui paraissent fausses mais sont intentionnelles.

## Comment vérifier
Commandes qui prouvent que l'état actuel est sain.

## Pointeurs
Fichiers et documents à lire pour approfondir.

Niveau de qualité

• Nomme les fichiers, branches, numéros de PR, commandes. Pas de « comme ci-dessus », pas de « la chose dont nous avons parlé ».
• Enregistre les approches échouées et pourquoi, afin que personne ne les répète.
• Sépare ce que tu as vérifié de ce que tu présumes, et dis ce qui est quoi.
• Garde docs/HANDOFF.md sous environ 150 lignes ; déplace l'historique dans le journal.