# Les plans de Récit

Récit écrit une histoire une fois, en Markdown, et la raconte partout : deck, vidéo, page de
documentation, rapport, livre… Ce site rassemble **les plans** qui guident sa construction : ce qui
est décidé, comment c'est découpé, dans quel ordre on avance, et où on en est.

Les plans sont écrits en français et datés. Chacun a un rôle :

- un **plan** dit ce qu'on va faire et pourquoi, et porte en tête sa ligne de statut (`proposé`,
  `accepté`, `en cours`, `fait` ou `abandonné`), recopiée dans le tableau de bord ci-dessous ;
- le [registre des décisions](/decisions) dit ce qui a été tranché, une ligne par décision ;
- le [journal de reprise](/journal) dit où en est le travail et comment reprendre ;
- les [audits](/audits) disent ce qui ne va pas, constat par constat ;
- la vision publique, en anglais, est sur [vision.recit.dev](https://vision.recit.dev) ; la documentation produit
  sur [docs.recit.dev](https://docs.recit.dev).

## Tableau de bord

{/* plans:start — généré par node scripts/check-plans.js --write */}

| Plan                                                   | Statut   | Phase      | Mis à jour |
| ------------------------------------------------------ | -------- | ---------- | ---------- |
| [01 · Marque et images](/01-assets)                    | fait     | P0         | 25/10/2026 |
| [02 · Architecture](/02-architecture)                  | accepté  | transverse | 25/10/2026 |
| [03 · Packaging](/03-packaging)                        | accepté  | transverse | 02/11/2026 |
| [04 · Migration](/04-migration)                        | fait     | P1         | 24/10/2026 |
| [05 · Motion (vidéo)](/05-video)                       | fait     | P4         | 25/10/2026 |
| [06 · Feuille de route](/06-roadmap)                   | en cours | transverse | 02/11/2026 |
| [07 · Domaines et sites](/07-domaines)                 | en cours | P2         | 02/11/2026 |
| [08 · Report, toon, book…](/08-formats)                | accepté  | P6 à P11   | 02/11/2026 |
| [09 · Langues et JSON](/09-langues-et-json)            | fait     | P3         | 24/10/2026 |
| [10 · Formulaires](/10-formulaires)                    | accepté  | P13        | 24/10/2026 |
| [11 · Images](/11-images)                              | accepté  | P6 à P11   | 25/10/2026 |
| [12 · Glossaire et annuaire](/12-glossaire-annuaire)   | accepté  | P14        | 24/10/2026 |
| [13 · Cartes](/13-cartes)                              | accepté  | P15        | 24/10/2026 |
| [14 · IA et scénario](/14-ia-scenario)                 | accepté  | P16        | 25/10/2026 |
| [15 · Export PDF](/15-export-pdf)                      | accepté  | P6 à P8    | 24/10/2026 |
| [16 · Atelier de personnages](/16-atelier-personnages) | proposé  | P16        | 25/10/2026 |
| [18 · Desktop et mobile](/18-mobile-desktop)           | fait     | transverse | 29/10/2026 |
| [19 · Style : Mantine](/19-style)                      | fait     | transverse | 30/10/2026 |
| [20 · Exécution multi-agent](/20-multi-agents)         | accepté  | transverse | 29/10/2026 |
| [21 · Tests et Storybook](/21-tests)                   | fait     | transverse | 30/10/2026 |
| [22 · Alpha publique](/22-alpha)                       | proposé  | P5         | 02/11/2026 |
| [23 · Report](/23-report)                              | proposé  | P6         | 02/11/2026 |
| [24 · Webtoon](/24-webtoon)                            | proposé  | P7         | 02/11/2026 |
| [25 · Book](/25-book)                                  | proposé  | P8         | 02/11/2026 |
| [26 · Roadmap](/26-roadmap)                            | proposé  | P9         | 02/11/2026 |
| [27 · Calendar](/27-calendar)                          | proposé  | P10        | 02/11/2026 |
| [28 · Stories](/28-stories)                            | proposé  | P11        | 02/11/2026 |
| [29 · Version 1.0](/29-version-1)                      | proposé  | P12        | 02/11/2026 |

{/* plans:end */}

## Comment les plans s'articulent

L'architecture et le packaging en tirent le découpage ; les formats et les nouveaux blocs s'appuient
dessus ; la feuille de route les ordonne, et le journal suit l'avancement.

<Mermaid
  chart={`
mindmap
  root((Plans de Récit))
    Fondations
      01 · Marque
      02 · Architecture
      03 · Packaging
      04 · Migration
      07 · Domaines et sites
      18 · Desktop et mobile
      19 · Style : Mantine
      20 · Exécution multi-agent
      21 · Tests et Storybook
    Formats
      05 · Motion
      08 · Report, toon, book…
      09 · Langues et JSON
      15 · Export PDF
      23 · Report
      24 · Webtoon
      25 · Book
      26 · Roadmap
      27 · Calendar
      28 · Stories
    Nouveaux blocs et outils
      10 · Formulaires
      11 · Images
      12 · Glossaire et annuaire
      13 · Cartes
      14 · IA et scénario
      16 · Atelier de personnages
    Avancement
      06 · Feuille de route
      22 · Alpha publique
      29 · Version 1.0
      Décisions
      Journal de reprise
      Audits
`}
/>

## La chaîne de Récit

Le cœur ne connaît aucun format : il lit les sources et produit un modèle unique, `Story`, que
chaque format rend à sa façon. C'est le principe que détaille [02 · Architecture](/02-architecture).

<Mermaid
  chart={`
flowchart TB
  src["story.md / .mdx<br/>recit.config.ts"] --> core["@recit/core<br/>front matter, scènes, directives,<br/>config, thème, diagnostics"]
  core --> story(["Story { meta, settings, scenes }"])
  story --> deck["@recit/deck<br/>slides, présentateur, HTML, PDF"]
  story --> motion["@recit/motion<br/>films, rendu MP4"]
  story --> site["@recit/site-stories<br/>pages, embeds, recherche"]
  story --> next["report, toon, book,<br/>roadmap, calendar, stories<br/>(à venir)"]
  theme["@recit/theme · @recit/components"] -.-> deck
  theme -.-> motion
  theme -.-> site
  cli["@recit/cli · @recit/mcp"] -.-> core
`}
/>

## La feuille de route

Seize phases, chacune livrable seule. Les cinq premières sont faites ; l'alpha publique (P5) est la
prochaine ([22 · Alpha publique](/22-alpha)). Le détail et les critères de sortie sont dans
[06 · Feuille de route](/06-roadmap).

<Mermaid
  chart={`
flowchart TB
  subgraph D["Faites"]
    direction LR
    P0["P0 · Fondations"] --> P1["P1 · Deck"] --> P2["P2 · Sites"] --> P3["P3 · Story, JSON, langues"] --> P4["P4 · Motion"]
  end
  subgraph V["Vers la 1.0"]
    direction LR
    P5["P5 · Alpha"] --> P6["P6 · Report"] --> P7["P7 · Webtoon"] --> P8["P8 · Book"] --> P9["P9 · Roadmap"] --> P10["P10 · Calendar"] --> P11["P11 · Stories"] --> P12["P12 · 1.0"]
  end
  subgraph A["Après la 1.0"]
    direction LR
    P13["P13 · Formulaires"] --> P14["P14 · Annuaire"] --> P15["P15 · Cartes"] --> P16["P16 · Scénario"]
  end
  D --> V --> A
  classDef done fill:#dcfce7,stroke:#16a34a,color:#14532d
  classDef next fill:#ede9fe,stroke:#7c3aed,color:#3b0764
  class P0,P1,P2,P3,P4 done
  class P5 next
`}
/>

## Les plans, un par un

| Partie                   | Plan                                                   | En une phrase                                                                                       |
| ------------------------ | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Fondations               | [01 · Marque et images](/01-assets)                    | Le logo, une teinte par format et l'emplacement des images.                                         |
| Fondations               | [02 · Architecture](/02-architecture)                  | Le modèle `Story`, la syntaxe commune et le pont entre formats.                                     |
| Fondations               | [03 · Packaging](/03-packaging)                        | Tous les paquets, leurs groupes et le sens de leurs dépendances.                                    |
| Fondations               | [04 · Migration](/04-migration)                        | Ce qui a été repris de presentation-engine, et comment.                                             |
| Fondations               | [07 · Domaines et sites](/07-domaines)                 | Un site par format sous `recit.dev`, et leur déploiement.                                           |
| Fondations               | [18 · Desktop et mobile](/18-mobile-desktop)           | Une application native par site, depuis la coquille Tauri commune.                                  |
| Fondations               | [19 · Style : Mantine](/19-style)                      | Tout le style en Mantine et en modules CSS, avec captures avant/après.                              |
| Fondations               | [20 · Exécution multi-agent](/20-multi-agents)         | Agents en parallèle sur un arbre : limites mesurées, rôles, portes, découpage des vagues.           |
| Fondations               | [21 · Tests et Storybook](/21-tests)                   | Storybook comme spécification exécutable : stories, `play`, a11y et captures pour chaque composant. |
| Formats                  | [05 · Motion](/05-video)                               | La vidéo : le format `motion`, ses phases et ses risques.                                           |
| Formats                  | [08 · Report, toon, book…](/08-formats)                | Les six formats suivants, chacun avec son site.                                                     |
| Formats                  | [09 · Langues et JSON](/09-langues-et-json)            | Un récit, plusieurs représentations et plusieurs langues.                                           |
| Formats                  | [15 · Export PDF](/15-export-pdf)                      | Les pages en PDF pour tous les formats qui s'impriment.                                             |
| Formats                  | [23 · Report](/23-report)                              | Le rapport : P6 et report.recit.dev.                                                                |
| Formats                  | [24 · Webtoon](/24-webtoon)                            | Le webtoon (`toon`) : P7 et webtoon.recit.dev.                                                      |
| Formats                  | [25 · Book](/25-book)                                  | Le livre : P8 et book.recit.dev.                                                                    |
| Formats                  | [26 · Roadmap](/26-roadmap)                            | La feuille de route comme format : P9 et roadmap.recit.dev.                                         |
| Formats                  | [27 · Calendar](/27-calendar)                          | Le calendrier : P10 et calendar.recit.dev.                                                          |
| Formats                  | [28 · Stories](/28-stories)                            | Les stories web : P11 et story.recit.dev.                                                           |
| Nouveaux blocs et outils | [10 · Formulaires](/10-formulaires)                    | Le bloc `:::form` et son contrat d'API.                                                             |
| Nouveaux blocs et outils | [11 · Images](/11-images)                              | Des images générées en JS pour motion et stories.                                                   |
| Nouveaux blocs et outils | [12 · Glossaire et annuaire](/12-glossaire-annuaire)   | Les formats `glossary` et `directory`.                                                              |
| Nouveaux blocs et outils | [13 · Cartes](/13-cartes)                              | Le bloc `::map` et le format `atlas`.                                                               |
| Nouveaux blocs et outils | [14 · IA et scénario](/14-ia-scenario)                 | Le scénariste, le MCP et la bible de personnages.                                                   |
| Nouveaux blocs et outils | [16 · Atelier de personnages](/16-atelier-personnages) | La recherche sur un atelier de personnages.                                                         |
| Avancement               | [06 · Feuille de route](/06-roadmap)                   | Les phases P0 à P16, leurs livrables et leurs critères de sortie.                                   |
| Avancement               | [22 · Alpha publique](/22-alpha)                       | P5 : les packages publiés sous un tag de préversion.                                                |
| Avancement               | [29 · Version 1.0](/29-version-1)                      | P12 : ce que la 1.0 promet, et comment on le prouve.                                                |
| Avancement               | [Registre des décisions](/decisions)                   | Ce qui a été tranché, une ligne par décision.                                                       |
| Avancement               | [Journal de reprise](/journal)                         | Où en est le travail, et comment reprendre.                                                         |
| Audits                   | [Audit technique](/audits)                             | 163 constats sur le code, les tests et la release, et leur plan d'action.                           |
| Audits                   | [Audit de design](/audits#audit-de-design)             | 44 constats sur le rendu, captures à l'appui.                                                       |