Chapter 09 — Holy Book#

Ocarina’s public documentation. VitePress, FR + EN + RU, AI-generated PDFs, 40+ skills exposed to LLMs. URL: https://mojo-molotov.github.io/ocarina-holy-book/

Outline#

#FileTopic
0101-stack-vitepress.mdVitePress 2 alpha + @sugarat theme + in-house plugins + pagefind.
0202-i18n.mdI18n FR/EN/RU: page structure, conventions.
0303-skills/The 40+ skills exposed to AIs, grouped into families.
0404-claude-md.mdCLAUDE.md / CLAUDE.slim.md exposed on the site.
0505-pdf-generation.mdFR/EN/RU PDF generation via prompts/generate-books/.
0606-public-resources.mdTable of public URLs (llms.txt, llms-full.txt, PDFs, etc.).

Goals#

The Holy Book exists as much for humans as for LLMs:

  • Generates llms.txt / llms-full.txt at build (standards for exposing content to LLMs).
  • Exposes CLAUDE.md / CLAUDE.slim.md.
  • Serves the FR/EN/RU PDFs.
  • Documents 40+ skills accessible to tools like Claude Code.

The practical embodiment of “AI is the bridge” (cf. ../01-philosophy/01-flip-the-problem.md).

Ideology#

The Holy Book (chapter “First feedbacks”):

Code is raw data. Auditable. Inspectable. A white box. Exactly what AI has known how to work with since its very beginnings.

The Holy Book operationalizes this bet. Without it, an LLM has to guess how Ocarina works. With it, it consults documentation written explicitly for it.

Pages#

docs/
├── index.md                                                      # Blog landing
├── what-is-it.md                                                 # What is Ocarina?
├── first-feedbacks.md                                            # First feedbacks
├── setup.md                                                      # First steps
├── scenarios-composability.md                                    # First scenarios
├── datasets-smoke-tests-setup-teardown-proxy-api-and-caching.md  # First jutsus
├── handling-flakiness.md                                         # First real-world hurdles
├── extensibility.md                                              # Extensibility
└── using-ocarina-with-ai.md                                      # Using Ocarina with AI

Each page also exists in FR (docs/fr/).
And in RU (docs/ru/).

VitePress frontmatter conventions:

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