# Step 6 : Revue et Validation

## Processus de Revue

### 1. Verification de Completude

Verifier que tous les champs critiques sont remplis. Pour chaque champ manquant, indiquer l'etape correspondante et proposer de revenir la completer.

**Checklist de completude :**

| Champ | Etape | Critere |
|-------|-------|---------|
| Nom de scene | 1 | Non vide |
| Origine du nom | 1 | Non vide, justification 1-2 phrases liant le nom au lore / genre / signature sonore |
| Score du nom | 1 | >= 15/25 (selon `reference/naming/artist-naming-rules.md`) ou exception explicitement justifiée par l'utilisateur |
| Genre principal | 1 | Non vide, present dans `reference/suno/format.md` |
| Sous-genres | 1 | Au moins 1 |
| Langues | 1 | Au moins 1 |
| Tempo range | 1 | Non vide, coherent avec le genre |
| Half-time feel | 1 | yes ou no (yes pour trap/drill/industrial hip-hop par defaut) |
| Famille de rimes EN | 1 | A / B / C deduite OU N/A si francophone uniquement |
| Type de voix | 2 | Non vide, inclut un qualificatif de timbre |
| Style vocal | 2 | Non vide |
| Techniques preferees | 2 | Au moins 1 |
| Registre | 2 | Non vide |
| Tags Suno | 2 | Non vide (generer si absent) |
| Instruments signature | 2 | Au moins 1 instrument distinctif (vs generiques du genre) |
| Voice profile Suno | 2 | Descriptif fourni OU mention "A configurer apres le 1er track" |
| Notes de prononciation | 2 | Optionnel mais encourage si registre culturel specifique |
| Emotions primaires | 3 | Au moins 3 |
| Emotions interdites | 3 | Au moins 1 obligatoire (depuis 2026-05-04) |
| Themes recurrents | 3 | Au moins 5 |
| Univers thematique | 3 | Paragraphe (2-4 phrases) |
| Traits de personnalite | 4 | Au moins 2 phrases |
| Bio publique | 4 | 1-2 lignes, non vide |
| Tagline | 4 | Non vide |
| Lore | 4 | Au moins 5 lignes |
| Cadre surrealiste autorise | 4 | yes (avec description) ou no (mention explicite) |
| Arc narratif | 4 | Trajectoire 2-3 phases (fortement recommande) |
| Palette de couleurs | 5 | Au moins 3 couleurs |
| Style esthetique | 5 | Non vide |
| Mots-cles visuels | 5 | Au moins 5 |

Si un champ critique est manquant, revenir a l'etape correspondante pour le completer avant de continuer la validation.

### 2. Verification de Coherence

Verifier que les choix ne se contredisent pas. Pour chaque incoherence detectee, la signaler avec une explication et demander si c'est intentionnel.

**Verifications a effectuer :**

- **Genre vs Emotions** -- Le genre et les emotions sont-ils compatibles ? Exemple d'incoherence : genre "Heavy Metal" avec uniquement des emotions douces (Serene, Gentle, Dreamy). Signaler mais accepter si intentionnel (certains artistes jouent sur le contraste).
- **Style vocal vs Genre** -- Le style vocal fonctionne-t-il avec le genre ? Exemple d'incoherence : style vocal "Whispered only" pour du Punk Rock. Le contraste peut etre voulu mais merite d'etre confirme.
- **Tempo vs Genre** -- Le tempo est-il dans la plage attendue pour le genre ? Consulter `reference/suno/format.md` section "Ranges par Genre". Un ecart significatif n'est pas interdit mais doit etre signale.
- **Emotions primaires vs Emotions interdites** -- Aucun chevauchement. Si une emotion apparait dans les deux listes, signaler l'erreur.
- **Lore vs Themes** -- Le lore connecte-t-il aux themes definis ? Le backstory doit naturellement mener vers les themes recurrents.
- **Influences -> descripteurs sonores Tier 3 derivables** (NOUVEAU 2026-05-04) -- Pour CHAQUE artiste cite en Influences, verifier qu'un **descripteur sonore exploitable** est identifiable (ex : "SOPHIE -> plastic textures, saturated production"; "Death Grips -> noise rap brutal, distorted vocals"; "Cheb Khaled -> rai melismes, arabic vocal ornements"). Si un artiste cite n'a pas de descripteur derivable, **ALERTE** : reformuler la mention pour expliciter l'aspect reference (ex : remplacer "Death Grips" par "Death Grips (intensite industrielle, noise rap brutal, production saturee)"). Critique pour le garde-fou bible-track (item 6 UPGRADE).
- **Lore -> signature culturelle / esthetique exploitable** (NOUVEAU 2026-05-04) -- Le lore mentionne-t-il une signature culturelle (regionale, generationnelle, esthetique) qui pourra etre traduite en tags Suno dans les futurs tracks ? Exemples : Cheb Coyote = rai franco-algerien + desert americana ; ANONYME = dystopie urbaine francaise + esthetique broadcast ; Blüme = digital ethereal + dualite chaos/refuge. Si le lore est trop abstrait ou generique pour generer une signature culturelle exploitable, **ATTENTION** : enrichir avec un element culturel ou esthetique distinctif. Critique pour le garde-fou bible-track et la qualite des style prompts.

### 3. Preview de Coherence

Generer un bref "scenario test" : decrire comment un hypothetique premier track utiliserait cette bible. Cela montre a l'utilisateur ce que la bible produit en pratique.

Format du scenario :
```
**Scenario : Premier Track**
Genre : [genre + sous-genres utilises]
Voix : [type de voix + delivery pour ce track]
Emotion dominante : [emotion primaire choisie]
Theme : [theme explore]
Ambiance : [description en 1-2 phrases]
```

Ce scenario est illustratif -- il n'engage pas la production d'un vrai track.

### 4. Presentation de la Bible Complete

Formater la bible selon la structure de `reference/templates/bible/` (dossier eclate). Presenter un apercu a l'utilisateur, organise par fichier, tel qu'il sera sauvegarde. Les commentaires HTML ne doivent PAS apparaitre dans les fichiers finaux.

Mapping fichier -> contenu :
- `README.md` (carte) : nom, **pitch 1 ligne**, genre, langues, index
- `sound.md` : identite musicale (+ hybride), **signature structurelle**, influences (+ descripteur sonore), **reference tracks**, signature sonore
- `voice.md` : identite vocale, tags Suno, **Suno Persona**, instruments signature, prononciation
- `world.md` : palette emotionnelle (dont interdites), themes, univers
- `lore.md` : backstory, cadre surrealiste, arc narratif
- `persona.md` : personnalite, **USP**, **public cible**, **bios x3**, tagline, **motifs signature**
- `visual.md` : palette couleurs, esthetique, mots-cles, motifs visuels, **prompt portrait/cover**, style physique
- `coherence.md` : regles de coherence (garde-fous)

**Note sur la section Influences (fichier `sound.md`) :** Si l'utilisateur n'a pas mentionne d'influences, proposer 3-5 artistes de reference bases sur le genre/voix/emotions. Chaque influence inclut une parenthese avec l'aspect reference **+ un descripteur sonore exploitable en tag Suno**. Capturer aussi :
- **Reference tracks** : 2-3 morceaux precis qui definissent le son vise (distinct des influences generales) -- proposer si absent.
- **Signature sonore** : 1-2 phrases sur la combinaison reconnaissable (instruments + production + voix + culturel).
- **Hybride / signature de genre** (optionnel mais recommande, anti-generique) : ex "phonk x synthwave".

**Note sur les Regles de Coherence :** Generer automatiquement les regles de coherence a partir des choix du wizard :
- Contraintes vocales : deriver du type de voix (permanent) et du style vocal (variable)
- Contraintes thematiques : deriver des themes et de l'univers thematique
- Contraintes emotionnelles : deriver de la palette emotionnelle et des emotions interdites
- Themes interdits : optionnel, deriver des emotions interdites et du lore

### 5. Demande d'Ajustements

Presenter la bible et demander : **"Quelque chose a ajuster ?"**

- Si l'utilisateur dit non (ou equivalent) : passer a l'ecriture des fichiers
- Si l'utilisateur demande des changements : reviser les sections concernees, presenter a nouveau, redemander
- Ne pas boucler indefiniment : apres 3 revisions, suggerer de valider et d'ajuster plus tard si necessaire

## Ecriture des Fichiers

Une fois la bible approuvee, ecrire immediatement (auto-save per CLAUDE.md -- pas de "etes-vous sur ?") :

### Fichiers a creer

1. **Dossier artiste :** `artists/[name-in-kebab-case]/`
2. **Bible (dossier eclate) :** `artists/[name-in-kebab-case]/bible/`
   - Copier la structure de `reference/templates/bible/` : un fichier par template (`README.md`, `sound.md`, `voice.md`, `world.md`, `lore.md`, `persona.md`, `visual.md`, `coherence.md`)
   - Remplir chaque fichier avec les donnees collectees (y compris les nouveaux champs : USP, public cible, bios x3, reference tracks, Suno Persona, motifs signature, prompt visuel, signature structurelle)
   - Supprimer les commentaires HTML
   - Dater le `README.md` (carte)
3. **Discographie :** `artists/[name-in-kebab-case]/discography.md`
   - Utiliser `reference/templates/discography-template.md` comme base
   - Remplacer `[Nom de l'Artiste]` par le nom de l'artiste
   - Remplacer `[date]` par la date du jour
4. **Dossier tracks :** `artists/[name-in-kebab-case]/tracks/` (creer le repertoire vide)

### Regles de conversion kebab-case

- Tout en minuscules
- Espaces remplaces par des tirets
- Caracteres speciaux retires (ponctuation, symboles)
- Caracteres accentues conserves tels quels (ex: "elena" reste "elena", pas "el-na")

### Apres ecriture

Confirmer a l'utilisateur ce qui a ete ecrit :
```
Fichiers crees :
- artists/[name]/bible/ (README, sound, voice, world, lore, persona, visual, coherence)
- artists/[name]/discography.md
- artists/[name]/tracks/ (dossier)
```

Suggerer les prochaines etapes : "Vous pouvez maintenant creer un premier track avec /create-track [nom]"

## Champs Critiques

Liste des champs qui DOIVENT etre non vides pour valider la bible. Si l'un de ces champs est vide, la validation echoue et il faut revenir a l'etape correspondante.

| Champ | Min requis | Etape source |
|-------|-----------|--------------|
| Nom de scene | Non vide | 1 |
| Origine du nom | Justification 1-2 phrases | 1 |
| Score du nom | >= 15/25 (ou exception documentee) | 1 |
| Genre principal | Non vide | 1 |
| Sous-genres | 1 minimum | 1 |
| Langues | 1 minimum | 1 |
| Tempo range | Non vide | 1 |
| Half-time feel | yes/no explicite | 1 |
| Famille de rimes EN | A/B/C ou N/A | 1 |
| Type de voix | Non vide + qualificatif | 2 |
| Style vocal | Non vide | 2 |
| Techniques preferees | 1 minimum | 2 |
| Instruments signature | 1 minimum | 2 |
| Voice profile Suno | Descriptif ou mention "A configurer" | 2 |
| Emotions primaires | 3 minimum | 3 |
| Emotions interdites | 1 minimum | 3 |
| Themes recurrents | 5 minimum | 3 |
| Univers thematique | Paragraphe (2-4 phrases) | 3 |
| Traits de personnalite | 2 phrases minimum | 4 |
| Bio publique | 1-2 lignes | 4 |
| Tagline | Non vide | 4 |
| Lore | 5 lignes minimum | 4 |
| Cadre surrealiste autorise | yes/no explicite | 4 |
| Arc narratif | Trajectoire 2-3 phases (recommande) | 4 |
| Palette de couleurs | 3 minimum | 5 |
| Style esthetique | Non vide | 5 |
| Mots-cles visuels | 5 minimum | 5 |
