---
phase: 01-foundation
plan: 01
type: execute
wave: 1
depends_on: []
files_modified:
  - CLAUDE.md
  - STRUCTURE.md
autonomous: true

must_haves:
  truths:
    - "CLAUDE.md instructs Claude to treat reference files as authoritative over training data"
    - "CLAUDE.md is written entirely in French and covers all locked behavioral rules"
    - "CLAUDE.md stays under 200 lines by pointing to reference files for details"
    - "STRUCTURE.md accurately maps the full folder hierarchy the project will use"
  artifacts:
    - path: "CLAUDE.md"
      provides: "Behavioral instructions for Claude across all workflows"
      contains: "reference/"
    - path: "STRUCTURE.md"
      provides: "Complete folder hierarchy map for the project"
      contains: "artists/"
  key_links:
    - from: "CLAUDE.md"
      to: "reference/suno/format.md"
      via: "pointer instruction (check reference file for Suno constraints)"
      pattern: "reference/suno/format\\.md"
    - from: "CLAUDE.md"
      to: "reference/linguistic/"
      via: "pointer instruction (check linguistic reference files for verification)"
      pattern: "reference/linguistic/"
---

<objective>
Create the two root-level project configuration files: CLAUDE.md (behavioral instructions for Claude) and STRUCTURE.md (folder hierarchy map).

Purpose: CLAUDE.md is the single most important file in the project — it defines how Claude behaves across all workflows (artist creation, track production, verification). STRUCTURE.md provides a navigable map of where everything lives.
Output: `CLAUDE.md`, `STRUCTURE.md` at project root
</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/phases/01-foundation/01-RESEARCH.md
</context>

<tasks>

<task type="auto">
  <name>Task 1: Create CLAUDE.md with all behavioral rules</name>
  <files>CLAUDE.md</files>
  <action>
Create `CLAUDE.md` at the project root following the 9-section structure from the research. The file MUST be written entirely in French and MUST stay under 200 lines. Every locked decision from the phase context must be represented.

**Section structure (in this exact order):**

1. `# AI Artiste` — one line: "Systeme de workflows markdown pour creer des artistes musicaux virtuels IA et produire leur musique via Suno."

2. `## Langue` — French by default for all interactions.

3. `## Principes` — Core behavioral rules:
   - Reference authority: files in `reference/` font autorite sur les connaissances internes de Claude. En cas de conflit, le fichier de reference gagne.
   - Bible is law: Claude suit strictement la bible d'artiste (genre, themes, emotions, style vocal). Zero deviation.
   - Auto-save: Claude ecrit les fichiers directement, l'utilisateur relit apres. Pas de prompt de confirmation.
   - Auto-log discography: chaque track finalise est automatiquement ajoute a `artists/[nom]/discography.md`.
   - Creative collaborator persona: enthousiaste, propose des idees, s'engage avec la vision creative.
   - Creative reasoning: toujours fournir un bref raisonnement expliquant les choix creatifs.
   - Next steps: toujours suggerer quoi faire apres chaque etape de workflow.
   - Explicit content: aucune restriction. Le contenu explicite est autorise quand il correspond au genre et a l'identite de l'artiste.

4. `## Workflows` — Behavioral rules per workflow type:
   - **Creation d'artiste:** wizard step-by-step, valider qu'aucun champ critique n'est vide, produire la bible dans `artists/[nom]/bible.md`.
   - **Production de track:** une langue par track choisie a la creation (pas de melange). Lore guide le ton et les themes mais pas besoin de references explicites dans chaque track. Chaque Verse avance la narration ou explore un nouvel angle. Le Chorus est memorable, concis, capture le coeur emotionnel. Une fois sauvegarde, le track fait partie de la discographie (pas d'etat brouillon).
   - **Formats non-standard:** intros, interludes, spoken word, freestyle — la verification s'adapte (flow/cadence pour spoken word au lieu de rimes strictes).
   - **Feedback:** reviser les lyrics sur place en preservant le reste.

5. `## Format de Production` — Exact sections and order for production briefs:
   - Titre
   - Artiste
   - Langue
   - Style Prompt (verifier <= 1000 caracteres, voir `reference/suno/format.md`)
   - Lyrics (verifier <= 5000 caracteres, voir `reference/suno/format.md`)
   - Rapport de Verification (comptage syllabes, analyse rimes, contraintes Suno — integre automatiquement, pas une etape separee)
   - Notes (raisonnement creatif, suggestions)

6. `## Conventions de Nommage` — File naming rules:
   - Artistes: `artists/[nom-en-kebab-case]/`
   - Bible: `artists/[nom]/bible.md`
   - Tracks: `artists/[nom]/tracks/[numero]-[titre-en-kebab-case].md`
   - Discographie: `artists/[nom]/discography.md`

7. `## Verification` — Quality gates:
   - Chaque sortie de lyrics inclut automatiquement: comptage de syllabes par ligne, analyse de qualite des rimes, verification des contraintes Suno (comptage caracteres style prompt et lyrics).
   - Verification bundlee: pas une etape separee, integree dans la production.
   - Consulter `reference/linguistic/french/` ou `reference/linguistic/english/` selon la langue du track.
   - Consulter `reference/suno/format.md` pour les contraintes techniques.
   - Seuils de qualite: voir les fichiers de reference linguistique par langue.

8. `## Interdictions` — Explicit don'ts with rationale (use the draft from research):
   - Ne jamais ignorer les fichiers de reference — les fichiers `reference/` font autorite. Si un conflit existe, le fichier gagne.
   - Ne jamais melanger les langues dans un track — une langue par track. Suno derive entre les accents aux frontieres de section.
   - Ne jamais sauter la verification linguistique — chaque sortie de lyrics inclut automatiquement les verifications.
   - Ne jamais s'ecarter de la bible d'artiste — la bible est la loi. Genre, themes, emotions, style vocal : zero deviation.
   - Ne jamais demander confirmation avant de sauvegarder — ecrire le fichier, l'utilisateur relit apres.
   - Ne jamais produire un track sans raisonnement creatif — toujours expliquer les choix.
   - Ne jamais repeter le contenu entre les couplets — chaque Verse avance la narration ou explore un nouvel angle.
   - Ne jamais laisser un track en etat de brouillon — une fois sauvegarde, il fait partie de la discographie.
   - Ne jamais produire de brief de production sans verifier les limites Suno — comptage caracteres obligatoire.
   - Ne jamais dupliquer le contenu des fichiers de reference dans CLAUDE.md — pointer vers les references, ne pas copier.

9. `## Mises a Jour` — Update policy:
   - Quand un outil externe (Suno, etc.) change, mettre a jour les fichiers dans `reference/`. CLAUDE.md reste stable.
   - Chaque fichier de reference inclut une date de derniere mise a jour.

**Critical constraints:**
- Use h1 for title, h2 for sections, h3 max for subsections. No h4.
- All file paths in backticks.
- Every prohibition includes its rationale.
- The file does NOT duplicate Suno technical specs — it says "voir `reference/suno/format.md`".
- The file does NOT duplicate linguistic rules — it says "consulter `reference/linguistic/`".
- Target: 120-180 lines. MUST NOT exceed 200 lines.
  </action>
  <verify>Count lines in CLAUDE.md: `wc -l CLAUDE.md` should be under 200. Verify all 9 sections are present. Verify file references to `reference/suno/format.md` and `reference/linguistic/` exist.</verify>
  <done>CLAUDE.md exists at project root, is under 200 lines, is entirely in French, contains all 9 sections, references reference files for details without duplicating their content, and implements every locked behavioral decision.</done>
</task>

<task type="auto">
  <name>Task 2: Create STRUCTURE.md mapping the full project hierarchy</name>
  <files>STRUCTURE.md</files>
  <action>
Create `STRUCTURE.md` at the project root. This file maps the entire folder hierarchy that the project uses.

Use the recommended project structure from the research file as the base. The file should be a clear tree diagram with one-line descriptions for each file/folder.

**Content:**

```
# Structure du Projet

Derniere mise a jour: 2026-04-10

## Hierarchie

AI_ARTISTE/
|
+-- CLAUDE.md                              # Instructions comportementales pour Claude
+-- STRUCTURE.md                           # Ce fichier — carte de la hierarchie
|
+-- reference/
|   +-- README.md                          # Index de tous les fichiers de reference
|   +-- glossary.md                        # Glossaire des termes musicaux (anglais universel)
|   |
|   +-- suno/
|   |   +-- format.md                      # Reference complete Suno V5.5 Custom Mode
|   |
|   +-- linguistic/
|   |   +-- french/
|   |   |   +-- syllables.md               # Regles de comptage des syllabes en francais
|   |   |   +-- rhymes.md                  # Classification des rimes francaises
|   |   |   +-- pronunciation.md           # Prononciation francaise pour generation IA
|   |   +-- english/
|   |       +-- syllables.md               # Regles de comptage des syllabes en anglais
|   |       +-- rhymes.md                  # Classification des rimes anglaises
|   |
|   +-- templates/                         # Templates de structure de chanson par genre
|       +-- .gitkeep                       # (peuple en Phase 3)
|
+-- artists/                               # Un dossier par artiste
|   +-- README.md                          # Conventions de dossier + format de la bible
|   +-- [nom-artiste]/
|       +-- bible.md                       # Bible complete de l'artiste
|       +-- discography.md                 # Log de tous les tracks finalises
|       +-- tracks/
|           +-- [numero]-[titre].md        # Fiches de production individuelles
|
+-- base/                                  # Reference legacy (fichiers existants, non modifies)
    +-- project.md                         # Process original de creation d'identite
    +-- production.md                      # Pipeline de production original
```

Include a brief note at the top: "Ce fichier documente la hierarchie complete du projet. Les dossiers `[nom-artiste]/` sont crees dynamiquement par le workflow de creation d'artiste."
  </action>
  <verify>Verify STRUCTURE.md exists and contains entries for all key directories: `reference/`, `reference/suno/`, `reference/linguistic/`, `reference/templates/`, `artists/`, `base/`.</verify>
  <done>STRUCTURE.md exists at project root and accurately maps every directory and file in the project hierarchy with one-line descriptions in French.</done>
</task>

</tasks>

<verification>
- CLAUDE.md line count is under 200
- CLAUDE.md contains all 9 required sections: AI Artiste, Langue, Principes, Workflows, Format de Production, Conventions de Nommage, Verification, Interdictions, Mises a Jour
- CLAUDE.md references `reference/suno/format.md` and `reference/linguistic/` without duplicating their content
- CLAUDE.md is entirely in French
- STRUCTURE.md matches the actual file structure that will exist after all Phase 1 plans complete
- Neither file contains English prose (comments in structure diagram are in French)
</verification>

<success_criteria>
- CLAUDE.md exists, is under 200 lines, implements all locked behavioral decisions
- STRUCTURE.md exists and maps the complete project hierarchy
- Both files are in French
</success_criteria>

<output>
After completion, create `.planning/phases/01-foundation/01-01-SUMMARY.md`
</output>
