---
phase: 03-artist-data-structure
plan: 02
type: execute
wave: 1
depends_on: []
files_modified:
  - reference/templates/songs/README.md
  - reference/templates/songs/pop.md
  - reference/templates/songs/rap.md
  - reference/templates/songs/ballad.md
  - reference/templates/songs/rock.md
  - reference/templates/songs/electronic.md
autonomous: true

must_haves:
  truths:
    - "Song structure templates exist for pop, rap, ballad, rock, and electronic genres"
    - "Each template includes section ordering with Suno metatags and delivery guidance"
    - "User can browse reference/templates/songs/ to see available song structures before creating a track"
    - "Templates use line count ranges (not exact counts) as guidance"
    - "Electronic template uses Build-Drop structure, not verse-chorus"
  artifacts:
    - path: "reference/templates/songs/README.md"
      provides: "Browsable index of all song structure templates"
      contains: "pop"
    - path: "reference/templates/songs/pop.md"
      provides: "Pop song structure template (ABABCB)"
      contains: "[Chorus]"
    - path: "reference/templates/songs/rap.md"
      provides: "Rap song structure template (Verse-Hook)"
      contains: "[Rapped]"
    - path: "reference/templates/songs/ballad.md"
      provides: "Ballad song structure template (verse-driven)"
      contains: "[Verse"
    - path: "reference/templates/songs/rock.md"
      provides: "Rock song structure template (ABABCB + Solo)"
      contains: "[Guitar Solo]"
    - path: "reference/templates/songs/electronic.md"
      provides: "Electronic song structure template (Build-Drop)"
      contains: "[Drop]"
  key_links:
    - from: "reference/templates/songs/*.md"
      to: "reference/suno/format.md"
      via: "Templates use metatags defined in format.md"
      pattern: "\\[Verse|\\[Chorus|\\[Bridge|\\[Drop|\\[Build"
    - from: "reference/templates/songs/README.md"
      to: "reference/templates/songs/*.md"
      via: "Index links to each genre template"
      pattern: "pop\\.md|rap\\.md|ballad\\.md|rock\\.md|electronic\\.md"
---

<objective>
Create the song structure template library (ART-04) with 5 genre templates and a browsable README index in `reference/templates/songs/`.

Purpose: Phase 4 track creation workflow needs genre-appropriate structural recipes to arrange lyrics into Suno-compatible section ordering. These templates are reusable references -- structural recipes that arrange the existing Suno metatag vocabulary (from format.md) into genre-appropriate sequences.
Output: 6 files in reference/templates/songs/ (5 genre templates + README index)
</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/03-artist-data-structure/03-RESEARCH.md
@reference/suno/format.md
@reference/glossary.md
</context>

<tasks>

<task type="auto">
  <name>Task 1: Create pop, rap, and ballad song structure templates</name>
  <files>
    reference/templates/songs/pop.md
    reference/templates/songs/rap.md
    reference/templates/songs/ballad.md
  </files>
  <action>
Create `reference/templates/songs/` directory and 3 song structure template files. Use the research examples in 03-RESEARCH.md as the primary reference for pop and rap format. All templates follow this consistent format:

**Frontmatter:** `last-updated`, `genre`, `aliases` (from format.md genre families), `bpm-range` (from format.md "Ranges par Genre")

**Sections in order:**
1. `# [Genre] - Song Structure Template`
2. `## Standard Structure` -- Letter notation (e.g., ABABCB) with one-line description
3. `## Section Flow` -- Numbered sections, each with: Suno metatag, Role, Lines (RANGES like "4-8", not exact), Delivery tag suggestions, Notes
4. `## Variations` -- Table with 3-4 common variations (Variation name, Structure notation, When to Use)
5. `## Notes` -- 4-6 bullet points: typical duration in Suno, genre conventions, Suno-specific tips

**Pop template (pop.md):**
- Structure: ABABCB (Verse / Chorus / Verse / Chorus / Bridge / Chorus)
- Include Pre-Chorus as optional section
- Emphasize chorus as the core hook
- Follow the research example closely (lines 199-286 of 03-RESEARCH.md)
- Aliases from format.md: Synth-Pop, Electro-Pop, Indie Pop, Art Pop, Dark Pop, Bedroom Pop
- BPM: 100-130 BPM

**Rap template (rap.md):**
- Structure: AABA (Verse / Hook / Verse / Hook / Verse / Hook -- 3 verses, 3 hooks)
- 8-16 lines per verse (16 bars in boom bap, 8-12 in trap/drill)
- Emphasize `[Rapped]` delivery tag importance
- Follow the research example closely (lines 373-454 of 03-RESEARCH.md)
- Aliases: Trap, Boom Bap, Drill, Grime, Cloud Rap, Lo-Fi Hip-Hop
- BPM: 130-170 BPM (half-time feel)

**Ballad template (ballad.md):**
- Structure: AABA or ABACDC (verse-driven, chorus may be absent or minimal)
- Verses carry the narrative weight -- longer than in other genres (6-10 lines)
- Bridge provides emotional climax or turning point
- Delivery: `[Soft]`, `[Emotional]`, `[Breathy]`, building to `[Belted]` at climax
- Aliases: Power Ballad, Acoustic Ballad, Piano Ballad, Slow Jam
- BPM: 60-85 BPM
- Include variations: power ballad (with full chorus), stripped acoustic, epic ballad (builds to orchestral)
- Key Suno tip: slower BPM allows more syllables per line without rushing

**Anti-patterns to avoid (from research):**
- Do NOT duplicate metatag definitions from format.md -- just reference the metatag names
- Do NOT use exact line counts -- always ranges
- Do NOT include example lyrics (just format guidance)
  </action>
  <verify>
Verify all 3 files exist and pass these checks:
- Each has valid frontmatter (last-updated, genre, aliases, bpm-range)
- Each has all 5 sections (title, Standard Structure, Section Flow, Variations, Notes)
- Line counts are ranges (contain "-") not exact numbers
- Suno metatags are in brackets: [Verse], [Chorus], [Bridge], etc.
- Pop: contains ABABCB, [Pre-Chorus], [Chorus]
- Rap: contains AABA, [Rapped], 8-16 lines per verse
- Ballad: contains AABA or verse-driven notation, [Soft], [Emotional]
  </verify>
  <done>Three genre templates (pop, rap, ballad) created with consistent format, correct metatags, and line count ranges</done>
</task>

<task type="auto">
  <name>Task 2: Create rock and electronic templates plus README index</name>
  <files>
    reference/templates/songs/rock.md
    reference/templates/songs/electronic.md
    reference/templates/songs/README.md
  </files>
  <action>
Create 2 more song structure templates and the README index file.

**Rock template (rock.md):**
- Structure: ABABCB + Solo (Verse / Chorus / Verse / Chorus / Solo / Bridge / Chorus)
- Guitar solo section uses `[Guitar Solo]` or `[Instrumental]` metatag
- Heavier delivery: `[Raspy]`, `[Powerful]`, `[Belted]`
- Bridge often shifts energy before final chorus
- Aliases: Alternative Rock, Indie Rock, Hard Rock, Punk Rock, Post-Punk, Garage Rock
- BPM: 110-140 BPM
- Variations: no solo (standard ABABCB), breakdown instead of bridge, extended outro, acoustic version
- Suno tip: `[Guitar Solo]` works well in Suno when genre tags include guitar-related instruments

**Electronic template (electronic.md):**
- Structure: Build-Drop (Intro / Build / Drop / Breakdown / Build / Drop / Outro)
- This is NOT verse-chorus. Use energy arcs, not narrative arcs.
- Follow the research example closely (lines 289-371 of 03-RESEARCH.md)
- Use `[Build]`, `[Drop]`, `[Breakdown]` metatags (confirmed supported by Suno)
- Minimal vocals: 0-2 lines per section, many sections instrumental
- `[no vocals]` and `[Instrumental]` metatags used liberally
- Aliases: EDM, House, Deep House, Tech House, Techno, Trance, Future Bass, Synthwave
- BPM: 120-150 BPM (varies by subgenre; note subgenre BPMs in Notes)
- Variations: vocal EDM (with verse sections), extended breakdown, triple drop

**README index (README.md):**
- Title: "Song Structure Templates"
- Brief intro: explains these are structural recipes arranging Suno metatags into genre-appropriate sequences
- Note that these are guides not rigid rules -- the Variations section in each template shows alternatives
- Table listing all 5 templates with columns: Genre, File, Structure, BPM Range, one-line description
- Note that the library is extensible -- additional genre templates can be added following the same format
- Reference to `reference/suno/format.md` for the full metatag vocabulary
- Last-updated date in frontmatter

**Anti-patterns to avoid:**
- Electronic template must NOT use verse-chorus structure (use Build-Drop)
- Do NOT create hybrid templates for cross-genre tracks
- README should NOT re-explain Suno metatags -- just point to format.md
  </action>
  <verify>
Verify all 3 files exist and pass these checks:
- Rock: contains ABABCB, [Guitar Solo] or [Instrumental], [Raspy] or [Powerful]
- Electronic: contains Build-Drop, [Build], [Drop], [Breakdown], does NOT use standard ABABCB notation
- README: lists all 5 genres with file links, contains reference to format.md
- All files have frontmatter with last-updated date
- All line counts are ranges, no exact numbers
  </verify>
  <done>Rock and electronic templates created, README index provides browsable overview of all 5 genre templates. Success criteria #2 and #3 satisfied.</done>
</task>

</tasks>

<verification>
- 5 genre template files exist in reference/templates/songs/ (pop, rap, ballad, rock, electronic)
- README.md index exists and lists all 5 templates
- All templates follow consistent format (frontmatter, Standard Structure, Section Flow, Variations, Notes)
- Electronic template uses Build-Drop, not verse-chorus
- Line counts are ranges throughout
- Metatags match vocabulary in reference/suno/format.md
- No content duplication from format.md (templates reference metatags, don't re-define them)
</verification>

<success_criteria>
- ART-04 satisfied: 5 pre-built song structure templates by genre exist as reusable references
- Phase 3 Success Criteria #2: Song structure templates cover pop, rap, ballad, rock, electronic with section ordering and metatag placement
- Phase 3 Success Criteria #3: User can browse reference/templates/songs/ via README.md to see available structures
</success_criteria>

<output>
After completion, create `.planning/phases/03-artist-data-structure/03-02-SUMMARY.md`
</output>
