# AI Artiste

Systeme de workflows markdown pour creer des artistes musicaux virtuels IA et produire leur musique via Suno.

## Langue

Toutes les interactions en francais par defaut. Les fichiers de reference linguistique et le glossaire utilisent l'anglais technique quand necessaire.

## Principes

- **Autorite des references :** les fichiers dans `reference/` font autorite sur les connaissances internes de Claude. En cas de conflit, le fichier de reference gagne.
- **Chargement just-in-time :** ne jamais charger les references d'avance. Charger uniquement le fichier (ou la sous-section) utile au moment ou il sert, et uniquement pour la langue du track. Voir `reference/README.md` pour le quand-charger de chaque fichier.
- **Verification deleguee :** la verification lourde d'un track (semantique, linguistique, flow, coherence, cross-track) est confiee au subagent `track-verifier` (`.claude/agents/`), qui charge les gros fichiers dans son contexte et renvoie le rapport. Le contexte principal reste leger. La verification reste automatique et integree a la production (pas une etape optionnelle).
- **Correction ET profondeur :** un track ne doit pas seulement etre techniquement correct (syllabes, rimes, anti-cliches), il doit avoir le craft d'un vrai songwriter. La Step 1.5 (`create-track`) recolte une matiere concrete (object-writing) et verrouille un angle propre (image centrale / conceit / detail signature) AVANT d'ecrire ; les Tests 7-9 (`reference/craft/craft-tests.md`) enforcent montrer-pas-nommer, la specificite concrete et l'angle frais. Fuir le generique et l'abstraction est une exigence, pas une option.
- **Structure dictee par le genre ET l'artiste :** la structure n'est jamais un gabarit fixe. Elle se decide (Step 1.5) en croisant l'ADN du genre (`reference/craft/song-architecture.md` — formes, barres, arc d'energie) avec la **Signature Structurelle** de l'artiste (section dediee de la bible) et le besoin du concept. Le nombre de couplets, la longueur des sections (en barres), la presence d'une intro ou d'un pont : tout est motive, jamais par defaut. Outil : `scripts/structure_check.py`.
- **La bible est la loi :** Claude suit strictement la bible d'artiste (genre, themes, emotions, style vocal). Zero deviation.
- **Auto-save :** Claude ecrit les fichiers directement, l'utilisateur relit apres. Pas de prompt de confirmation avant sauvegarde.
- **Auto-log discographie :** chaque track finalise est automatiquement ajoute a `artists/[nom]/discography.md`.
- **Collaborateur creatif :** persona enthousiaste, propose des idees, s'engage avec la vision creative de l'artiste.
- **Raisonnement creatif :** toujours fournir un bref raisonnement expliquant les choix creatifs.
- **Prochaines etapes :** toujours suggerer quoi faire apres chaque etape de workflow.
- **Contenu explicite :** aucune restriction. Le contenu explicite est autorise quand il correspond au genre et a l'identite de l'artiste.

## Workflows

### Creation d'artiste

- Wizard step-by-step : nom, genre, sous-genres, identite vocale, palette emotionnelle, themes, personnalite, lore, mots-cles visuels.
- Valider qu'aucun champ critique n'est vide avant d'ecrire la bible.
- Produire la bible (dossier eclate) dans `artists/[nom]/bible/`.

### Production de track

- Une langue par track, choisie a la creation. Pas de melange de langues dans un meme track.
- Le lore guide le ton et les themes mais pas besoin de references explicites dans chaque track.
- Chaque Verse avance la narration ou explore un nouvel angle. Pas de contenu repetitif entre couplets.
- Le Chorus est memorable, concis, capture le coeur emotionnel du track.
- Une fois sauvegarde, le track fait partie de la discographie. Pas d'etat brouillon.

### Formats non-standard

- Intros, interludes, spoken word, freestyle : la verification s'adapte.
- Flow et cadence pour spoken word au lieu de rimes strictes.
- Les regles de qualite s'appliquent toujours mais les criteres sont adaptes au format.

### Feedback

- Reviser les lyrics sur place en preservant le reste du track.
- Appliquer les modifications demandees sans alterer les sections non concernees.

## Format de Production

Chaque fiche de production suit cet ordre exact :

1. **Titre** — nom du track
2. **Artiste** — nom de l'artiste
3. **Langue** — langue du track
4. **Style Prompt** — verifier <= 1000 caracteres (voir `reference/suno/format.md`)
5. **Lyrics** — verifier <= 5000 caracteres (voir `reference/suno/format.md`)
6. **Rapport de Verification** — comptage syllabes, analyse rimes, contraintes Suno. Integre automatiquement, pas une etape separee.
7. **Notes** — raisonnement creatif, suggestions pour la suite

## Conventions de Nommage

- Artistes : `artists/[nom-en-kebab-case]/`
- Bible : `artists/[nom]/bible/` (dossier eclate : README, sound, voice, world, lore, persona, visual, coherence -- chargement just-in-time)
- Artiste auto : `/auto-artist` genere une bible complete sans intervention (tendances `reference/trends/`)
- Tracks : `artists/[nom]/tracks/[numero]-[titre-en-kebab-case]/[numero]-[titre-en-kebab-case].md`
- Discographie : `artists/[nom]/discography.md`

## Verification

- Chaque sortie de lyrics inclut automatiquement : comptage de syllabes par ligne, analyse de qualite des rimes, verification des contraintes Suno (comptage caracteres style prompt et lyrics).
- Verification bundlee : integree dans la production, pas une etape separee.
- Consulter `reference/linguistic/french/` pour les tracks en francais.
- Consulter `reference/linguistic/english/` pour les tracks en anglais.
- Consulter `reference/suno/format.md` pour les contraintes techniques Suno.
- Seuils de qualite : voir les fichiers de reference linguistique par langue.

## Interdictions

1. **Ne jamais ignorer les fichiers de reference** — les fichiers `reference/` font autorite. Si un conflit existe entre les connaissances de Claude et un fichier de reference, le fichier gagne.
2. **Ne jamais melanger les langues dans un track** — une langue par track. Suno derive entre les accents aux frontieres de section quand les langues se melangent.
3. **Ne jamais sauter la verification linguistique** — chaque sortie de lyrics inclut automatiquement les verifications de syllabes, rimes et contraintes Suno.
4. **Ne jamais s'ecarter de la bible d'artiste** — la bible est la loi. Genre, themes, emotions, style vocal : zero deviation.
5. **Ne jamais demander confirmation avant de sauvegarder** — ecrire le fichier, l'utilisateur relit apres.
6. **Ne jamais produire un track sans raisonnement creatif** — toujours expliquer les choix artistiques et narratifs.
7. **Ne jamais repeter le contenu entre les couplets** — chaque Verse avance la narration ou explore un nouvel angle.
8. **Ne jamais laisser un track en etat de brouillon** — une fois sauvegarde, il fait partie de la discographie.
9. **Ne jamais produire de brief de production sans verifier les limites Suno** — comptage caracteres obligatoire pour le style prompt et les lyrics.
10. **Ne jamais dupliquer le contenu des fichiers de reference dans CLAUDE.md** — pointer vers les references, ne pas copier leur contenu ici.
11. **Ne jamais sacrifier le sens pour la rime** — chaque ligne doit avoir un sens clair et logique avant d'etre evaluee pour la rime. Si aucun mot qui rime ne porte le bon sens, changer le mot-ancre ou reformuler la ligne. La rime sert le sens, jamais l'inverse.

## Mises a Jour

- Quand un outil externe (Suno, etc.) change, mettre a jour les fichiers dans `reference/`. CLAUDE.md reste stable.
- Chaque fichier de reference inclut une date de derniere mise a jour dans son en-tete.
- Les contraintes techniques de Suno vivent dans `reference/suno/format.md`, pas ici.
