Sheets en playbook
Dépôt : le dossier contenant ingest/ingest.py (le projet actuel, si Claude Code a été ouvert dans le clone). Tous les chemins ci-dessous lui sont relatifs. Lisez ingest/RAW_FORMAT.md avant l'étape 3 : il contient le format de transcription et les règles d'écriture du playbook.
L'objectif est la rapidité le jour même sans rien inventer. Chaque ligne du site doit provenir d'une photo ou d'une note vocale ; ingest.py verify l'impose.
Dites à l'utilisateur ce que vous faites à chaque étape en une ou deux lignes. Les durées ci-dessous sont des indications approximatives pour une douzaine de tables.
Avant le jour J, playbook.config.json doit nommer les organisateurs et donner l'adresse web du playbook (le code QR de la carte d'engagement y pointe). S'il contient encore les valeurs par défaut neutres, signalez-le, mais continuez : les réglages ne changent que les noms et les couleurs, jamais le contenu. --config <fichier> sur verify, draft et publish choisit un fichier de configuration différent.
1. Préparer (1 à 2 minutes)
python3 ingest/ingest.py prepare "<dossier>"
python3 ingest/ingest.py transcribe # seulement si le dossier contient des notes vocales ; lancez-le en arrière-plan
prepare crée un nouveau dossier sous runs/ (et pointe runs/latest vers lui) : photos redressées, HEIC converti, un score de netteté par photo, des tuiles 2x2 pour la lecture rapprochée, des planches contact dans contact/, et les notes vocales converties en WAV 16 kHz. transcribe utilise Whisper local (small.en, hors ligne après téléchargement) et devine la table de chaque note à partir de "Table sept…" au début.
Un deuxième lot (plus de photos, ou les cartes, après que la première moitié est en cours) : python3 ingest/ingest.py prepare "<dossier>" --into <run> les ajoute au même dossier. Les nouveaux identifiants continuent à partir du dernier (P022…), les étiquettes et les fichiers bruts sont conservés, et les fichiers déjà dans le dossier sont ignorés. Ensuite, étiquetez uniquement les nouveaux identifiants.
2. Étiqueter et vérifier la couverture (environ 5 minutes ; faites-le d'abord, c'est critique en temps)
Regardez chaque planche contact (contact/sheet-*.jpg) et, si une vignette n'est pas claire, la photo dans view/. Écrivez labels.json dans le dossier du run :
{"photos": {"P001": {"table": 7, "sheet": "S2"}, "P014": {"kind": "stubs"}, "P020": {"kind": "other", "note": "photo de la salle"}},
"audio": {"A01": {"table": 7, "by": "speech"}}}
- Chaque feuille porte un code imprimé dans le coin inférieur (S1, S2, S3, SS) et des titres imprimés ; le numéro de table est écrit à la main par le responsable de table, dans le cercle en haut à droite et à côté du code (
S2 · Table 7). Les titres par défaut du kit : S1 « Où le soutien se bloque-t-il ? », S2 « Qu'est-ce qui a aidé, ou pas ? », S3 « Que pourraient essayer les gens maintenant, et comment cela tient-il ? », SS la feuille latérale « Vous avez entendu quelque chose de bien ? Notez-le ici. » (Citations · Questions · Ressources). Si les organisateurs ont modifié les questions, basez-vous sur le code imprimé. Lorsque le cercle et le coin sont en désaccord, la couleur du stylo et le contenu tranchent : vérifiez les autres feuilles de la table. - Conservez toutes les étiquettes audio que
transcribea déjà remplies, après les avoir vérifiées par rapport à la première ligne de la transcription. - Deux feuilles différentes avec le même code et le même numéro de table (
statusliste toute feuille avec plus d'une photo : vérifiez-les) : si les pays et le contenu se recoupent, c'est une table qui a utilisé deux exemplaires ; étiquetez les deux avec le numéro et le lecteur transcrit les deux. S'il s'agit clairement de deux tables, donnez à la seconde un numéro libre à partir de 91, ajoutez"note": "a écrit 22 ; deuxième table"et informez l'utilisateur. L'une ou l'autre peut être « la seconde » : choisissez-en une et décrivez les deux dans les notes (secteur, couleur du stylo) afin que la relecture puisse les distinguer. - Un gros plan sans numéro de table visible (juste la case de pointage, par exemple) : étiquetez-le avec la feuille qu'il correspond et ajoutez
"note": "table inférée à partir de <ce qui correspond>". - Deux feuilles dans une seule photo (épinglées côte à côte) : étiquetez-le
"sheet": ["S2", "S3"]pour questatusle compte pour les deux, et mentionnez-le dans unenotepour que le lecteur sache quelle moitié est laquelle. preparene peut pas redresser une photo qui est à l'envers dans le cadre (il n'y a pas de drapeau de rotation à lire). Les lecteurs s'en accommodent, mais mentionnez-le dans unenote. Les photos de cartes ont un score de netteté inférieur à celui des feuilles (carte unie, stylo fin), alors vérifiez une carte marquée FLOUE dansview/avant de demander une reprise.
Exécutez ensuite python3 ingest/ingest.py status (ajoutez --tables <n> s'il n'y avait pas 12 tables) et informez immédiatement l'utilisateur de toute feuille MANQUANTE ou FLOUE. Les planches contact taguent également BASSE-RÉSOLUTION (transférée via une application de messagerie : acceptable si l'écriture est grande) et SOMBRE (généralement lisible) : mentionnez-les, mais ce ne sont pas des reprises. Idéalement, cette vérification a lieu pendant que les feuilles sont encore au mur et peuvent être photographiées à nouveau.
3. Transcrire chaque table (en parallèle, environ 5 à 10 minutes)
Lancez un sous-agent par table (outil Agent, general-purpose, en arrière-plan, tous dans un seul message), plus un pour les talons de cartes s'il y en a. Ne réduisez pas la qualité du modèle : la précision de l'écriture manuscrite est cruciale. Chaque invite doit être autonome et inclure :
- Le chemin absolu du dépôt, le dossier du run, le numéro de table, ses identifiants photo (
view/<id>.jpget les tuiles listées dansmanifest.json), et le chemin de sa transcription vocale s'il y en a. - "Lisez
ingest/RAW_FORMAT.md, étape 1, et suivez-la exactement. Écrivezraw/T<nn>.jsondans le dossier du run, puis exécutezpython3 ingest/ingest.py verify --run <run>et corrigez toute erreur qu'elle signale à propos de votre fichier. Répondez avec un court résumé : éléments par feuille, chaque entréeunclearet chaque mot barré que vous avez omis." - Pour les talons : écrivez
raw/commitments.jsoncomme décrit à la fin de l'étape 1, en incluant le nom et l'organisation facultatifs de la carte exactement comme écrits, et en suivant les règles relatives aux cartes qui y sont décrites (cartes non déchirées, signatures, une carte sur deux photos).
Pendant leur exécution, lisez vous-même les transcriptions vocales (s'il y en a) pour connaître la salle avant d'écrire.
4. Écrire le playbook (environ 10 à 15 minutes)
Suivez l'étape 2 de RAW_FORMAT.md. Écrivez <run>/session.json avec meta.status: "draft". Commencez meta à partir de examples/session-template.json et renseignez les détails de l'événement (nom de l'événement, date, lieu) d'après ce que l'utilisateur vous dit ; définissez people sur le nombre réel de participants s'il le connaît. Ne devinez jamais ces informations : laissez un champ tel qu'il est dans le modèle et listez-le pour l'utilisateur.
5. Vérifier, corriger, construire le pack de relecture
python3 ingest/ingest.py verify --links
python3 ingest/ingest.py draft # <run>/playbook-draft.html : cadres en pointillés = lacunes, étiquettes = sources
python3 ingest/ingest.py review # <run>/review.html : chaque élément à côté de ses photos
Corrigez chaque erreur (une ligne introuvable, une citation déviée, un nom laissé) et réexécutez jusqu'à ce que verify réussisse. Les avertissements sont destinés à la relecture humaine : signalez-les, ne les masquez pas.
Ensuite, donnez à l'utilisateur le résumé de la relecture : les défis et les tables fusionnées, chaque lecture unclear avec son identifiant photo, chaque mot barré qu'un lecteur a omis, les éléments bruts inutilisés, les problèmes de liens, et tout ce dont vous n'étiez pas sûr quant au regroupement. review.html montre les notes de chaque lecteur et le décompte « Qui est à cette table ? » sous chaque table. Ouvrez review.html et playbook-draft.html pour eux.
Beaucoup de mots incertains ? L'application de relecture est plus rapide que de lire review.html de haut en bas : python3 tools/review/make_review.py --run <run> construit <run>/review/index.html, une carte par lecture incertaine avec un gros plan de l'écriture manuscrite. L'utilisateur confirme ou corrige chaque cas, enregistre un fichier de décisions, et python3 tools/review/apply_review.py --run <run> <decisions.json> réécrit les lectures dans les fichiers bruts et session.json. Relancez verify et draft ensuite. Les questions qui ne sont pas un mot incertain (une coche qui pourrait être un rature, s'il faut fusionner deux tables, s'il faut nommer une ressource) vont dans <run>/review/extra.json comme vérifications et décisions avant de construire l'application ; apply_review.py liste les réponses dans <run>/review/to-action.md pour que vous agissiez. Voir tools/review/README.md.
6. Publier (après qu'un humain a vérifié l'ébauche)
Appliquez les corrections des relecteurs à session.json, définissez meta.status sur "final", puis :
python3 ingest/ingest.py publish --links # refuse si quoi que ce soit est introuvable ou si une section est vide
Ceci écrit data/session.json et playbook/index.html. Le dossier playbook/ est un site statique : le déployer où que ce soit est une étape distincte, alors demandez d'abord. Chaque lien dans la page est géré par script, donc elle fonctionne également ouverte directement depuis le disque.
Jamais
- Ajouter du contenu issu de connaissances générales, même un contexte « utile ». Mieux vaut vide qu'inventé.
- Deviner un mot en silence : utilisez
[?mot]ou[illisible]et listez-le. - Mettre le nom d'une personne ou d'un employeur sur la page publiée, sauf le nom et l'organisation propres d'un engagement que la personne a écrits sur sa carte (
verifyles vérifie par rapport à la carte). - Publier sans que
verifyréussisse et qu'un humain ait lu l'ébauche.
Après
Les photos et notes vocales peuvent contenir des noms et des visages. Une fois le playbook finalisé, rappelez à l'utilisateur de supprimer runs/*/audio, les photos sources et notes vocales, ainsi que tout autre élément que les organisateurs ont convenu de ne pas conserver.