---
last-updated: 2026-05-29
---

# Reference

Index de tous les fichiers de reference du projet. Ces fichiers font autorite sur les connaissances internes de Claude.

**Chargement just-in-time :** ne jamais tout charger d'avance. Charger uniquement le fichier (ou la sous-section) utile au moment ou il sert, et uniquement pour la langue du track. La verification lourde est deleguee au subagent `.claude/agents/track-verifier.md`, qui charge ces fichiers dans son propre contexte.

**`trends/`** (genres/esthétiques/archétypes populaires, datés) alimente le skill `/auto-artist` (génération autonome d'artiste). À rafraîchir périodiquement par recherche web.

**Deux niveaux :** `linguistic/` garantit la **correction** (syllabes, rimes, flow, prononciation) ; `craft/` garantit la **profondeur** (image centrale, montrer, spécificité, prosodie) **et la structure** (`song-architecture.md`). Outils déterministes : `scripts/suno_count.py` (chars), `scripts/lyric_assist.py` (rimes + fréquence EN via Datamuse / FR via Lexique), `scripts/structure_check.py` (barres/durée/time-to-hook + hygiène Suno).

## Index

| Fichier | Description | Quand charger |
|---------|-------------|---------------|
| `craft/object-writing.md` | Récolter la matière concrète (7 sens) — anti-générique | Step 1.5 |
| `craft/central-image.md` | Image directrice / conceit / angle frais (Test 9) | Step 1.5 |
| `craft/prosody.md` | Forme ↔ sens (stable/instable) | Step 1.5 + écriture |
| `craft/song-architecture.md` | Choisir la structure : ADN par genre (formes, barres), arc d'énergie (genre × artiste × concept) | Step 1.5 |
| `craft/show-dont-tell.md` | Montrer l'émotion, pas la nommer (Test 7) | écriture + verif |
| `craft/specificity.md` | Concret, POV/temps/cadre, le « turn » (Test 8) | écriture + verif |
| `craft/craft-tests.md` | Tests 7-9 (procédures pour le subagent) | écriture + verif |
| `suno/format.md` | Suno Custom Mode (limites, metatags, formule style prompt, tags) | ecriture + verif |
| `suno/advanced.md` | Techniques avancees (exclude tags, stacking, phonetique, extends) | ponctuel |
| `linguistic/semantic/tests.md` | Procedures des 6 tests semantiques (langue-agnostique) | ecriture + verif |
| `linguistic/semantic/lists-fr.md` | Anti-cliches FR + mots-pieges niche FR (Tests 3 & 6) | track FR |
| `linguistic/semantic/lists-en.md` | Anti-cliches EN + niche words EN (Tests 3 & 6) | track EN |
| `linguistic/french/syllables.md` | Comptage syllabes FR (e muet, dierese, synerese) | track FR |
| `linguistic/french/rhymes.md` | Classification rimes FR + procedure IPA | track FR |
| `linguistic/french/rhymes-thresholds.md` | Seuils/ratios de rimes FR (table seule) | verif rapide FR |
| `linguistic/french/pronunciation.md` | Prononciation FR pour generation IA | track FR |
| `linguistic/french/flow.md` | Flow / chantabilite FR (densite, clusters, cesure) | track FR |
| `linguistic/english/syllables.md` | Comptage syllabes EN (stress patterns) | track EN |
| `linguistic/english/rhymes.md` | Classification rimes EN + procedure IPA | track EN |
| `linguistic/english/rhymes-thresholds.md` | Seuils/ratios de rimes EN par famille A/B/C | verif rapide EN |
| `linguistic/english/flow.md` | Flow / chantabilite EN (densite, stress, twisters) | track EN |
| `linguistic/hooks-punchlines.md` | Anatomie + 3 tests de qualite du hook | ecriture Chorus |
| `glossary.md` | Glossaire des termes musicaux | au besoin |
| `templates/songs/[genre].md` | Structures de chanson par genre (un seul charge) | ecriture |

## Convention

Chaque fichier de reference suit le template : metadata header (last-updated, source), Purpose, Rules, Examples, Notes. Les gros fichiers sont decoupes par langue/usage pour permettre un chargement granulaire.
