---
phase: 04-core-track-production
plan: 01
subsystem: skill
tags: [claude-code-skill, track-creation, workflow-orchestration, suno, lyrics]

# Dependency graph
requires:
  - phase: 02-artist-creation-wizard
    provides: "SKILL.md + steps/ skill architecture pattern"
  - phase: 03-artist-data-structure
    provides: "Song structure templates with genre aliases in reference/templates/songs/"
provides:
  - "create-track skill entry point (SKILL.md) with 3-step workflow"
  - "Step 01 input collection with artist validation, bible loading, and template selection"
affects: [04-02-PLAN, phase-05, phase-07]

# Tech tracking
tech-stack:
  added: []
  patterns: ["3-step directed workflow (vs 6-step exploratory wizard)", "genre-to-template mapping via frontmatter aliases"]

key-files:
  created:
    - ".claude/skills/create-track/SKILL.md"
    - ".claude/skills/create-track/steps/01-collect-inputs.md"
  modified: []

key-decisions:
  - "3-step compact workflow for directed creative production (inputs, write, verify) vs 6-step exploratory wizard"
  - "Genre-template mapping uses actual template aliases from frontmatter as source of truth with quick reference table as convenience"
  - "Track numbering derived from discography table row count, not filename scanning"

patterns-established:
  - "Directed skill pattern: compact step count for workflows with established constraints (bible already exists)"
  - "Genre-template selection: match artist genre/subgenres against template aliases field, fallback to pop.md"

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

# Phase 4 Plan 01: Create Track Skill Entry Point and Input Collection Summary

**Create-track skill orchestrator (SKILL.md) with 3-step directed workflow and Step 01 for artist validation, bible loading, genre-template mapping, and creative direction summary**

## Performance

- **Duration:** 3 min
- **Started:** 2026-04-10T16:00:13Z
- **Completed:** 2026-04-10T16:03:51Z
- **Tasks:** 2
- **Files created:** 2

## Accomplishments
- SKILL.md defines the complete 3-step create-track workflow with persona, arguments, references, and 7 behavioral rules mirroring CLAUDE.md requirements
- Step 01 provides artist validation (bible existence check), bible context loading, discography-based track numbering, genre-to-template mapping, and creative direction summary presentation
- Genre-template mapping table aligned with actual template file frontmatter aliases (pop, rap, ballad, rock, electronic) with pop.md as safe fallback

## Task Commits

Each task was committed atomically:

1. **Task 1: Create SKILL.md skill orchestrator** - `4192f07` (feat)
2. **Task 2: Create Step 01 collect inputs** - `bc55df4` (feat)

## Files Created/Modified
- `.claude/skills/create-track/SKILL.md` - Track creation skill orchestrator: 3-step workflow, persona, references, 7 rules
- `.claude/skills/create-track/steps/01-collect-inputs.md` - Input collection: artist validation, bible loading, template selection, direction summary

## Decisions Made
- **3-step workflow over 6-step wizard:** Track creation works within established constraints (bible already defined), making it a directed production rather than exploratory design. 3 steps avoids fragmenting creative flow.
- **Discography-based numbering:** Track number determined by counting discography table rows + 1, not by scanning filenames. More reliable and consistent.
- **Alias-based template matching:** Genre-to-template selection uses the `aliases` frontmatter field in each template as the source of truth, with a quick reference table in Step 01 for human readability.

## Deviations from Plan

### Auto-fixed Issues

**1. [Rule 1 - Bug] Corrected genre-template mapping aliases to match actual template files**
- **Found during:** Task 2 (Step 01 creation)
- **Issue:** Plan's mapping table listed aliases that didn't exactly match actual template frontmatter (e.g., plan listed "Conscious Rap" for rap.md but actual aliases include "Grime, Lo-Fi Hip-Hop"; plan listed "Folk Ballad" but actual includes "Piano Ballad, Slow Jam")
- **Fix:** Read all 5 template frontmatter files and used actual aliases for the quick reference table
- **Files modified:** `.claude/skills/create-track/steps/01-collect-inputs.md`
- **Verification:** Compared table entries against each template's `aliases` field
- **Committed in:** bc55df4 (Task 2 commit)

---

**Total deviations:** 1 auto-fixed (1 bug)
**Impact on plan:** Minor correction for accuracy. The table is explicitly labeled as a quick reference with frontmatter as source of truth, so the impact is cosmetic but important for developer trust.

## Issues Encountered
None

## User Setup Required
None - no external service configuration required.

## Next Phase Readiness
- SKILL.md is ready to load when user invokes /create-track
- Step 01 is complete and referenced correctly from SKILL.md
- Plan 04-02 can now build Steps 02 (structure/write) and 03 (verify/save) to complete the skill
- Steps 02 and 03 file paths are already referenced in SKILL.md (`steps/02-structure-and-write.md`, `steps/03-verify-and-save.md`)

## Self-Check: PASSED

All files found, all commits verified.

---
*Phase: 04-core-track-production*
*Completed: 2026-04-10*
