# UPGRADE.md — Plan d'amelioration AI_ARTISTE

Ce document liste les ameliorations structurelles identifiees lors de l'audit du 2026-05-03. Chaque point detaille : le probleme, la solution concrete, les fichiers a modifier/creer, et les criteres de verification pour confirmer que la correction est effective.

**Principe directeur** : transformer les "intentions" du workflow actuel en heuristiques chiffrees et vrais blocages. Aujourd'hui trop de regles sont des "ATTENTION non-bloquantes" qui peuvent etre ignorees.

---

## Sommaire

1. [Generation des noms d'artiste](#1-generation-des-noms-dartiste)
2. [Verification des rimes — durcir et chiffrer](#2-verification-des-rimes--durcir-et-chiffrer)
3. [Verification semantique des phrases](#3-verification-semantique-des-phrases)
4. [Logique musicale et flow — le plus gros trou](#4-logique-musicale-et-flow--le-plus-gros-trou)
5. [Hooks et punchlines](#5-hooks-et-punchlines)
6. [Garde-fou bible-vers-track](#6-garde-fou-bible-vers-track)
7. [Usage avance de Suno](#7-usage-avance-de-suno)
8. [Templates de genres — enrichir](#8-templates-de-genres--enrichir)
9. [Cross-track — durcir les alertes](#9-cross-track--durcir-les-alertes)
10. [Tableau de suivi](#tableau-de-suivi)

---

## 1. Generation des noms d'artiste

### Probleme
`create-artist/steps/01-identity.md` demande "memorable, prononcable, unique" — c'est tout. Aucune heuristique, aucun filtre anti-cliche, aucun test de distinctivite, aucune exigence de lien nom-lore. Resultat : `Blüme` (placeholder floral), `ANONYME` (s'auto-sabote comme marque), `Cheb Coyote` (hybridation non justifiee).

### Solution
Remplacer la collecte d'un nom unique par un generateur de **5 a 10 candidats** avec scoring multi-criteres, suivi d'une selection eclairee.

### Fichiers concernes
- Modifier : `.claude/skills/create-artist/steps/01-identity.md`
- Creer : `reference/naming/artist-naming-rules.md` (nouveau dossier `reference/naming/`)

### Contenu attendu de `reference/naming/artist-naming-rules.md`
- **Test de googlabilite** : verifier que le nom n'est pas un mot ultra-commun ni un artiste reel populaire (procedure : recherche web rapide, alerte si premiere page de resultats n'est pas l'artiste IA cible).
- **Distinctivite phonetique** : criteres consonnes/voyelles caracteristiques, longueur (2-4 syllabes recommandees), absence de cliches du genre (ex : eviter "Lord/King/Lil/Yung" en rap si l'artiste vise l'originalite).
- **Lien nom-lore obligatoire** : le nom doit pouvoir etre justifie en 1-2 phrases reliees au lore, au genre ou a la signature sonore. Si la justification est generique, rejeter.
- **Liste anti-cliches par genre** : ex pour hyperpop eviter les "core/wave/girl" generiques sans twist; pour rap eviter les patterns formulaiques.
- **Tests de prononciation cross-langue** : si l'artiste a des marches francophones et anglophones, le nom doit etre prononcable correctement dans les deux.

### Procedure dans le step 01 modifie
1. Apres collecte du genre, lore, langues : Claude genere **5 a 10 propositions** de noms.
2. Pour chaque proposition, afficher un **scoring** : googlabilite, distinctivite phonetique, lien lore, longueur, prononcabilite cross-langue.
3. L'utilisateur selectionne ou demande de regenerer.
4. Le nom retenu doit avoir une **justification ecrite de 1-2 phrases** stockee dans la bible (nouvelle section "Origine du nom").

### Verifications de correction
- [ ] `reference/naming/artist-naming-rules.md` existe et contient les 5 elements ci-dessus.
- [ ] `01-identity.md` mentionne explicitement la generation de 5-10 candidats (chercher : "5 a 10 candidats" ou "5-10 propositions").
- [ ] `01-identity.md` reference le fichier de regles de naming.
- [ ] Le template de bible inclut une section "Origine du nom" avec justification.
- [ ] Test E2E : creer un artiste fictif via le skill, verifier que la sortie inclut au moins 5 propositions avec scoring et qu'aucune ne passe sans justification.
- [ ] Re-passer les 3 artistes existants (Blüme, ANONYME, Cheb Coyote) au filtre des nouvelles regles : documenter le score que chacun obtiendrait. Si l'un d'eux echoue, c'est la preuve que les regles sont effectives.

---

## 2. Verification des rimes — durcir et chiffrer

### Probleme
Les fichiers `reference/linguistic/{french,english}/rhymes.md` sont excellents techniquement (procedure IPA stricte, classification pauvre/suffisante/riche/richissime). Mais en `create-track/steps/03-verify-and-save.md`, **seuls 2 cas sont bloquants** : rime pauvre en Chorus FR, eye rhyme en Chorus EN. Tout le reste est "ATTENTION non-bloquante".

Preuve : Cheb Coyote V1 a "grands/vent" (1 phoneme commun, pauvre) et Pre-Chorus 2 "raison/beton" (idem) — non corrigees malgre detection.

### Solution
Introduire des **ratios chiffres bloquants** par section et par langue. Verifier les rimes **pendant** l'ecriture (Step 02), pas seulement apres.

### Fichiers concernes
- Modifier : `reference/linguistic/french/rhymes.md` — ajouter section "Ratios minimum par section"
- Modifier : `reference/linguistic/english/rhymes.md` — idem
- Modifier : `.claude/skills/create-track/steps/02-structure-and-write.md` — verification rime ligne par ligne pendant l'ecriture
- Modifier : `.claude/skills/create-track/steps/03-verify-and-save.md` — durcir les blocages

### Ratios chiffres a definir (proposition de depart, a calibrer)

| Section | FR — Riche min | FR — Suffisante min | EN — Perfect min | EN — Slant max |
|---------|----------------|---------------------|------------------|----------------|
| Chorus / Hook | 70% riches+ | 100% suffisantes+ | 75% perfect | 25% slant |
| Verse | 40% riches+ | 80% suffisantes+ | 50% perfect | 50% slant |
| Pre-Chorus | 50% riches+ | 100% suffisantes+ | 60% perfect | 40% slant |
| Bridge | flexible | 70% suffisantes+ | flexible | flexible |
| Outro | flexible | flexible | flexible | flexible |

Eye rhymes : interdites partout sauf si choix artistique justifie (ecrit dans le rapport).

### Verification ligne par ligne pendant l'ecriture
Dans `02-structure-and-write.md`, ajouter une procedure : avant de finaliser une section, executer un mini-rapport rimes (paire par paire, classification IPA, ratio cumule). Si la section ne respecte pas le seuil, reecrire avant de passer a la suivante.

### Verifications de correction
- [ ] `french/rhymes.md` contient une table de ratios par section avec valeurs chiffrees.
- [ ] `english/rhymes.md` contient une table equivalente.
- [ ] `02-structure-and-write.md` contient une procedure de verification rime par section avant de passer a la suivante.
- [ ] `03-verify-and-save.md` liste les ratios comme **BLOQUANTS** (pas "ATTENTION").
- [ ] Test E2E : reecrire le track Cheb Coyote "Babylone, ma capitale" avec les nouvelles regles. Verifier que "grands/vent" et "raison/beton" sont rejetes en Step 02.
- [ ] Audit retroactif : passer les 5 tracks existants (Blüme x2, ANONYME x2, Cheb x1) au scanner des nouveaux ratios. Documenter combien de violations sont detectees. Si <50% des cas mediocres sont detectes, durcir encore.

---

## 3. Verification semantique des phrases

### Probleme
Step 02 mentionne "verifier que la ligne a un sens clair" comme intention. Step 03 liste une "verification semantique" mais sans procedure structuree. Resultat : phrases forcees par la rime, images contradictoires, cliches non detectes.

Preuves :
- Cheb Coyote : "Les rues sentaient l'huile et les lendemains" (synesthesie ratee — les rues ne sentent pas l'huile sauf contexte tres specifique non etabli).
- Cheb Coyote : "T'es dans mes os, t'es dans mes cicatrices" (cliche francophone amour-toxique).
- ANONYME : "La retine est un disque que rien ne peut vider" (image abstraite a 14 syllabes, inchantable).

### Solution
Formaliser **trois tests semantiques** appliques ligne par ligne pendant l'ecriture.

### Fichiers concernes
- Creer : `reference/linguistic/semantic-checks.md`
- Modifier : `.claude/skills/create-track/steps/02-structure-and-write.md`
- Modifier : `.claude/skills/create-track/steps/03-verify-and-save.md`

### Contenu attendu de `reference/linguistic/semantic-checks.md`

**Test 1 — Rime forcee** : Pour chaque ligne se terminant par une rime, remplacer mentalement le mot-rime par un synonyme non-rimant. Si la phrase devient soudain plus naturelle, c'etait force. Reecrire en repensant le mot-ancre.

**Test 2 — Coherence d'images dans la strophe** : Lister les images/metaphores de la strophe. Verifier qu'elles partagent un champ semantique coherent ou un contraste deliberé. Une strophe avec "feu", "ocean", "metal", "ange" sans fil rouge = a reecrire.

**Test 3 — Anti-cliches** : Maintenir une liste evolutive de cliches francophones et anglophones a eviter sans twist. Exemples FR : "dans mes os/cicatrices", "comme une croix", "la nuit qui pleure", "mon coeur en mille morceaux". Exemples EN : "broken heart", "pieces of me", "in your eyes", "fire and rain". Detecter ces patterns et obliger soit a les remplacer, soit a les justifier par un retournement.

**Test 4 — Image impossible** : Detecter les synesthesies ou metaphores qui ne fonctionnent pas physiquement/sensoriellement. Exemple : "les rues sentaient les lendemains" — un lendemain n'a pas d'odeur. Sauf si etabli prealablement comme univers surrealiste de l'artiste, rejeter.

### Verifications de correction
- [ ] `reference/linguistic/semantic-checks.md` existe avec les 4 tests detailles.
- [ ] `02-structure-and-write.md` integre les 4 tests dans la procedure d'ecriture (cite le fichier).
- [ ] `03-verify-and-save.md` ajoute une verification semantique formalisee (pas juste "verifier le sens").
- [ ] La liste anti-cliches contient minimum 30 entrees FR et 30 EN au depart, avec extensibilite documentee.
- [ ] Test E2E : reecrire 1 strophe de Cheb Coyote contenant "dans mes os, dans mes cicatrices" — verifier que le test 3 declenche le rejet.
- [ ] Test E2E : tenter d'ecrire "les rues sentaient les lendemains" — verifier que le test 4 le rejette.

---

## 4. Logique musicale et flow — le plus gros trou

### Probleme
**Zero documentation** sur le flow, la cadence, la chantabilite. Aucun fichier `reference/linguistic/*` ne couvre :
- Densite syllabique par BPM
- Alignement accent tonique / temps fort (FR) ou stress/downbeat (EN)
- Pauses respiratoires obligatoires
- Clusters consonantiques difficiles a tempo rapide
- Parallelisme syntaxique (ce qui rend un flow memorable)

Preuves :
- ANONYME : 13-16 syllabes/ligne a 100 BPM half-time = mitraillade inintelligible.
- Blüme : "disparaitre/fenetres" en chorus rapide hyperpop = quasi impossible a chanter proprement.

### Solution
Creer **deux nouveaux fichiers de reference** + integrer la verification flow dans le pipeline.

### Fichiers concernes
- Creer : `reference/linguistic/french/flow.md`
- Creer : `reference/linguistic/english/flow.md`
- Modifier : `.claude/skills/create-track/steps/02-structure-and-write.md`
- Modifier : `.claude/skills/create-track/steps/03-verify-and-save.md`

### Contenu attendu de `flow.md` (FR et EN)

**Section 1 — Densite syllabique par BPM**

Table de plafonds syllabiques par ligne, par genre, par tempo. Exemple FR :

| Genre | BPM | Syllabes max/ligne (Verse) | Syllabes max/ligne (Chorus) |
|-------|-----|----------------------------|------------------------------|
| Rap boom bap | 80-95 | 16 | 12 |
| Trap | 130-150 (half-time 65-75) | 14 | 10 |
| Industrial hip-hop half-time | 95-105 | 12 | 8 |
| Pop | 100-130 | 10 | 8 |
| Ballade | 60-80 | 8 | 6 |
| Hyperpop | 140-180 | 8 | 6 |
| Country | 90-110 | 10 | 8 |

Au-dela = ALERTE bloquante. L'artiste ne pourra pas articuler.

**Section 2 — Alignement accent / temps fort**

FR : Le francais n'a pas d'accent tonique fixe. L'accent tombe sur la derniere syllabe accentuee du groupe rythmique. Regle : la derniere syllabe d'une ligne doit etre alignee avec le 4e temps (ou son equivalent dans la mesure). Procedure de verification.

EN : Le stress doit tomber sur les downbeats (1 et 3 en 4/4) ou backbeats (2 et 4) selon le genre. Procedure : marquer les syllabes accentuees, simuler le rythme, detecter les decalages.

**Section 3 — Pauses respiratoires**

Une ligne de plus de 10 syllabes doit contenir une cesure naturelle (virgule, hemistiche, pause syntaxique). Procedure de detection. Si absente, reecrire en coupant ou en simplifiant.

**Section 4 — Clusters consonantiques**

FR : Eviter les enchainements >3 consonnes consecutives a tempo rapide (ex : "stricts spectres" = inchantable). Liste des clusters problematiques.

EN : Eviter les "tongue twisters" non voulus (ex : "she sells seashells" est un tongue twister). Liste des combos problematiques (sh-s, th-s, sp-st, etc.).

**Section 5 — Parallelisme syntaxique**

Un flow memorable repose souvent sur la repetition d'une structure syntaxique d'une ligne a l'autre (anaphore, structure parallele). Documenter les patterns efficaces par genre. Encourager (sans imposer) au moins une structure parallele par section.

**Section 6 — Mots polysyllabiques en fin de ligne**

Les mots de 3+ syllabes en fin de ligne ralentissent le flow et augmentent la difficulte de rime. Documenter les cas ou c'est efficace (ballade lente, prose poetique) vs problematique (rap rapide, hyperpop).

### Procedure d'integration dans les steps

Dans `02-structure-and-write.md` : pour chaque ligne ecrite, verifier (a) densite syllabique vs BPM cible, (b) presence de cesure si >10 syllabes, (c) absence de cluster consonantique problematique. Bloquer la generation si echec.

Dans `03-verify-and-save.md` : ajouter section "Verification flow" au rapport final. Bloquer la sauvegarde si plafond syllabique depasse ou cluster problematique detecte.

### Verifications de correction
- [ ] `reference/linguistic/french/flow.md` existe et contient les 6 sections.
- [ ] `reference/linguistic/english/flow.md` existe et contient les 6 sections (adaptees a l'anglais).
- [ ] Les tables de densite syllabique couvrent au moins 6 genres.
- [ ] Les listes de clusters problematiques contiennent au moins 20 entrees par langue.
- [ ] `02-structure-and-write.md` cite les fichiers flow et integre les verifications ligne par ligne.
- [ ] `03-verify-and-save.md` ajoute une section "Verification flow" bloquante.
- [ ] Test E2E retroactif : passer les 2 tracks ANONYME au scanner. Verifier que les lignes 13-16 syllabes a 100 BPM sont detectees comme depassant le plafond.
- [ ] Test E2E retroactif : passer le chorus de Blüme avec "disparaitre/fenetres" — verifier que la combinaison densite + cluster est detectee.

---

## 5. Hooks et punchlines

### Probleme
Aucune documentation sur la construction d'un hook memorable ni sur le placement et l'impact d'une punchline. Les chorus produits sont fonctionnels mais rarement marquants.

### Solution
Creer un fichier de reference dedie + checklist dans les templates de genres.

### Fichiers concernes
- Creer : `reference/linguistic/hooks-punchlines.md` (transverse FR/EN)
- Modifier : tous les fichiers de `reference/templates/songs/*.md` pour ajouter une section "Hook"

### Contenu attendu de `hooks-punchlines.md`

**Anatomie d'un hook memorable** :
- Concision (max 8 syllabes par ligne en general)
- Repetition controlee (un mot ou phrase qui revient 2-3 fois dans le hook)
- Image forte unique (une seule metaphore centrale, pas un patchwork)
- Resonance emotionnelle directe (mots simples, pas d'abstraction)
- Singabilite (consonnes ouvertes, voyelles longues sur les notes tenues)

**Placement de la punchline** :
- En rap : derniere ligne d'un 4-bar, avec un decalage rythmique deliberé
- En pop : premiere ligne du chorus pour ancrer immediatement
- En ballade : avant le bridge pour creer un climax avant la rupture

**Tests de qualite d'un hook** :
1. Test de l'oubli : peut-on chanter le hook 30 secondes apres l'avoir entendu une fois ?
2. Test de l'isolation : le hook fonctionne-t-il sorti de son contexte ?
3. Test de la singabilite : peut-on le chanter sans s'embrouiller sur 3 voyelles ?

**Anti-patterns** :
- Hook qui repete le titre 4 fois sans rien d'autre (sauf si stylistique deliberée)
- Hook avec plus de 2 idees distinctes (dilue l'impact)
- Hook abstrait ("la nuit etreint mon ame") quand le genre demande du concret

### Verifications de correction
- [ ] `reference/linguistic/hooks-punchlines.md` existe avec les 4 sections (anatomie, placement, tests, anti-patterns).
- [ ] Chaque template dans `reference/templates/songs/*.md` a une section "Hook" qui reference le fichier dedie.
- [ ] `02-structure-and-write.md` integre les 3 tests de qualite avant de finaliser le chorus.
- [ ] Test E2E : ecrire un nouveau chorus pour Blüme. Verifier que les 3 tests sont appliques et documentes.

---

## 6. Garde-fou bible-vers-track

### Probleme
Les bibles citent des influences sonores (SOPHIE, Death Grips, Cheb Khaled) mais **ces influences n'apparaissent jamais** dans les style prompts Suno ni dans les choix narratifs des tracks. Le projet est documentairement riche mais auditivement vide.

Preuves :
- Cheb Coyote : bible cite Cheb Khaled, mélismes arabes, raï → 0% de raï dans les tracks.
- ANONYME : bible cite Death Grips/clipping → tracks pas assez noise/industriels.
- Blüme : bible cite SOPHIE/100 gecs → aucune signature plastique/glitch dans les style prompts.

### Solution
Ajouter une **etape de verification croisee** entre la bible et le track avant validation finale.

### Fichiers concernes
- Modifier : `.claude/skills/create-track/steps/02-structure-and-write.md` (style prompt)
- Modifier : `.claude/skills/create-track/steps/03-verify-and-save.md` (verification finale)

### Procedure
Avant de generer le style prompt Suno, lire la bible et extraire :
- Liste des influences musicales citees
- Instruments specifiques mentionnes
- Signature sonore (mots-cles esthetiques)

Le style prompt doit faire apparaitre **au moins 2 elements** issus de cette liste, soit en references directes, soit en descripteurs equivalents.

Au Step 03, verifier (bloquant) :
- Au moins 2 influences/instruments/descripteurs de la bible apparaissent dans le style prompt.
- Si l'artiste a une signature culturelle/regionale (ex : raï, country, K-pop), au moins un element culturel correspondant doit etre present.
- Le rapport final liste explicitement quelles references de la bible ont ete reprises.

### Verifications de correction
- [ ] `02-structure-and-write.md` decrit la procedure d'extraction des influences depuis la bible avant style prompt.
- [ ] `03-verify-and-save.md` contient une verification bloquante "minimum 2 elements de la bible dans le style prompt".
- [ ] Le rapport de verification final inclut une section "Filiation a la bible" qui liste les references reprises.
- [ ] Test E2E retroactif : passer le track Cheb Coyote au scanner. Verifier que l'absence de raï/Cheb Khaled/mélismes est detectee comme violation bloquante.
- [ ] Test E2E : creer un nouveau track pour Cheb Coyote. Verifier que le style prompt contient explicitement raï ou un instrument arabe.

---

## 7. Usage avance de Suno

### Probleme
`reference/suno/format.md` couvre les bases (limites caracteres, tags genre/mood, metatags structure) mais ignore tout l'arsenal avance : style stacking, weights, exclude tags, vocal direction transitionnelle, notation phonetique pour forcer une prononciation.

### Solution
Etendre `reference/suno/format.md` ou creer `reference/suno/advanced.md`.

### Fichiers concernes
- Modifier ou completer : `reference/suno/format.md`
- Optionnel : creer `reference/suno/advanced.md`

### Sujets a couvrir

**Style stacking et conflits** :
- Comment combiner 2 styles (ex : "dark trap" vs "dark + trap")
- Comment prioriser quand 2 styles entrent en conflit
- Ordre des tags = ordre de priorite (a verifier empiriquement)

**Exclude tags** :
- Syntaxe pour exclure un instrument, un mood, un effet
- Exemples : `[no autotune]`, `[no vocals]`, `[no drums]`
- Quand utiliser pour forcer Suno a une direction

**Vocal direction transitionnelle** :
- Comment changer de delivery d'une section a l'autre sans incoherence
- Tables de transitions logiques : `[Whispered]` Verse → `[Belted]` Chorus = OK, `[Rapped]` Verse → `[Operatic]` Chorus = a justifier
- Maintenir le timbre vocal (Voices) constant tout en variant la delivery

**Notation phonetique** :
- Quand Suno se trompe sur la prononciation, comment forcer (ex : "nite" au lieu de "night" si Suno prononce "nigh-t")
- Liste des cas connus de mal-prononciation par langue

**Tension rhythmique** :
- Comment prescrire un swing, un shuffle, un polyrhythme
- Tags supportes par Suno

**Extends et chainable** :
- Procedure pour garder coherence vocale entre sections enchainees
- Limites de la duree (4 min par generation)

### Verifications de correction
- [ ] Le fichier (modifie ou nouveau) couvre les 6 sujets ci-dessus.
- [ ] Chaque sujet a au moins 3 exemples concrets de syntaxe.
- [ ] La table de transitions vocales contient au moins 12 entrees.
- [ ] La liste de mal-prononciations connues contient au moins 10 entrees par langue.
- [ ] `02-structure-and-write.md` reference ces fonctionnalites dans la generation du style prompt quand pertinent.
- [ ] Test E2E : generer un style prompt qui utilise volontairement un exclude tag. Verifier que le rapport mentionne pourquoi.

---

## 8. Templates de genres — enrichir

### Probleme
`reference/templates/songs/*.md` listent les structures (ABABCB, AABA, etc.) mais sans metriques syllabiques par bar, sans guide de hook, sans densite cible, sans exemples de patterns de flow specifiques au genre.

### Solution
Enrichir chaque template avec 4 sections obligatoires.

### Fichiers concernes
- Modifier tous les fichiers de `reference/templates/songs/*.md`
- Mettre a jour `reference/templates/songs/README.md` pour decrire le format enrichi

### Sections a ajouter dans chaque template

**1. Densite syllabique cible** : table syllabes/bar pour chaque section du genre. Ex pour rap boom bap : Verse = 12-16 syl/bar, Chorus = 8-12 syl/bar.

**2. Patterns de flow caracteristiques** : 3-5 patterns rythmiques typiques du genre (ex : trap = triolets sur les 16e, drill = sliding flow off-beat, country = phrases courtes alignees aux temps forts).

**3. Hook signature** : qu'est-ce qui caracterise un hook reussi dans ce genre ? Longueur, structure, niveau d'abstraction. Reference au fichier `hooks-punchlines.md`.

**4. References auditives canoniques** : 3-5 artistes/tracks de reference par genre, qui servent d'etalon. Ex hyperpop : SOPHIE "Immaterial", 100 gecs "money machine", Charli XCX "Vroom Vroom".

**5. Anti-patterns du genre** : ce qui sonne "faux" dans ce genre. Ex : un track de raï sans mélismes, un track boom bap avec voix autotunee a outrance, un track country sans pedal steel.

### Verifications de correction
- [ ] Tous les fichiers `reference/templates/songs/*.md` (sauf README) contiennent les 5 nouvelles sections.
- [ ] Chaque template liste au moins 3 references auditives canoniques.
- [ ] Chaque template liste au moins 3 anti-patterns.
- [ ] Le README explique le format enrichi et l'ordre des sections.
- [ ] Test E2E : creer un nouveau track pour chacun des 3 artistes existants en utilisant le template enrichi. Verifier que les style prompts mentionnent les references canoniques quand pertinent.

---

## 9. Cross-track — durcir les alertes

### Probleme
`create-track/steps/01-collect-inputs.md` analyse drift emotionnel (3+ tracks) et repetition thematique (2+ tracks) mais ces analyses sont **informatives et non bloquantes**. Resultat : Blüme repete "refuge interieur" sur 2 tracks consecutifs sans alerte forte.

### Solution
Transformer les alertes en blocages doux : exiger une justification ecrite si l'utilisateur insiste apres detection.

### Fichiers concernes
- Modifier : `.claude/skills/create-track/steps/01-collect-inputs.md`

### Procedure
Si une analyse cross-track detecte :
- Repetition thematique entre 2 tracks consecutifs : afficher une ALERTE et demander a l'utilisateur de justifier (en 1 phrase) pourquoi c'est intentionnel, OU proposer 3 angles thematiques alternatifs.
- Drift emotionnel par rapport a la palette primaire de la bible : ALERTE bloquante, idem.
- Emotion primaire de la bible jamais exploree malgre 3+ tracks : suggestion forte de l'utiliser pour le track en cours.

La justification (le cas echeant) doit etre stockee dans le fichier de track final, dans une section "Cross-track justification".

### Verifications de correction
- [ ] `01-collect-inputs.md` decrit explicitement le passage d'alerte informative a alerte bloquante avec justification.
- [ ] Le template de fichier de track inclut une section "Cross-track justification" (vide par defaut).
- [ ] Test E2E : tenter de creer un 3e track pour Blüme sur le theme du refuge interieur. Verifier que l'alerte se declenche et exige une justification.

---

## Tableau de suivi

| # | Item | Fichiers crees | Fichiers modifies | Verifications totales | Statut |
|---|------|----------------|-------------------|------------------------|--------|
| 1 | Generation noms d'artiste | 1 | 2 | 6 | a faire |
| 2 | Verification rimes durcie | 0 | 4 | 6 | a faire |
| 3 | Verification semantique | 1 | 2 | 6 | a faire |
| 4 | Logique musicale et flow | 2 | 2 | 8 | a faire |
| 5 | Hooks et punchlines | 1 | 8 | 4 | a faire |
| 6 | Garde-fou bible-track | 0 | 2 | 5 | a faire |
| 7 | Suno avance | 0 ou 1 | 1 ou 2 | 6 | a faire |
| 8 | Templates enrichis | 0 | 8 | 5 | a faire |
| 9 | Cross-track durci | 0 | 1 | 3 | a faire |

**Total** : 5 a 6 nouveaux fichiers, ~15 fichiers a modifier, **49 verifications** distinctes.

---

## Ordre de priorite recommande

1. **Logique musicale et flow** (item 4) — c'est le trou le plus beant et il impacte tout le reste.
2. **Verification rimes durcie** (item 2) — fondations existent, il "suffit" de chiffrer.
3. **Verification semantique** (item 3) — gain qualite immediat, peu invasif.
4. **Generation noms d'artiste** (item 1) — impact marketing/identite fort, isole du reste.
5. **Garde-fou bible-track** (item 6) — sans ca, les bibles restent du theatre.
6. **Hooks et punchlines** (item 5) — ameliore la memorabilite.
7. **Templates enrichis** (item 8) — ameliore la specificite par genre.
8. **Suno avance** (item 7) — gain de controle technique.
9. **Cross-track durci** (item 9) — gain de coherence discographique.

---

## Methodologie de verification globale

Pour chaque item complete :
1. Cocher les checkboxes de verification individuelles.
2. Faire un **test retroactif** : passer les 5 tracks existants (Blüme x2, ANONYME x2, Cheb Coyote x1) au scanner des nouvelles regles. Documenter combien de violations sont detectees.
3. Faire un **test prospectif** : creer 1 nouveau track pour 1 artiste existant en utilisant les nouvelles regles. Comparer la qualite percue avec les anciens tracks.
4. Si moins de 70% des violations evidentes sont detectees ou si le nouveau track ne montre pas d'amelioration nette, durcir encore les regles.

Documenter les resultats de ces tests dans `UPGRADE-RESULTS.md` au fur et a mesure.

---

**Date de creation** : 2026-05-03
**Auteur** : audit assistant Claude
**Statut global** : plan ecrit, implementation a faire
