# Requirements: AI Artiste

**Defined:** 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).

## v1 Requirements

Requirements for initial release. Each maps to roadmap phases.

### Artist Creation

- [ ] **ART-01**: User can create an artist through an interactive step-by-step wizard (name, genre, subgenres, vocal identity, emotion palette, themes, personality, lore, visual keywords)
- [ ] **ART-02**: Wizard produces a complete artist bible in structured markdown (`artists/[name]/bible.md`)
- [ ] **ART-03**: Each artist gets a dedicated folder structure (`artists/[name]/bible.md`, `artists/[name]/tracks/`, `artists/[name]/discography.md`)
- [ ] **ART-04**: System includes pre-built song structure templates by genre (pop ABABCB, rap AABA, ballad ABACDC, etc.) stored as reusable references

### Track Production

- [ ] **TRACK-01**: User can create a track by specifying an artist and a concept/mood, producing a complete Suno-ready production brief
- [ ] **TRACK-02**: System generates complete singable lyrics with proper Suno section tags ([Intro], [Verse], [Pre-Chorus], [Chorus], [Bridge], [Outro])
- [ ] **TRACK-03**: System auto-generates an optimized style prompt from the artist bible (5-8 tags, genre-first ordering, within 1000 char limit)
- [ ] **TRACK-04**: System suggests vocal delivery metatags per section ([Whispered], [Belted], [Raspy], [Breathy]) based on artist vocal style and section emotion
- [ ] **TRACK-05**: Production brief respects all Suno constraints (style prompt max 1000 chars, lyrics max 3000 chars, metatag format)
- [ ] **TRACK-06**: User can choose track language (French or English) and lyrics are generated in that language

### Linguistic Verification

- [ ] **LING-01**: System verifies rhyme quality in generated lyrics according to language-specific rules
- [ ] **LING-02**: System counts syllables per line with French-specific rules (e muet, dierese, synerese, hiatus)
- [ ] **LING-03**: System counts syllables per line with English-specific rules (stress patterns)
- [ ] **LING-04**: System scores French rhymes using formal classification (pauvre: 1 son partage, suffisante: 2, riche: 3+, richissime: 4+)
- [ ] **LING-05**: System provides pronunciation guidance to optimize Suno vocal rendering in French (liaisons, nasales, elisions)
- [ ] **LING-06**: Verification report is included in the production brief with per-section quality assessment

### Coherence

- [ ] **COH-01**: System verifies genre alignment between track and artist bible before finalizing
- [ ] **COH-02**: System verifies vocal style consistency between track metatags and artist vocal identity
- [ ] **COH-03**: System verifies theme relevance against artist's defined themes
- [ ] **COH-04**: System verifies emotion alignment with artist's emotion palette
- [ ] **COH-05**: Each generated track is logged in `artists/[name]/discography.md` with title, date, themes, emotions, language
- [ ] **COH-06**: System warns when recent tracks over-index on a single emotion from the palette
- [ ] **COH-07**: System checks for thematic/lyrical repetition across previous tracks and flags duplicates
- [ ] **COH-08**: System suggests narrative progression based on artist lore and track history

## v2 Requirements

Deferred to future release. Tracked but not in current roadmap.

### Lore Integration

- **LORE-01**: System extracts key elements from lore (settings, events, symbols) and suggests lyric imagery
- **LORE-02**: System tracks which lore elements have been referenced across the discography

### Visual Identity

- **VIS-01**: System generates visual prompts for Midjourney/DALL-E based on artist visual identity
- **VIS-02**: System produces consistent character reference prompts for face/profile/full-body

### Video Production

- **VID-01**: System generates video production briefs for Runway/HeyGen
- **VID-02**: System suggests scene breakdowns for short-form video (TikTok-ready)

### Advanced Features

- **ADV-01**: Album/EP planning workflow with thematic arcs across multiple tracks
- **ADV-02**: Artist evolution system (eras, controlled style shifts)
- **ADV-03**: Production brief versioning (track iterations with diff notes)

## Out of Scope

| Feature | Reason |
|---------|--------|
| Audio generation / Suno API integration | Zero-code system -- user copy-pastes into Suno manually |
| Code dependencies (Node.js, Python, etc.) | System is 100% markdown executed by Claude |
| Real-time collaboration | Single-user markdown workflow by design |
| Mood-based auto-generation (without artist) | Bypasses artist identity, produces generic output |
| JSON storage format | Markdown-first for human readability and Claude compatibility |
| Genre/style recommendation engine | Wizard helps explore, doesn't choose for the user |

## Traceability

Which phases cover which requirements. Updated during roadmap creation.

| Requirement | Phase | Status |
|-------------|-------|--------|
| ART-01 | Phase 2: Artist Creation Wizard | Pending |
| ART-02 | Phase 2: Artist Creation Wizard | Pending |
| ART-03 | Phase 3: Artist Data Structure | Pending |
| ART-04 | Phase 3: Artist Data Structure | Pending |
| TRACK-01 | Phase 4: Core Track Production | Pending |
| TRACK-02 | Phase 4: Core Track Production | Pending |
| TRACK-03 | Phase 7: Track Enrichment and Verification Integration | Pending |
| TRACK-04 | Phase 7: Track Enrichment and Verification Integration | Pending |
| TRACK-05 | Phase 4: Core Track Production | Pending |
| TRACK-06 | Phase 4: Core Track Production | Pending |
| LING-01 | Phase 7: Track Enrichment and Verification Integration | Pending |
| LING-02 | Phase 5: French Linguistic Engine | Pending |
| LING-03 | Phase 6: English Linguistic Engine | Pending |
| LING-04 | Phase 5: French Linguistic Engine | Pending |
| LING-05 | Phase 5: French Linguistic Engine | Pending |
| LING-06 | Phase 7: Track Enrichment and Verification Integration | Pending |
| COH-01 | Phase 8: Coherence Engine | Pending |
| COH-02 | Phase 8: Coherence Engine | Pending |
| COH-03 | Phase 8: Coherence Engine | Pending |
| COH-04 | Phase 8: Coherence Engine | Pending |
| COH-05 | Phase 8: Coherence Engine | Pending |
| COH-06 | Phase 8: Coherence Engine | Pending |
| COH-07 | Phase 8: Coherence Engine | Pending |
| COH-08 | Phase 8: Coherence Engine | Pending |

**Coverage:**
- v1 requirements: 24 total
- Mapped to phases: 24
- Unmapped: 0

---
*Requirements defined: 2026-04-10*
*Last updated: 2026-04-10 after roadmap creation*
