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 ouvert

• La MR !1 a bien été fusionnée côté git (commit de fusion 6958acc sur main), mais Gitea l'affiche toujours « open ». Cause non établie ; la base de données du serveur refuse déjà les émojis (erreur MySQL 1366), piste à vérifier dans les journaux de Gitea.

Reste à faire

• Étape 0a.2 : image Docker de gnubg de bureau compilé depuis le même commit, et 30 positions de référence ou plus.
• adb n'est pas installé sur le PC : sudo apt install adb avant les tests sur le téléphone.