09.04 — CLAUDE.md et CLAUDE.slim.md#

Le Holy Book publie activement les fichiers CLAUDE.md. Cela permet à un LLM de récupérer la doc projet sans passer par le repo.

Les deux fichiers#

ai/
├── CLAUDE.md       # version complète (règles + organisation projet)
└── CLAUDE.slim.md  # version courte (règles uniquement)

URLs publiques#

https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.md
https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.slim.md

Citation du Holy Book (chapitre « Utiliser Ocarina avec l’IA ») :

Slim quand le contexte est chargé ; complet pour l’onboarding et les revues. En cas de divergence, le complet l’emporte.

Différences Slim/Full#

Le bon fichier au bon moment#

Onboarding (premier contact avec le projet)  →  CLAUDE.md  (lit tout)
Run normal (juste appliquer les règles)       →  CLAUDE.slim.md (économise tokens)
Revue de PR                                   →  CLAUDE.md (justifications)
Audit profond                                 →  CLAUDE.md (tout)

CLAUDE.md#

Sections type (basées sur ocarina-with-ai-example) :

1. Project context : repo, framework, SUT.
2. Project philosophy : « No tricks or hacks », « Teach the pattern, not the symptom ».
3. Layout : arbre complet du repo.
4. Conventions : 12+ règles concrètes.
5. Hard-won rules : leçons tirées d’échecs passés.
6. Test strategy : structure du cycle.
7. Running tests : commandes CLI.
8. Reports and screenshots : règles d’usage.
9. Scenario fragments : critères d’extraction.
10. Data-driven tests : conventions.
11. Conventions complémentaires.

CLAUDE.slim.md#

Juste les règles (sans justifications détaillées, sans exemples) :

# Slim rules — Ocarina with AI example

- No tricks or hacks. Polling fix > JS click bypass.
- Teach the pattern, not the symptom.
- Tests sécurité : fonctionnels et statiques, jamais actifs.
- Utiliser des constantes : pas de magic numbers.
- Datasets : décision humaine ; propose, pas exécute.
- Vérifier empiriquement le SUT avant d'encoder.
- Re-dériver à chaque exécution : pas d'héritage de diagnostic.
- One scenario per file (data-driven exception).
- Top docstring as arrows flow.
- All create_selenium_test() at bottom of file.
- POM selectors at top of class.
- Always WebDriverWait, never raw find_element.
- Implicit wait set by CLI, never patched in POM/test code.
- Tests gap : reformulés, pas basculés au vert.
- Watcher signals : negatifs uniquement.
- Distribué quand ressource partagée.
- Mtime pas nom de fichier.
- ...

→ Chaque ligne = une règle.

Pourquoi exposer aux LLMs#

La distinction doc utilisateur vs doc LLM#

→ Trois audiences, trois formats. Le Holy Book sert les trois. C’est l’incarnation pratique de « l’IA est le pont ».

Pattern « ressources canoniques »#

Les URLs sont stables :

https://mojo-molotov.github.io/ocarina-holy-book/llms.txt
https://mojo-molotov.github.io/ocarina-holy-book/llms-full.txt
https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.md
https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.slim.md
https://mojo-molotov.github.io/ocarina-holy-book/ocarina-ru.pdf
https://mojo-molotov.github.io/ocarina-holy-book/ocarina-en.pdf
https://mojo-molotov.github.io/ocarina-holy-book/ocarina-fr.pdf

Documentées dans le Holy Book (chapitre « Utiliser Ocarina avec l’IA »), à la fin :

Ressources exposées#

• https://mojo-molotov.github.io/ocarina-holy-book/llms.txt
• https://mojo-molotov.github.io/ocarina-holy-book/llms-full.txt
• https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.md
• https://mojo-molotov.github.io/ocarina-holy-book/CLAUDE.slim.md
• https://mojo-molotov.github.io/ocarina-holy-book/ocarina-ru.pdf
• https://mojo-molotov.github.io/ocarina-holy-book/ocarina-en.pdf
• https://mojo-molotov.github.io/ocarina-holy-book/ocarina-fr.pdf