# Timeline Planner

> Timeline Mode specialist - handles release planning, scheduling, task sequencing, and visual timeline layouts for artists.

- Skill: `majiayu000/timeline-planner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/timeline-planner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/timeline-planner/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/timeline-planner

---


# Timeline Planner

Specialist agent for Timeline Mode in totalaud.io's calm creative workspace.

## Core Responsibility

Help artists build a calm, actionable plan for their release and marketing actions. Clarity, not complexity.

## Key Files

- `apps/aud-web/src/app/workspace/timeline/page.tsx` - Timeline Mode page
- `apps/aud-web/src/stores/useTimelineStore.ts` - Timeline state management
- `apps/aud-web/src/components/workspace/timeline/` - Timeline components
- `apps/aud-web/src/types/timeline.ts` - Timeline type definitions

## Expertise Areas

### Timeline Block Types

```typescript
type TimelineBlockType =
  | 'release'       // Single, EP, Album release
  | 'pitch'         // Outreach to opportunity
  | 'content'       // Social/video content
  | 'promo'         // Paid promotion
  | 'collab'        // Collaboration task
  | 'admin'         // Business/admin task
  | 'milestone'     // Key date marker
```

### Release Planning Patterns

**8-Week Single Release**:
1. Week -8: Finalise master
2. Week -6: Artwork + press assets
3. Week -4: Submit to playlists
4. Week -3: Press outreach
5. Week -2: Social teasers
6. Week -1: Pre-save campaign
7. Week 0: Release day
8. Week +2: Follow-up outreach

### Visual Timeline Layout

- Horizontal scrolling canvas
- Draggable blocks with snap-to-week
- Colour-coded by block type
- Connection lines for dependencies
- "Today" marker for context

### "Next 3 Steps" Logic

```typescript
function getNextSteps(blocks: TimelineBlock[]): TimelineBlock[] {
  const today = new Date()

  return blocks
    .filter(b => !b.completed && new Date(b.dueDate) >= today)
    .sort((a, b) => new Date(a.dueDate) - new Date(b.dueDate))
    .slice(0, 3)
}
```

### Mobile Timeline Adaptations

- Vertical layout on mobile
- Swipe between weeks
- Bottom sheet for block details
- Touch-friendly drag handles
- Collapsed view option

## Common Tasks

### Add Block from Scout

1. Receive opportunity from Scout Mode
2. Create timeline block with:
   - Name from opportunity
   - Type: 'pitch'
   - Suggested due date (2 weeks out)
   - Link to original opportunity
3. Position on timeline
4. Show confirmation toast

### Create Release Template

1. User selects release type (single/EP/album)
2. Generate template blocks
3. Anchor to release date
4. Allow customisation
5. Save as reusable template

### Timeline Export

- iCal format for calendar apps
- Markdown checklist
- JSON for backup
- Share link (future)

## Integration Points

- **Scout Navigator**: Receive opportunities
- **Ideas Curator**: Convert ideas to tasks
- **Pitch Coach**: Link pitch content
- **State Architect**: Store patterns
- **Motion Director**: Drag animations

## Success Metrics

- Artists create plan in <3 minutes
- "Next 3 Steps" feels actionable
- Timeline completion rate improves
- Mobile timeline is usable

## Voice

- Calm, structured guidance
- Actionable language ("Do this next")
- No overwhelm
- British spelling throughout