English · 한국어 · 日本語 · 中文 · Español · Français · Deutsch · Português
**Construisez des livres comme du logiciel.** Un pipeline multi-phases qui transforme la connaissance longue-forme —livres, RFC, livres blancs, docs de design, guides techniques— en artefacts structurés, pas en prompts isolés. De la page blanche à l'EPUB/PDF publiable. `Phase 0: Onboarding → Phase 1: Ideation → Phase 2: Outlining → Phase 3: Drafting → Phase 4: Editing → Phase 5: Publishing`
## Pourquoi Velith ?
Écrire un livre avec des prompts LLM bruts produit des chapitres déconnectés, une voix incohérente et aucune structure. Velith fournit un **pipeline planifier-puis-exécuter** — valider avant d'écrire, contrôler la qualité à chaque phase et maintenir la continuité tout au long du manuscrit.
## Benchmark
Ce que le pipeline fait aux entrées non structurées — [essayez par vous-même →](https://huggingface.co/spaces/epicsaga/Velith)
| Métrique | Entrée brute | Après le pipeline Velith |
|---------|-------------|--------------------------|
| Score de structure | 2–4 / 10 | 6–9 / 10 |
| Redondance | 20–45% de chevauchement n-gram | < 10% après consolidation |
| Marqueurs AI-slop | 6–20 pour 1 000 mots | Détectés et supprimés par style-doctor |
| Hiérarchie des chapitres | Aucune | Détectée + cartographiée avec références croisées |
| Score de cohérence | 0,3–1,5 / 10 | Amélioré par restructuration de sections |
| | Fonctionnalité | Pourquoi c'est important |
|--|---------------|--------------------------|
| 📋 | Pipeline en 6 phases | Chaque phase valide avant de continuer — pas de retravail |
| 📖 | 7 modèles de genre | Fiction, non-fiction, technique, scénario, poésie, jeu, académique (+ personnalisé via genre-creator) |
| 🤖 | 8 agents spécialisés | Architecture, rédaction, génération de scènes, continuité, style, couverture, illustrations, marketing |
| ✏️ | Édition en 5 étapes | Évaluation → Développement → Ligne → Correction → Relecture finale |
| 🔄 | Reprendre n'importe où | Ignorer les chapitres terminés, reprendre là où vous vous êtes arrêté |
| 📦 | EPUB, PDF, MOBI, TXT, Markdown | Fichiers prêts à publier via Pandoc + Calibre |
## Un pipeline, plusieurs artefacts
Velith est livré comme un pipeline de livres, mais les mêmes 6 phases s'appliquent à **toute connaissance longue-forme structurée**. Que l'artefact soit un roman de 300 pages ou un RFC de 12 pages importe peu — le flux plan-then-execute, les portes de qualité et les agents sont identiques.
| Artefact | Skill de genre | Sortie typique |
|----------|-------------|----------------|
| Roman / Histoire | `book-fiction` | EPUB / PDF / MOBI |
| Livre non-fiction | `book-nonfiction` | EPUB / PDF |
| RFC / Doc de design | `book-technical` | Markdown / PDF |
| Livre blanc / Rapport de recherche | `book-academic` | PDF (citations) |
| Support de cours / Tutoriel | `book-technical` | EPUB / PDF |
| Scénario de jeu / Lore bible | `book-game` | Markdown / EPUB |
## Comparaison
| | Velith | Prompts bruts | Notion AI | Jasper / Sudowrite | Scrivener |
|--|-----------|-------------|-----------|-------------------|-----------|
| Validation de structure | Pipeline par phases | Aucune | Aucune | Modèles basiques | Manuelle |
| Continuité entre chapitres | Agent dédié | Manuelle | Aucune | Limitée | Manuelle |
| Détection AI-slop | Intégrée (style-doctor) | Aucune | Aucune | Aucune | Aucune |
| Conscience du genre | 8 systèmes de genre + personnalisé | Dépend du prompt | Aucune | Centré sur la fiction | Aucune |
| Format de sortie | EPUB, PDF, MOBI, TXT, Markdown | Copier-coller | Markdown / PDF | DOCX, limité | DOCX, PDF |
| Contrôle qualité | Chaque phase | Aucun | Aucun | Aucun | Aucun |
| Nécessite | Claude Code, Codex CLI, Agy, Cursor, Cline ou Aider | N'importe quel LLM | Abonnement Notion | Abonnement | Licence |
| Contrôle total | Au niveau du prompt | Total | Boîte noire | Boîte noire | Total |
## Installation
### Claude Code
```bash
# Ajouter le marketplace epicsagas (première fois)
claude plugin marketplace add epicsagas
# Installer velith
claude plugin install velith@epicsagas
```
**Prérequis :** CLI [Claude Code](https://claude.ai/code) installé et authentifié.
### Codex CLI (OpenAI)
```bash
codex plugin marketplace add epicsagas/plugins
```
**Prérequis :** [Codex CLI](https://github.com/openai/codex) installé et configuré avec une clé API OpenAI.
### Agy (Antigravity)
```bash
agy plugin install https://github.com/epicsagas/Velith
```
Agy découvre automatiquement les skills et agents depuis la racine du dépôt. Aucune configuration supplémentaire nécessaire.
**Prérequis :** [Agy](https://antigravity.google/docs/cli-install) installé et configuré.
### Cursor
Velith fournit des règles de contexte dans `.cursor/rules/` qui donnent à l'agent de Cursor une connaissance complète du pipeline de publication, des modèles de genre et des standards d'édition. Les règles se chargent automatiquement à l'ouverture d'un projet de livre dans Cursor.
**Prérequis :** [Cursor](https://cursor.sh) installé.
### Cline
Velith fournit des instructions au niveau du projet dans `.clinerules` à la racine du dépôt. Cline les lit automatiquement lors du travail dans le répertoire du projet.
**Prérequis :** Extension [Cline](https://github.com/cline/cline) installée dans VS Code ou JetBrains.
### Aider
Velith fournit des conventions d'écriture dans `CONVENTIONS.md`, auto-chargées via `.aider.conf.yml`.
```bash
aider # CONVENTIONS.md est auto-chargé
```
**Prérequis :** [Aider](https://aider.chat) installé et configuré avec une clé API.
## Démarrage Rapide
```bash
# Démarrer un nouveau projet de livre
> /book-init
# Détecter automatiquement la phase actuelle et continuer
> /loom
```
Le plugin vous guide à travers :
1. **Onboarding** — Genre, audience, langue, matériel source, guide de style
2. **Ideation** — Étude de marché, distillation de concepts, titres concurrents
3. **Outlining** — Plan complet des chapitres avec spécifications, dépendances, références croisées
4. **Drafting** — Génération chapitre par chapitre avec des sous-agents en parallèle
5. **Editing** — Pipeline en 5 étapes : Évaluation → Développement → Ligne → Correction → Relecture finale
6. **Publishing** — Conversion EPUB/PDF/MOBI, métadonnées, plan marketing
## Skills
| Skill | Phase | Description |
|-------|-------|-------------|
| `/loom` | Routeur | Détecter la phase automatiquement et router |
| `/book-init` | 0 | Démarrer un nouveau projet — genre, audience, guide de style |
| `/book-ideation` | 1 | Générer et valider des concepts, analyse concurrentielle |
| `/book-outline` | 2 | Créer le plan des chapitres (avec dépendances) |
| `/book-draft` | 3 | Rédiger les chapitres (tous/spécifiques/reprendre, agents parallèles) |
| `/book-edit` | 4 | Pipeline d'édition en 5 étapes |
| `/book-publish` | 5 | Conversion EPUB/PDF/MOBI, couverture, marketing |
| `/book-illustrate` | 3-5 | Illustrations intérieures — extraction de scènes, prompts à style cohérent, plan de placement |
| `/book-status` | — | Tableau de bord terminal + `--ui` tableau de bord navigateur |
| `/book-fiction` | — | Patterns fiction (15 beats, Snowflake, bible de personnages) |
| `/book-nonfiction` | — | Patterns non-fiction (problème-solution, hiérarchie de preuves) |
| `/book-technical` | — | Patterns technique (gradient de concepts, code, labs) |
| `/book-screenplay` | — | Patterns scénario (3 actes, dialogue, histoires A/B) |
| `/book-poetry` | — | Patterns poésie (formes, imagerie, structure de strophes) |
| `/book-game` | — | Patterns jeu (arbres de quêtes, embranchements, bible de lore) |
| `/book-academic` | — | Patterns académique (IMRAD, revue de littérature, chaînes d'argumentation) |
| `/book-genre-creator` | — | Guide de sélection de genre et assistant de création de genre personnalisé |
## Agents
| Agent | Rôle |
|-------|------|
| `book-architect` | Valide la structure, note les plans, vérifie le rythme |
| `chapter-writer` | Génère des brouillons de chapitres avec des modèles de genre |
| `continuity-editor` | Cohérence entre chapitres (terminologie, références, chronologie) |
| `style-doctor` | Cohérence voix/ton, détection d'AI-slop |
| `scene-generator` | Décomposition au niveau de la scène avec structure GMC+RDD (fiction uniquement) |
| `cover-designer` | Concepts de couverture + prompts d'images Midjourney/DALL-E |
| `illustrator` | Illustrations intérieures — extraction de scènes, bible de style, génération de prompts |
| `marketing-expert` | Personas de lecteurs, stratégie de canaux, calendrier de lancement de 12 semaines |
## Tableau de Bord Visuel
`/book-status --ui` ouvre un tableau de bord de progression basé sur Svelte dans votre navigateur. Le tableau de bord se rafraîchit automatiquement toutes les 5 secondes :
- Suivi du pipeline en 6 phases (Onboarding → Ideation → Outlining → Drafting → Editing → Publishing)
- 8 cartes de statut d'agents (book-architect, chapter-writer, continuity-editor, cover-designer, illustrator, marketing-expert, scene-generator, style-doctor)
- Plan des chapitres, tableau des brouillons et kanban d'édition en 5 étapes
- Statut des fichiers de sortie (EPUB/PDF/MOBI/TXT/MD) avec liste de contrôle de publication
- Paramètres du projet et référence des commandes
Le tableau de bord lit dynamiquement depuis les fichiers `status.json` par projet. Le `dist/` pré-compilé est inclus — aucune étape de construction requise pour les utilisateurs du plugin.
Pour exécuter localement en développement :
```bash
cd dashboard
npm install
npm run dev # http://localhost:5173
npm run build # reconstruire dist/
```
## Principes de Conception
- **Planifier Avant d'Exécuter** — D'abord le plan, valider, puis écrire
- **Idempotent** — Ignorer les chapitres terminés, reprendre là où vous vous êtes arrêté
- **Efficace en Tokens** — Contexte basé sur des résumés, pas le texte complet
- **Conscience du Genre** — Structures, modèles et validation différents par genre
- **Contrôle Qualité** — Chaque phase doit passer les critères avant de continuer
## Dépendances Externes
Pour la sortie EPUB/PDF (Phase 5) :
```bash
brew install pandoc # Conversion EPUB/PDF
brew install texlive # PDF avec support CJK/coréen
brew install --cask calibre # Conversion MOBI (Kindle) — optionnel
```
### Dépannage