Ustagammon/docs/journal.md

Journal

Une entrée datée par session : ce qui a été fait, décidé, et la suite.

2026-11-02

Fait

• Dépôt initialisé (branche main) avec le kit de démarrage : CLAUDE.md, docs/cadrage.md, docs/etape-0.md, PROMPTS.md.
• Nom de l'application reporté partout : Ustagammon (lien vers le brief créatif dans CLAUDE.md et docs/cadrage.md).
• Squelette : Makefile (help, setup, build, test, lint, deploy, clean), LICENSE (GPLv3), CREDITS.md, README.md, .gitignore, ce journal, docs/decisions.md.
• Premiers tests : contrat du Makefile (tests/test_makefile.sh) ; lint du dépôt (tests/lint.sh, avec ShellCheck dans Docker).
• main poussé sur Gitea (git@git.sans.pub:pierre/Ustagammon.git), après fusion avec le commit initial créé par Gitea (LICENSE et README). Incident : le premier envoi contenait un README.md avec des marqueurs de conflit ; corrigé, et make lint les détecte désormais.
• PROMPTS.md supprimé ; ajout de docs/organisation.md, docs/feuille-de-route.md et docs/plans/.
• Étape 0a.1 lancée : étude des trois sources du moteur confiée à un sous-agent (docs/plans/2026-11-02-choix-source-moteur.md), puis clôturée avec vérification des points clés par la session principale.

Décidé

• Les outils de lint tournent dans Docker, comme les autres chaînes d'outils.
• Claude Code pilote le projet par sous-agents ; tout le suivi est dans docs/.
• Moteur : gnubg officiel, commit 14b6798 (validé par Pierre).
• Toute modification passe par une merge request Gitea décrite en détail, fusionnée par Claude Code une fois make lint et make test au vert (demande de Pierre).
• Les décisions passent dans des ADR (docs/adr/) ; docs/decisions.md est remplacé par les ADR 0001 à 0006. Plans et feuille de route deviennent temporaires : le plan du choix du moteur est supprimé, son contenu durable est dans l'ADR 0005 (demande de Pierre).
• Les hash de commit s'écrivent sans backticks, pour les liens automatiques de Gitea (demande de Pierre).

Incident (clos)

• Les MR fusionnées restaient « open » dans Gitea : les hooks git du serveur ne s'exécutaient plus, sur toute l'instance (diagnostic par un sous-agent, en lecture seule ; brief transmis à Pierre). Pierre a réparé les hooks et marqué les MR !1 à !8 comme fusionnées. Les branches fusionnées ont été supprimées du serveur.

Suite de la session (après-midi)

• ADR 0007 (architecture et conventions de code) et ADR 0008 (glossaire et scénarios, source unique), puis amendements : scénarios en Gherkin standard validés par l'analyseur officiel, ADR amendables (0001).
• Étape 0a terminée, par sous-agents : gnubg de référence et 32 positions (0a.2, MR !6) ; moteur embarqué, engine.h et engine-cli (0a.3, MR !7) ; comparaison automatique aux références, tolérance 0,002, deux défauts du moteur corrigés (0a.4, MR !8).
• Outils de compilation et de test validés par Pierre (amendement de l'ADR 0004).
• Étape 0b : moteur en WebAssembly, même suite de contrat (écart maximal 9,5e-4), 7,3 Mo compressés, page de test et de mesure, make deploy-web, guide de test docs/guide-test-etape-0.md.

Reste à faire

• Mesures sur le Fairphone 4 avec Pierre, puis décision du socle (ADR).
• Étape 0d : plateau minimal jouable sur le socle retenu.
• adb n'est pas installé sur le PC : sudo apt install adb avant les tests sur le téléphone.