Presentation Spec

Create detailed slide-by-slide specification for a class presentation.

Frontmatter

context: main
allowed-tools: Read, Write, Edit, AskUserQuestion

Prerequisites

• •lesson-plan-{topic}.md must exist and pass Gate 1
• •master-presentation-spec.md must exist
• •Topic must be specified in invocation

Instructions

You are creating a detailed specification for presentation slides. This document serves as the blueprint for implementation.

Usage

/presentation-spec {topic}

Step 1: Review Prerequisites

Read these files:

• •lesson-plan-{topic}.md - Objectives and activities to support
• •master-presentation-spec.md - Design constraints and patterns
• •research/research-{topic}.md - Visualization patterns and content

Extract:

• •Learning objectives to achieve
• •Lesson sequence to follow
• •Visualization patterns to implement
• •Design constraints to follow

Step 2: Map Objectives to Slides

Create a mapping showing how slides will support each objective:

Every objective must have supporting slides.

Step 3: Plan Slide Sequence

Determine the overall flow:

1. •Title slide: Class number, topic, theme
2. •Agenda/Overview: What we'll cover
3. •Hook: Attention-grabbing opening
4. •Content slides: Main instruction
5. •Activity slides: Practice moments
6. •Summary: Key takeaways
7. •Appendix: Reference material

Step 4: Specify Each Slide

For each slide, document:

• •Number and title
• •Slide type (from master spec)
• •Purpose (what it accomplishes)
• •Content: Exact text, bullets, or visual
• •Speaker notes: What instructor says
• •Timing: How long to spend
• •Interaction: Click-through, questions, etc.

Step 5: Specify Visualizations

For any slide with D3 or complex visuals:

• •Visualization name
• •Type: Chart, diagram, animation
• •Data structure: What data it uses
• •Interaction model: Click, hover, scroll
• •Animation sequence: What animates when
• •Technical notes: Implementation hints

Step 6: Plan Interactions

Mark points where students engage:

• •Discussion questions
• •Poll/survey moments
• •Think-pair-share
• •Practice exercises
• •Reflection pauses

Step 7: Write Presentation Spec

Create src/pages/class-{n}-{topic}/presentation-spec-{topic}.md:

# Presentation Spec: {Topic Title}

Class: {N}
Duration: {minutes} minutes
Theme: {Theme name} ({color})
Total Slides: {count}

## Objective Coverage Matrix

| # | Objective | Supporting Slides |
|---|-----------|-------------------|
| 1 | {objective} | {slide numbers} |
| 2 | {objective} | {slide numbers} |
| 3 | {objective} | {slide numbers} |

## Slide Sequence Overview

| # | Title | Type | Time | Purpose |
|---|-------|------|------|---------|
| 1 | {title} | title | 1 min | Opening |
| 2 | {title} | content | 2 min | Agenda |
| ... | ... | ... | ... | ... |

## Detailed Slide Specifications

### Slide 1: {Title}

**Type**: slide-title
**Time**: 1 minute
**Purpose**: Opening, establish topic

**Content**:

Class {N} {Topic Title} {Subtitle if any}

**Speaker Notes**:
{What instructor should say}

**Technical Notes**:
- Theme color: {color}
- Background: {description}

---

### Slide 2: {Title}

**Type**: slide-content
**Time**: 2 minutes
**Purpose**: Set expectations

**Content**:

Today We'll Cover: • {bullet 1} • {bullet 2} • {bullet 3}

**Speaker Notes**:
{notes}

---

### Slide {N}: {Visual Title}

**Type**: slide-visual
**Time**: 5 minutes
**Purpose**: {what it achieves}

**Visualization Spec**:

**Name**: {visualization-name}
**Type**: {D3 chart / CSS animation / etc.}

**Data Structure**:
```json
{
  "items": [
    { "label": "...", "value": ... }
  ]
}

Visual Description: {Detailed description of what it looks like}

Animation Sequence:

1. •{Initial state}
2. •{On first click: what animates}
3. •{On second click: what animates}
4. •{Final state}

Interaction:

• •Click: {what happens}
• •Hover: {what happens}

Technical Requirements:

• •Responsive: Must use viewBox
• •Font sizes: 1.25rem minimum for labels
• •Colors: Use --theme-color for primary

Speaker Notes: {What to say while visualization plays}

Slide {N}: Activity

Type: slide-content Time: 10 minutes Purpose: Student practice

Content:

Activity: {Name}

Instructions:
1. {step 1}
2. {step 2}
3. {step 3}

Time: {X} minutes

Activity Details:

• •Format: {individual/pairs/groups}
• •Materials: {what students need}
• •Expected output: {what they produce}

Speaker Notes: {How to facilitate}

{Continue for all slides}

Interaction Points

Visualization Inventory

Time Budget

Design Notes

• •Theme color: {hex}
• •Key visual motif: {description}
• •Consistent elements: {what repeats}

Appendix Slides (if any)

Gate 2 Checklist:

• • Every objective has supporting slides
• • Complex concepts have visualization specs
• • Interaction points are marked
• • Slide flow supports learning progression
• • Times sum to class duration
• • Sources cited for content

---

## Output Specification

This skill produces:

- **Primary Output**: `src/pages/class-{n}-{topic}/presentation-spec-{topic}.md`
- **Format**: Markdown with detailed slide specifications
- **Gate**: Must pass Gate 2 before proceeding to presentation-build

---

## Gate 2 Checklist

After creating the spec, verify:

- [ ] Every learning objective has at least one supporting slide
- [ ] Complex concepts have D3/visualization specs
- [ ] Interaction points (questions, activities) are marked
- [ ] Slide flow supports logical learning progression
- [ ] Time estimates per slide sum to class duration
- [ ] All content sources are cited
- [ ] Visualization specs include font size requirements

---

## Examples

### Example: Visualization Spec

```markdown
### Slide 6: Market Sizing Funnel

**Type**: slide-visual
**Time**: 5 minutes
**Purpose**: Visualize TAM → SAM → SOM progression

**Visualization Spec**:

**Name**: tam-sam-som-funnel
**Type**: D3 animated funnel

**Data Structure**:
```json
{
  "levels": [
    { "name": "TAM", "value": 50000000000, "label": "Total Addressable Market" },
    { "name": "SAM", "value": 5000000000, "label": "Serviceable Available Market" },
    { "name": "SOM", "value": 500000000, "label": "Serviceable Obtainable Market" }
  ]
}

Visual Description: Three nested trapezoids, widest at top (TAM), narrowing to SOM. Each level has label on left, dollar value on right. Background gets progressively darker/more saturated toward SOM.

Animation Sequence:

1. •Initial: Empty container
2. •Click 1: TAM trapezoid fades in (800ms ease-out)
3. •Click 2: SAM slides up from bottom, nested inside TAM
4. •Click 3: SOM slides up, nested inside SAM
5. •Final: All three visible with values

Interaction:

• •Hover on level: Shows full description tooltip
• •Click level: Highlights and shows calculation

Technical Requirements:

• •viewBox="0 0 600 400"
• •Labels: 1.25rem, Inter font
• •Values: 1.5rem, bold
• •Colors: theme-1-customer with 80%, 60%, 40% opacity