---
phase: 05-french-linguistic-engine
plan: 03
type: execute
wave: 1
depends_on: []
files_modified:
  - reference/linguistic/french/pronunciation.md
autonomous: true

must_haves:
  truths:
    - "Le systeme scanne chaque ligne de lyrics francais pour 6 categories de risque Suno (lettres silencieuses, nasales, -tion, densite, liaisons, homographes) avec seuils d'alerte explicites"
    - "Chaque risque identifie a une mitigation concrete : mot alternatif, rewrite de ligne, ou strategie d'ecriture phonetique"
    - "La table de liaisons (obligatoires/interdites/facultatives) permet de detecter les liaisons problematiques pour Suno"
    - "La liste de mots a surveiller contient 40+ mots avec IPA, risque identifie, et mot alternatif suggere"
  artifacts:
    - path: "reference/linguistic/french/pronunciation.md"
      provides: "Guide de prononciation francais pour Suno avec procedure de scan en 6 etapes, table de liaisons, liste de mots etendue, strategies de rewrite"
      contains: "Procedure de Scan de Prononciation"
  key_links:
    - from: "reference/linguistic/french/pronunciation.md"
      to: "reference/linguistic/french/syllables.md"
      via: "Cross-reference comptage syllabique et densite"
      pattern: "syllables.md"
    - from: "reference/linguistic/french/pronunciation.md"
      to: "reference/suno/format.md"
      via: "Contrainte style prompt 'All lyrics in French'"
      pattern: "format.md"
---

<objective>
Etendre le fichier `reference/linguistic/french/pronunciation.md` avec une procedure de scan formalisee en 6 etapes, une table de liaisons complete (obligatoires/interdites/facultatives), une liste de mots a surveiller etendue (40+ mots avec alternatives), et des strategies de rewrite concretes.

Purpose: Passer d'un guide qui signale les risques a un guide qui propose des solutions actionnables. Chaque alerte de prononciation doit inclure une mitigation concrete que Claude peut appliquer immediatement.

Output: Fichier `reference/linguistic/french/pronunciation.md` etendu (~250-350 lignes) avec procedure de scan, tables de reference, et strategies de correction.
</objective>

<execution_context>
@C:/Users/zekho/.claude/get-shit-done/workflows/execute-plan.md
@C:/Users/zekho/.claude/get-shit-done/templates/summary.md
</execution_context>

<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/STATE.md
@.planning/phases/05-french-linguistic-engine/05-RESEARCH.md
@.planning/phases/01-foundation/01-03-SUMMARY.md
@reference/linguistic/french/pronunciation.md
@reference/linguistic/french/syllables.md
@reference/suno/format.md
</context>

<tasks>

<task type="auto">
  <name>Task 1: Etendre pronunciation.md avec procedure de scan, table de liaisons, et strategies de rewrite</name>
  <files>reference/linguistic/french/pronunciation.md</files>
  <action>
Lire le fichier existant `reference/linguistic/french/pronunciation.md` (108 lignes, status: foundation). Le REECRIRE COMPLETEMENT en preservant tout le contenu existant et en ajoutant les sections suivantes. Changer le frontmatter `status: foundation` en `status: complete`.

**Structure finale du fichier (ordre des sections) :**

1. **Frontmatter** — mettre a jour `status: complete`, `last-updated: 2026-04-10`

2. **Purpose** — garder tel quel

3. **Procedure de Scan de Prononciation** (NOUVELLE SECTION MAJEURE) — Formaliser la procedure en 6 scans que Claude DOIT executer sur chaque track francais avant finalisation :

   Encadre au debut : "Ce scan est execute APRES la generation des lyrics et AVANT la sauvegarde. Il produit un rapport de risques avec severite (ALERTE = doit corriger, ATTENTION = a surveiller, INFO = enrichissement)."

   - Scan 1: Lettres silencieuses — SI 2+ mots avec lettres silencieuses dans une meme ligne → ALERTE. Consulter la table "Mots a surveiller" etendue. Severite : ALERTE si 3+ dans une ligne, ATTENTION si 2.
   - Scan 2: Clustering de nasales — SI 3+ voyelles nasales (/ɔ̃/, /ɑ̃/, /œ̃/, /ɛ̃/) dans la meme ligne → ALERTE. Strategie : redistribuer sur 2 lignes ou alterner avec voyelles orales. Severite : ALERTE si 4+, ATTENTION si 3.
   - Scan 3: Mots en -tion — SI mot en -tion present → RAPPEL : verifier que "All lyrics in French" est dans le style prompt. SI 2+ mots en -tion dans la meme ligne → ATTENTION (risque d'anglicisation en serie). Severite : INFO pour 1, ATTENTION pour 2+.
   - Scan 4: Densite syllabique — SI ligne > 12 syllabes → ATTENTION. SI ligne > 15 syllabes → ALERTE (risque de slurring meme a tempo lent). Croiser avec le genre : rap tolere plus de densite, ballade moins. Consulter syllables.md pour le comptage.
   - Scan 5: Liaisons problematiques — Consulter la table de liaisons ci-dessous. SI liaison interdite detectee → ALERTE. SI liaison facultative dans un passage rapide → ATTENTION. Les liaisons obligatoires sont OK (Suno les gere).
   - Scan 6: Homographes — SI un homographe de la table est present ET le contexte ne desambiguite pas clairement → ATTENTION. Exemples : "fils", "plus", "os", "est", "couvent".

   Format du rapport de scan :
   ```
   | Ligne | Scan | Severite | Detail | Mitigation |
   ```

4. **Rules** — GARDER la section existante (notation phonetique, voyelles nasales, pieges, strategies generales, densite de consonnes). Ajouter :
   - **Niveaux de severite** : ALERTE (doit corriger avant sauvegarde), ATTENTION (recommandation forte, documenter si ignore), INFO (enrichissement, pas bloquant)
   - **Regle du style prompt** (renforcer) : SI langue == francais, ALORS le style prompt DOIT contenir "All lyrics in French" OU "Sung in French". C'est une verification automatique, pas optionnelle. Le style prompt est TOUJOURS en anglais.

5. **Table de Liaisons** (NOUVELLE SECTION MAJEURE) — Reprendre et etendre l'Example 2 de la research. 3 sous-sections :

   **5a. Liaisons obligatoires (Suno les gere bien) :**
   | Contexte | Exemple | Prononciation IPA | Notes Suno |
   - Determinant + nom commencant par voyelle (les amis, un enfant, des ombres)
   - Pronom sujet + verbe (nous avons, ils aiment, on arrive)
   - Adjectif + nom (petit ami, grand arbre, bon exemple)
   - Nombre + nom (deux enfants, trois amis, six heures)
   - Preposition monosyllabique + mot suivant (dans un, chez elle, en hiver)
   - Apres "tres", "plus", "moins" + adjectif (tres utile, plus agreable)

   **5b. Liaisons interdites (Suno peut les faire a tort) :**
   | Contexte | Exemple | ERREUR a eviter | Notes Suno |
   - Apres "et" (JAMAIS "et il" → /e.til/)
   - Nom singulier + verbe (JAMAIS "le chat arrive" → /ʃa.ta.ʁiv/)
   - Devant h aspire (liste des h aspires courants en chanson : heros, haine, honte, hurler, hasard, haut)
   - Devant "onze", "oui", "huit" (mots commencant par un faux "son voyelle")
   - Apres "toujours", "comment", "avant" en fin de groupe rythmique

   **5c. Liaisons facultatives (preferer la non-liaison pour Suno) :**
   | Contexte | Avec liaison | Sans liaison | Recommandation |
   - Verbe + complement (je suis arrive → facultatif)
   - Nom pluriel + adjectif (enfants adorables → facultatif)
   - Apres "pas" (pas encore → facultatif)
   Regle : **SI** la liaison est facultative, **ALORS** preferer la non-liaison pour reduire l'ambiguite Suno (moins de risque de mauvaise liaison = meilleur rendu).

6. **Mots a Surveiller (Liste Etendue)** (REMPLACER la section existante) — Etendre de ~10 mots a 40+ mots. Organiser par categorie de risque :

   **6a. Lettres silencieuses** (15+ mots) :
   | Mot | IPA | Lettres silencieuses | Risque | Alternative sure |
   - Garder les 8 existants (temps, corps, doigt, sept, aspect, respect, sculpture, automne)
   - Ajouter : fils /fis/, estomac /ɛs.to.ma/, tabac /ta.ba/, blanc /blɑ̃/, bras /bʁa/, gros /ɡʁo/, long /lɔ̃/, sang /sɑ̃/, poids /pwa/, choix /ʃwa/
   Pour chaque mot : fournir un mot alternatif de registre courant quand possible (ex: "temps" → "moment", "corps" → "peau" selon contexte)

   **6b. Homographes** (8+ mots) :
   | Mot | Sens 1 | IPA 1 | Sens 2 | IPA 2 | Comment desambiguiser |
   - fils (son/threads), plus (more/no more), os (bone sg /ɔs/ vs pl /o/), est (is /ɛ/ vs east /ɛst/), couvent (convent /ku.vɑ̃/ vs hatch /kuv/), vis (screw /vis/ vs live /vi/), portions (shares /pɔʁ.sjɔ̃/ vs we carried /pɔʁ.tjɔ̃/)

   **6c. Clusters consonantiques denses** (5+ mots) :
   | Mot | IPA | Cluster | Risque Suno |
   - construire, strasbourg, spectacle, infrastructure, obstruction

   **6d. Liaisons inattendues** (garder les 2 existants + ajouter 3+) :
   - tout a coup, plus ou moins, de plus en plus, quand il, quand on

7. **Strategies de Rewrite** (NOUVELLE SECTION) — Pour chaque type de risque, fournir des strategies concretes :
   - **Lettres silencieuses** : (1) Remplacer par synonyme sans lettres silencieuses. (2) SI le mot est irreplacable (rime, sens unique), l'isoler sur une ligne courte pour donner a Suno plus de temps. (3) En dernier recours, ecriture phonetique entre parentheses en commentaire de production.
   - **Clustering de nasales** : (1) Redistribuer les mots nasaux sur 2 lignes. (2) Inserer un mot a voyelle orale entre les nasales. (3) Exemple concret : "dans le vent on entend" (4 nasales) → "le vent souffle / on entend le son" (nasales reparties).
   - **Densite syllabique** : (1) Couper la ligne en 2 avec un metatag Suno si necessaire. (2) Remplacer les mots longs par des synonymes courts. (3) Exemple : "Je me souviens de toutes les promesses que tu m'avais faites" (16 syl) → "Je me souviens / de tes promesses brisees" (5+7 syl).
   - **-tion anglicisation** : (1) "All lyrics in French" dans le style prompt suffit dans 90% des cas. (2) SI persistant, remplacer par synonyme sans -tion (ex: "creation" → "naissance", "emotion" → "ressenti").

8. **Examples** — GARDER les 3 exemples existants. AJOUTER 2 exemples :
   - Exemple 4 : Ligne avec multiples risques simultanes (lettres silencieuses + nasales + densite) — montrer le scan complet et le rewrite
   - Exemple 5 : Ligne propre apres optimisation — montrer le "avant/apres" d'un rewrite reussi

9. **Notes** — Mettre a jour : retirer "Phase 5 etendra cette liste...", ajouter "La liste de mots a surveiller est extensible -- ajouter les mots problematiques rencontres en production. Les strategies de rewrite sont des recommandations, pas des obligations : le jugement creatif prevaut si le mot est essentiel au sens." Garder les cross-references.
  </action>
  <verify>
1. Ouvrir le fichier et verifier : frontmatter status = complete
2. Verifier la presence de la section "Procedure de Scan de Prononciation" avec 6 scans
3. Verifier la presence de la table de liaisons avec 3 sous-sections (obligatoires 6+ entrees, interdites 5+ entrees, facultatives 3+ entrees)
4. Compter les mots dans "Mots a Surveiller" : minimum 40 mots au total
5. Verifier la presence de la section "Strategies de Rewrite" avec 4 types de strategies
6. Verifier que les 3 exemples originaux sont preserves
7. Verifier la presence des niveaux de severite (ALERTE/ATTENTION/INFO)
8. Verifier que le fichier contient entre 250 et 400 lignes
  </verify>
  <done>
Le fichier pronunciation.md contient une procedure de scan en 6 etapes avec niveaux de severite, une table de liaisons complete, une liste de 40+ mots a surveiller avec alternatives, et des strategies de rewrite concretes. Chaque risque identifie a une mitigation actionnable.
  </done>
</task>

</tasks>

<verification>
- Le fichier `reference/linguistic/french/pronunciation.md` existe avec status: complete
- La procedure de scan produit un rapport avec colonnes Ligne/Scan/Severite/Detail/Mitigation
- La table de liaisons couvre obligatoires, interdites, et facultatives avec exemples IPA
- La liste de mots a surveiller contient 40+ mots organises par categorie de risque
- Les strategies de rewrite fournissent des exemples concrets "avant/apres"
- La regle "All lyrics in French" dans le style prompt est renforcee comme verification automatique
</verification>

<success_criteria>
Le systeme scanne les lyrics francais pour les risques de prononciation Suno, produit un rapport de risques avec severite, et fournit des mitigations concretes (mots alternatifs, rewrites de lignes, strategies d'ecriture) pour chaque risque detecte.
</success_criteria>

<output>
After completion, create `.planning/phases/05-french-linguistic-engine/05-03-SUMMARY.md`
</output>
