# 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.