---
phase: 03-artist-data-structure
plan: 02
subsystem: reference
tags: [song-structure, suno-metatags, genre-templates, pop, rap, ballad, rock, electronic]

# Dependency graph
requires:
  - phase: 01-foundation
    provides: "Suno format reference (format.md) with metatag vocabulary, glossary with canonical section terms"
provides:
  - "5 genre-specific song structure templates (pop, rap, ballad, rock, electronic)"
  - "Browsable README index of all song structure templates"
  - "Structural recipes arranging Suno metatags into genre-appropriate sequences"
affects: [04-track-creation-workflow]

# Tech tracking
tech-stack:
  added: []
  patterns: [song-structure-template-format]

key-files:
  created:
    - 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
    - reference/templates/songs/README.md
  modified: []

key-decisions:
  - "Consistent template format: frontmatter + Standard Structure + Section Flow + Variations + Notes"
  - "Line counts as ranges (4-8, not 8) to avoid over-prescriptive templates"
  - "Electronic template uses Build-Drop structure, deliberately distinct from verse-chorus"
  - "Templates reference Suno metatags but do not redefine them -- format.md is authoritative"

patterns-established:
  - "Song structure template format: frontmatter (genre, aliases, bpm-range) + 4 sections (Standard Structure, Section Flow, Variations, Notes)"
  - "Each Section Flow entry includes: Suno metatag, Role, Lines (range), Delivery suggestions, Notes"
  - "README index pattern for browsable template libraries"

# Metrics
duration: 3min
completed: 2026-04-10
---

# Phase 3 Plan 2: Song Structure Template Library Summary

**5 genre song structure templates (pop ABABCB, rap AABA, ballad AABA, rock ABABCB+Solo, electronic Build-Drop) with browsable README index in reference/templates/songs/**

## Performance

- **Duration:** 3 min
- **Started:** 2026-04-10T15:34:23Z
- **Completed:** 2026-04-10T15:37:42Z
- **Tasks:** 2
- **Files created:** 6

## Accomplishments
- Created 5 genre-specific song structure templates covering pop, rap, ballad, rock, and electronic
- Each template includes standard structure notation, section-by-section flow with Suno metatag placement, delivery tag suggestions, and 3-4 variations
- Electronic template correctly uses Build-Drop energy arc structure instead of verse-chorus
- README index provides browsable overview with links to all templates, metatag reference, and extension guide

## Task Commits

Each task was committed atomically:

1. **Task 1: Create pop, rap, and ballad song structure templates** - `4dca4c5` (feat)
2. **Task 2: Create rock and electronic templates plus README index** - `17b1e7c` (feat)

## Files Created/Modified
- `reference/templates/songs/pop.md` - Pop ABABCB structure with Pre-Chorus, 100-130 BPM
- `reference/templates/songs/rap.md` - Rap AABA verse-hook structure, 8-16 lines/verse, 130-170 BPM
- `reference/templates/songs/ballad.md` - Ballad verse-driven AABA, soft-to-climax delivery arc, 60-85 BPM
- `reference/templates/songs/rock.md` - Rock ABABCB + Guitar Solo section, 110-140 BPM
- `reference/templates/songs/electronic.md` - Electronic Build-Drop with [Build]/[Drop]/[Breakdown], 120-150 BPM
- `reference/templates/songs/README.md` - Browsable index of all 5 templates with structure/BPM overview

## Decisions Made
- Consistent template format across all 5 genres: frontmatter, Standard Structure, Section Flow, Variations, Notes
- Line counts always as ranges (e.g., 4-8) to avoid over-prescriptive templates that produce formulaic output
- Electronic template deliberately uses Build-Drop structure (not verse-chorus) to produce authentic EDM energy arcs
- Templates reference metatag names from format.md without redefining them -- single source of truth maintained

## Deviations from Plan

None - plan executed exactly as written.

## Issues Encountered

None

## User Setup Required

None - no external service configuration required.

## Next Phase Readiness
- Song structure template library is complete for Phase 4 track creation workflow consumption
- All 5 required genres covered: pop, rap, ballad, rock, electronic
- README index satisfies browsability requirement (Phase 3 Success Criteria #3)
- Template format is established and extensible for future genre additions

## Self-Check: PASSED

All 6 created files verified present. Both task commits (4dca4c5, 17b1e7c) verified in git history.

---
*Phase: 03-artist-data-structure*
*Completed: 2026-04-10*
