# Structure du Projet

Derniere mise a jour: 2026-05-29

Ce fichier documente la hierarchie du projet. Les dossiers `[nom-artiste]/` sont crees dynamiquement par le workflow de creation d'artiste.

## Principe d'architecture : chargement just-in-time

Les references ne sont jamais chargees d'avance. Chaque step de skill pointe vers le fichier (ou la sous-section) utile au moment exact, et uniquement pour la langue du track. La verification lourde est deleguee au subagent `track-verifier`, qui charge les gros fichiers dans son contexte jetable et ne renvoie que le rapport — le contexte principal reste leger.

## Hierarchie

```
AI_ARTISTE/
|
+-- CLAUDE.md                              # Instructions comportementales (stable)
+-- STRUCTURE.md                           # Ce fichier
+-- README.md                              # Presentation du projet
+-- best-practices.md                      # Principes creatifs transversaux
|
+-- scripts/
|   +-- suno_count.py                      # Comptage deterministe (chars, tags, sections)
|   +-- lyric_assist.py                    # Rimes + frequence (EN: Datamuse / FR: Lexique)
|   +-- structure_check.py                 # Analyse structure : barres/duree/time-to-hook, hygiene Suno
|   +-- fetch_lexique.py                   # Telecharge la base Lexique383 (FR)
|   +-- fetch_trends.py                    # Tendances reelles par langue (Apple/Deezer, sans cle)
|
+-- data/                                  # Donnees non versionnees
|   +-- lexique.tsv                        # Base Lexique383 FR (fetch via fetch_lexique.py)
|   +-- trends-live-{fr,en}.json           # Tendances live datees (fetch_trends.py)
|
+-- reference/
|   +-- README.md                          # Index des references + quand charger chaque fichier
|   +-- glossary.md                        # Termes musicaux canoniques
|   |
|   +-- trends/                            # Tendances curees (pour auto-artist) : genres, esthetiques, archetypes, combos
|   |
|   +-- craft/                             # Savoir-faire songwriting (charge a l'ecriture)
|   |   +-- README.md
|   |   +-- object-writing.md              # Matiere concrete (7 sens) — anti-generique
|   |   +-- central-image.md               # Image directrice / conceit / angle frais (Test 9)
|   |   +-- show-dont-tell.md              # Montrer l'emotion (Test 7)
|   |   +-- specificity.md                 # Concret, POV/temps, le « turn » (Test 8)
|   |   +-- prosody.md                     # Forme ↔ sens (stable/instable)
|   |   +-- song-architecture.md           # ADN structurel par genre (formes, barres, arc d'energie)
|   |   +-- craft-tests.md                 # Tests 7-9 (procedures verifier)
|   |
|   +-- suno/
|   |   +-- format.md                      # Suno Custom Mode : limites, metatags, tags
|   |   +-- advanced.md                    # Techniques avancees (ponctuel)
|   |
|   +-- linguistic/
|   |   +-- hooks-punchlines.md            # Anatomie + 3 tests du hook
|   |   +-- semantic/
|   |   |   +-- tests.md                   # Procedures des 6 tests (langue-agnostique)
|   |   |   +-- lists-fr.md                # Anti-cliches + mots niche FR
|   |   |   +-- lists-en.md                # Anti-cliches + niche words EN
|   |   +-- french/
|   |   |   +-- syllables.md               # Comptage syllabes FR
|   |   |   +-- rhymes.md                  # Classification rimes FR (procedure IPA)
|   |   |   +-- rhymes-thresholds.md       # Seuils/ratios FR (table seule)
|   |   |   +-- pronunciation.md           # Prononciation FR pour IA
|   |   |   +-- flow.md                     # Flow / chantabilite FR
|   |   +-- english/
|   |       +-- syllables.md               # Comptage syllabes EN (stress)
|   |       +-- rhymes.md                  # Classification rimes EN (procedure IPA)
|   |       +-- rhymes-thresholds.md       # Seuils/ratios EN par famille A/B/C
|   |       +-- flow.md                     # Flow / chantabilite EN
|   |
|   +-- templates/
|       +-- bible/                         # Templates de la bible eclatee (README, sound, voice, world, lore, persona, visual, coherence)
|       +-- bible-template.md              # Pointeur -> templates/bible/
|       +-- discography-template.md        # Template de discographie
|       +-- songs/                         # Templates de structure par genre
|           +-- README.md
|           +-- pop.md / rap.md / ballad.md / rock.md / electronic.md
|           +-- hyperpop.md / industrial-rap.md
|
+-- artists/                               # Un dossier par artiste
|   +-- README.md                          # Conventions de dossier + nommage
|   +-- [nom-artiste]/
|       +-- bible/                         # Bible eclatee (chargement just-in-time)
|       |   +-- README.md                  # Carte (pitch, index)
|       |   +-- sound.md / voice.md / world.md / lore.md
|       |   +-- persona.md / visual.md / coherence.md
|       +-- discography.md                 # Log des tracks finalises
|       +-- tracks/
|           +-- [numero]-[titre]/          # Un sous-dossier par track (fiche + audio)
|               +-- [numero]-[titre].md    # Fiche de production
|
+-- .claude/
|   +-- agents/
|   |   +-- track-verifier.md              # Subagent de verification (contexte jetable)
|   +-- skills/
|       +-- create-artist/                 # Wizard de creation d'artiste (6 steps, ecrit bible/)
|       |   +-- SKILL.md + steps/01..06 + examples/
|       +-- auto-artist/                   # Generation autonome (tendances), sans intervention
|       |   +-- SKILL.md
|       +-- create-track/                  # Production de track (4 steps + --step N)
|       |   +-- SKILL.md + steps/01, 01b (concept & matiere), 02, 03
|       +-- verify-track/                  # Re-verifie un track existant
|       |   +-- SKILL.md
|       +-- revise-track/                  # Applique du feedback sur les lyrics
|           +-- SKILL.md
|
+-- .planning/                             # Planification GSD (hors runtime)
    +-- archive/                           # Historique : UPGRADE*.md, legacy-base/ (process d'origine)
```

## Skills et leur chargement

| Skill | Role | Charge en contexte principal |
|-------|------|------------------------------|
| `create-artist` | Wizard d'identite (6 steps) | bible-template, format.md (genres/tags), glossary |
| `create-track` | Production de track (4 steps : 01, 01b, 02, 03) | bible, craft/ (Step 1.5), template genre, semantic/tests + lists-{lang}, refs {lang}, hooks |
| `verify-track` | Re-verification d'un track | fiche du track ; **verif deleguee au subagent** |
| `revise-track` | Feedback sur lyrics | fiche + bible ; **re-verif deleguee au subagent** |

Le subagent `track-verifier` charge dans SON contexte : semantic/tests + lists-{lang}, syllables/rhymes/flow {lang}, pronunciation (FR), suno/format, bible, discography. Il renvoie uniquement le Rapport de Verification.
