# Project State

## Project Reference

See: .planning/PROJECT.md (updated 2026-04-10)

**Core value:** Les lyrics generees doivent etre linguistiquement solides (rimes, syllabes, structure) et parfaitement coherentes avec l'identite de l'artiste (style, lore, emotions, historique des tracks).
**Current focus:** Phase 8 - Coherence Engine

## Current Position

Phase: 8 of 8 (Coherence Engine)
Plan: 3 of 3 in current phase
Status: Phase complete
Last activity: 2026-04-11 -- Completed 08-03 (cross-track analysis)

Progress: [██████████] 100%

## Performance Metrics

**Velocity:**
- Total plans completed: 18
- Average duration: 3.1min
- Total execution time: 0.92 hours

**By Phase:**

| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
| 01-foundation | 01-01, 01-02, 01-03 | 10min | 3.3min |
| 02-artist-creation-wizard | 02-01, 02-02 | 9min | 4.5min |
| 03-artist-data-structure | 03-01, 03-02 | 4min | 2min |
| 04-core-track-production | 04-01, 04-02 | 5min | 2.5min |
| 05-french-linguistic-engine | 05-01, 05-02, 05-03 | 11min | 3.7min |
| 06-english-linguistic-engine | 06-01, 06-02 | 10min | 5min |
| 07-track-enrichment-and-verification-integration | 07-01, 07-02 | 6min | 3min |
| 08-coherence-engine | 08-01, 08-02, 08-03 | 5min | 1.7min |

**Recent Trend:**
- Last 5 plans: 07-01 (3min), 07-02 (3min), 08-01 (2min), 08-02 (1min), 08-03 (2min)
- Trend: Consistent (~1-3min/plan)

*Updated after each plan completion*

## Accumulated Context

### Decisions

Decisions are logged in PROJECT.md Key Decisions table.
Recent decisions affecting current work:

- [Roadmap]: 8 phases derived from 24 requirements; linguistic engines (Phases 5-6) can run parallel with track production (Phase 4)
- [Roadmap]: Phase 1 is infrastructure-only (no requirements mapped) to unblock all downstream phases
- [01-01]: CLAUDE.md at 92 lines with progressive disclosure to reference/ files
- [01-01]: All prohibitions include rationale explaining the "why" behind each rule
- [01-02]: Tag library organized by functional category with genre family grouping
- [01-02]: 8 vocal delivery categories covering volume, style, technique, rap, effects, emotion, dynamics, negatives
- [01-02]: English canonical terms used universally (Verse, Chorus, Bridge) even in French context
- [01-03]: All linguistic rules formulated as executable SI/ALORS (IF/THEN) conditions, not prose
- [01-03]: French rhyme quality thresholds are section-dependent (chorus=riche 3+, verse=suffisante 2+)
- [01-03]: English accepts broader rhyme spectrum: slant and near rhymes fully acceptable
- [01-03]: IPA is the universal phonetic notation standard across all linguistic files
- [02-01]: Bible template uses HTML comments for inline guidance -- invisible in rendered markdown
- [02-01]: 9 bible sections: 7 from README + Personnalite + Regles de Coherence
- [02-01]: Tags Suno field in Style Vocal captures pre-computed vocal tags for style prompts
- [02-01]: Regles de Coherence captures negative constraints for Phase 8 coherence engine
- [02-02]: SKILL.md uses only valid Claude Code skill frontmatter: name, description, argument-hint
- [02-02]: Each wizard step targets 2-4 questions to avoid fatigue -- conversational not form-like
- [02-02]: Step 06 auto-generates Influences and Regles de Coherence from wizard data
- [02-02]: Emotions and themes as single conversational step for coherent identity building
- [03-01]: ART-03 folder structure confirmed already implemented by wizard Step 06 -- no additional code needed
- [03-01]: STRUCTURE.md includes Phase 3 target state (songs/ directory) for forward accuracy
- [03-02]: Consistent template format: frontmatter + Standard Structure + Section Flow + Variations + Notes
- [03-02]: Line counts as ranges (4-8) not exact numbers to avoid over-prescriptive templates
- [03-02]: Electronic template uses Build-Drop structure, deliberately distinct from verse-chorus
- [03-02]: Templates reference Suno metatags without redefining them -- format.md stays authoritative
- [Phase 04-02]: Narrative arc planning mandatory before lyrics generation to prevent repetitive verse content
- [Phase 04-02]: Two-tier lyrics reporting: 3000 chars recommended with WARNING, 5000 chars hard BLOCK
- [Phase 04-02]: Style prompt verification uses 5 descriptive zones instead of binary pass/fail
- [Phase 04-02]: Linguistic verification deferred to Phases 5-7 with placeholder note in verification report
- [04-01]: 3-step compact workflow for directed creative production (inputs, write, verify) vs 6-step exploratory wizard
- [04-01]: Genre-template mapping uses actual template aliases from frontmatter as source of truth
- [04-01]: Track numbering derived from discography table row count, not filename scanning
- [05-01]: 113-entry dierese/synerese lookup table organized by suffix groups for navigability over alphabetical order
- [05-01]: Validation tests show ambiguity explicitly (genre-dependent counting, e muet in -ques) rather than hiding edge cases
- [05-01]: Default rule: synerese for unlisted words + mandatory ambiguity flag in verification report
- [05-02]: IPA transcription mandatory before any rhyme comparison -- anti-LLM-orthographic-matching safeguard
- [05-02]: False-positive "faux pieges" included in trap section to train against over-rejection
- [05-02]: Suggestion workflow includes reformulation strategy when target phoneme ending is inherently limiting
- [05-02]: Rimes identiques (homophones) excluded from rhyme counting unless documented as intentional wordplay
- [05-03]: 6-step pronunciation scan executed post-generation pre-save with structured report format
- [05-03]: Three severity levels (ALERTE/ATTENTION/INFO) with clear action thresholds for pronunciation risks
- [05-03]: Liaison table split into obligatory/forbidden/optional with Suno-specific rendering notes
- [05-03]: Rewrite strategies as recommendations not obligations -- creative judgment prevails for essential words
- [05-03]: 40-word watchlist organized by 4 risk categories with safe alternatives for each word
- [06-02]: IPA transcription mandatory before any English rhyme comparison -- same anti-LLM-orthographic-matching safeguard as French
- [06-02]: Type-based classification (perfect/slant/near/eye/internal) throughout, NOT phoneme counting for English
- [06-02]: Several common "slant" pairs corrected to perfect rhymes per IPA (breath/death, soul/goal, truth/youth)
- [06-02]: Multisyllabic slant rhymes in rap protected from replacement by monosyllabic perfect -- syllabic complexity primes
- [06-01]: Stress analysis formalized as mandatory steps (Etape 3 + Etape 4) -- English is stress-timed not syllable-timed
- [06-01]: Ambiguous-word table organized by phonetic category (diphtongue+r, schwa-elided, 3-or-4-syllable) not alphabetical
- [06-01]: Genre override rules: rap = short form default, ballad = long form default, pop = singability-driven
- [06-01]: Heteronym notes integrated into syllables.md rather than separate pronunciation.md for English
- [06-01]: First-usage rule: ambiguous word count set by first occurrence in track for consistency
- [07-01]: Style prompt auto-generation targets 5-8 tags in 120-300 chars (tighter than format.md's manual 8-15 / 200-500 guidance)
- [07-01]: Delivery tag mapping uses 3 artist style families (soft/breathy, powerful/raspy, rap) as columns
- [07-01]: Bible Techniques preferees field overrides mapping table when explicit techniques are specified
- [07-02]: Two-level reporting: full IPA decomposition internally, only summary table in production brief
- [07-02]: Only 2 blocking conditions (pauvre chorus FR, eye rhyme chorus EN) -- all other linguistic issues advisory
- [07-02]: Post-verification interaction gives user choice to keep or adjust lyrics after Step 02 approval
- [07-02]: Rapport de Verification split into Contraintes Suno + Verification Linguistique subsections
- [08-01]: Combined linguistic + coherence post-verification interactions into one user prompt to avoid multiple round-trips
- [08-01]: Auto-generated style prompts get "OK (auto-genere depuis la bible)" verdict for genre/vocal checks to avoid circular verification
- [08-01]: Coherence checks reference bible sections by exact field names (Identite Musicale, Style Vocal, Palette Emotionnelle, Themes, Regles de Coherence)
- [08-02]: Stats recomputed from full table on every update (never incremented) to prevent drift
- [08-02]: Unexplored emotions derived from bible palette (primaires + secondaires) at runtime, not hardcoded
- [08-03]: Cross-track findings are informational (non-blocking) -- complement bible alignment but don't trigger post-verification interaction
- [08-03]: 5-file reading limit for lyrical repetition balances thoroughness with workflow efficiency
- [08-03]: Narrative progression suggestions always execute (even with 0 tracks) using lore arc or general lore

### Pending Todos

None yet.

### Blockers/Concerns

- [Research]: French phonetic rhyme verification reliability with Claude is untested -- validate during Phase 5 implementation
- [Research]: Suno V5.5 style prompt "safe zone" varies (200-500 chars recommended vs 1000 max) -- validate empirically during Phase 4

## Session Continuity

Last session: 2026-04-11
Stopped at: Completed 08-03-PLAN.md. Phase 8 complete (3/3 plans). All 8 phases complete. Project at 100%.
Resume file: None
