Appliquer une revue

Que fait Appliquer une revue ?

Aidez la personne à décider pour chaque constat et n'appliquez que ce qu'elle approuve.

Règle fondamentale : ne jamais supposer, déduire ou appliquer une modification sans une décision explicite. Si un constat est ambigu, demandez des éclaircissements avant de proposer des options. Chaque constat est traité séparément ; ne les regroupez jamais.

Artefacts et statuts

• Chaque élément de travail se trouve dans docs/specs/<AAAAMMJJ>-<type>-<nom>/.
• spec.md et plan.md portent status: draft | approved | obsolete dans leur en-tête. Seule une personne définit approved.
• Si vous modifiez un artefact qui était approved, repassez-le à l'état draft et mentionnez-le.

Étape 1 : présenter les constats

1. Identifiez l'élément de travail et la revue (review-spec.md ou review-plan.md). Demandez si ce n'est pas clair.
2. Listez tous les constats, numérotés, en commençant par les bloquants. Pour chacun, montrez :
   • Constat [N] : ce que la revue souligne.
   • Correctif suggéré, s'il y en a un.
   • Options :
     • A) Appliquer le correctif tel quel.
     • B) Appliquer un correctif modifié (la personne le décrit).
     • C) Rejeter, avec le motif.
     • D) Reporter.

Attendez que la personne réponde à tous avant de continuer.

Étape 2 : confirmer

Résumé des décisions
────────────────
[N] <titre> → appliqué / modifié / rejeté / reporté

Demandez : « Confirmez-vous ces décisions avant que je les applique ? » Ne continuez pas sans confirmation.

Étape 3 : appliquer

1. Appliquez uniquement les modifications confirmées (A et B), et seulement aux artefacts concernés par la revue. Ne touchez à rien d'autre.
2. Dans le fichier de revue, sous chaque constat, notez la décision prise :
   • pour les rejetés, le motif ;
   • pour les reportés, ce qui est encore en attente.
3. Indiquez à la personne où elle en est :
   • Si aucun constat bloquant n'est encore ouvert, l'artefact est prêt pour qu'elle le marque approved, ou pour un nouveau passage review-spec.
   • Si des constats bloquants reportés subsistent, ou des rejetés comportant un risque, signalez-le.

Étape 4 : autres spécifications affectées

Vérifiez si une décision de l'étape 2 affecte d'autres spécifications en cours :

1. Regardez dans docs/specs/*/spec.md celles dont le statut est draft.
2. Pour chacune, évaluez si une décision introduit un conflit, modifie une dépendance ou invalide une hypothèse.
3. Pour chaque spécification potentiellement affectée :
   • montrez quelle spécification, quelle section et ce qui devrait changer ;
   • demandez : « Cette décision l'affecte-t-elle ? Dois-je proposer une modification ? ». Attendez un oui ou un non.
4. Si la réponse est oui, rédigez uniquement la modification minimale (la section et les lignes exactes), montrez la diff et appliquez-la seulement après approbation.

N'améliorez, n'étendez et ne reformatez rien d'autre dans ces spécifications. Si à un moment quelconque la marche à suivre n'est pas claire, arrêtez-vous et demandez.