Journal de Bureau
Gérer le journal d'un bureau — la mémoire persistante qui survit aux changements de session.
Quand l'utiliser
- Fin de session : Noter ce qui a été fait, l'état actuel, l'étape suivante
- Début de session : Lire le journal pour reprendre où vous aviez laissé
- Point de contrôle en cours de session : Noter les progrès ou décisions importants
- Clôture du bureau : Rédiger un résumé final quand un bureau est fermé
Comment rédiger une entrée de journal
Ajouter à desks/<desk-name>/journal.md. Chaque entrée est une section :
## <date> — <résumé court>
- **Travaux réalisés :** <ce qui a été fait cette session>
- **État actuel :** <où en sont les choses maintenant>
- **Étape suivante :** <ce que la prochaine session devrait poursuivre>
Directives
- Être spécifique. « Travaux sur le scan de sécurité » est inutile pour la prochaine session. « Scan des repos A, B, C pour CWE-502 ; 3 findings trouvés dans A, 0 dans B et C ; findings triés au bench » — voilà une piste.
- Inclure ce qui n'a pas fonctionné. Les impasses sont précieuses — elles empêchent la prochaine session de suivre le même chemin.
- Rester concis. Le journal est un marqueur de piste, pas un journal intime. 3-5 lignes par entrée. Si vous avez besoin de plus, le contexte important devrait aller sur le bench comme artifact distinct.
- Toujours inclure l'étape suivante. La prochaine session part de zéro. Sans étape suivante, elle doit tout redériver.
Entrée de fin de bureau
Quand un bureau est en cours de fermeture (pas juste une session qui se termine, mais le bureau lui-même qui ferme) :
## <date> — Bureau fermé
- **Résumé :** <ce que ce bureau a accompli globalement>
- **Artifacts :** <ce qui est sur le bench de ce bureau>
- **Passation :** <tout ce qu'un autre bureau ou l'opérateur doit savoir>
Lire le journal
Au début d'une session, lire le journal du bureau pour reprendre le contexte. L'entrée la plus récente est la plus importante — elle contient l'état actuel et l'étape suivante. Les entrées antérieures fournissent l'historique si nécessaire.
Principes
- Le journal est un cairn — des pierres laissées pour que le prochain voyageur trouve le chemin. Chaque entrée est une pierre.
- L'honnêteté plutôt que l'exhaustivité. « Je suis resté bloqué sur X et je ne sais pas pourquoi » est plus utile que le silence.
- Le journal est pour la prochaine session, pas pour celle-ci. Écrivez pour quelqu'un qui ne sait rien de ce que vous venez de faire.