Chaque projet a les mêmes pages, dans le même ordre. But : comprendre le projet sans son auteur, et retrouver pourquoi une chose a été faite avant de la modifier.
Tout est rangé sous /projets/<projet>.
| Page | Chemin | Contenu |
|---|---|---|
| Fiche | /projets/<projet> |
En 30 secondes : à quoi sert l'app, pour qui, état, liens (stores, dépôt, Kaneo, consoles), chiffres clés et où les lire |
| Partie 1 — L'existant | ||
| Fonctionnement | …/fonctionnement |
Parcours de l'utilisateur pas à pas, écrans, offre gratuite / payante, pays et langues, mots du projet |
| Règles métier | …/regles-metier |
Les règles numérotées (voir plus bas) |
| Technique | …/technique |
Architecture, dossiers du dépôt, services, fonctions serveur, réglages à distance, données stockées, briques partagées |
| Exploitation | …/exploitation |
Publier, déployer, surveiller, pièges connus, accès (où sont les clés, jamais les clés) |
| Partie 2 — Le projet | ||
| En cours | …/en-cours |
Chantiers et tickets ouverts, prochaines étapes, blocages, questions ouvertes |
| Décisions | …/decisions |
Journal des décisions numérotées (voir plus bas) |
| Études | …/etudes/<sujet> |
Une page par étude : question, options, mesures, recommandation, décision |
En tête de chaque page : « État au JJ/MM/AAAA » et les sources (fichiers du dépôt, tickets).
RM-<CLÉ>-NNUne règle = un comportement voulu de l'app (ex. « une analyse débite les crédits seulement si elle réussit »).
| Champ | Contenu |
|---|---|
| N° | RM-CLN-04 (clé Kaneo du projet + numéro, jamais réutilisé) |
| Règle | La phrase, en clair |
| Pourquoi | La raison, ou le lien vers la décision D-… |
| Où | Fichier(s) du code, réglage à distance |
| Depuis | Date ou version |
D-<CLÉ>-NNN| Champ | Contenu |
|---|---|
| N° et date | D-CLN-012 · 06/11/2026 |
| Décision | Ce qui est décidé |
| Pourquoi | Le constat, les chiffres, la contrainte |
| Écarté | Les autres options, et pourquoi pas elles |
| Conséquences | Ce que ça change, ce qu'il faudra surveiller |
| Liens | Ticket Kaneo, PR, étude |
On ne supprime jamais une décision : si elle change, la nouvelle dit « remplace D-CLN-012 », et l'ancienne est marquée « remplacée par D-CLN-020 ».
RM-CLN-04, D-CLN-012.| Événement | Pages à mettre à jour |
|---|---|
| Étude terminée | L'étude (résultat), Décisions, En cours |
| Ticket livré (À valider / Terminé) | En cours ; Règles métier et Technique si le comportement change ; Décisions si un choix a été fait |
| Décision en conversation | Décisions (+ Règles métier si besoin) |
| Nouvelle date | Échéances |
| Où | Pour qui | Contenu |
|---|---|---|
| Wiki | humains (associé, client, développeur, famille) | le quoi et le pourquoi |
memory-bank/ du dépôt |
Claude et les développeurs | le comment détaillé, le point de reprise technique |
| Kaneo | tout le monde | les tâches au jour le jour |
Le wiki ne recopie pas les tickets : il donne leur clé et leur état à la date indiquée.
Ce qui n'a pas pu être vérifié est marqué « À vérifier ». Une doc fausse est pire qu'un trou.