Chapitre 09 — Holy Book#

Documentation publique d’Ocarina. VitePress, FR + EN + RU, PDF générés par IA, plus de 40 skills exposés aux LLMs. URL : https://mojo-molotov.github.io/ocarina-holy-book/

Plan#

#FichierSujet
0101-stack-vitepress.mdVitePress 2 alpha + theme @sugarat + plugins maison + pagefind.
0202-i18n.mdI18n FR/EN/RU : structure des pages, conventions.
0303-skills/Les 40+ skills exposées aux IA, classées en familles.
0404-claude-md.mdCLAUDE.md / CLAUDE.slim.md exposés sur le site.
0505-pdf-generation.mdGénération des PDF FR/EN/RU via prompts/generate-books/
0606-public-resources.mdTableau des URLs publiques (llms.txt, llms-full.txt, PDFs, etc.).

Objectifs#

Le Holy Book existe aussi bien pour les humains que pour les LLMs :

  • Génère llms.txt / llms-full.txt au build (standards pour exposer du contenu aux LLMs).
  • Expose CLAUDE.md / CLAUDE.slim.md.
  • Sert les PDFs FR/EN/RU.
  • Documente 40+ skills accessibles aux outils comme Claude Code.

C’est l’incarnation pratique du « l’IA est le pont » (cf. ../01-philosophy/01-flip-the-problem.md).

Idéologie#

Pour autant, ce qu’il nous reste à présent, c’est le besoin d’un code de test lisible, traçable et flexible, sous sa forme la plus brute.

Avec l’IA, et des outils comme Claude Code, ce pari devient chaque jour plus solide.

Le Holy Book est l’outil qui rend ce pari opérationnel. Sans lui, un LLM aurait à deviner comment Ocarina marche. Avec lui : il consulte une doc qui lui est explicitement destinée.

Pages#

docs/fr/
├── index.md                                                      # Page d'accueil blog
├── what-is-it.md                                                 # Qu'est donc Ocarina ?
├── first-feedbacks.md                                            # Premiers retours
├── setup.md                                                      # Premiers pas
├── scenarios-composability.md                                    # Premiers scénarios
├── datasets-smoke-tests-setup-teardown-proxy-api-and-caching.md  # Premiers jutsus
├── handling-flakiness.md                                         # Premiers obstacles du monde réel
├── extensibility.md                                              # Extensibilité
└── using-ocarina-with-ai.md                                      # Utiliser Ocarina avec l'IA

Chaque page existe en EN aussi (docs/).
Ainsi qu’en RU (docs/ru).

Conventions de frontmatter VitePress :

---
sticky: 1
# pagefind-indexed: false
description: ...
date: 2026-04-24
head:
  - - meta
    - property: og:image
      content: http://...
---

Lectures connexes#