Section Create

# Section Creation Workflow (From Scratch to RC)

## Purpose

Complete end-to-end section authoring workflow: research → narrative drafting → validation → visual creation → release candidate. Uses Beads for WBS tracking, ensuring easy pickup without context loss. **Data accuracy is the absolute priority.**

## When to Use This Skill

Use this skill when starting a NEW curriculum section from scratch (Questions 1-10).

**✅ DO use for:**
- Creating a new section from research and initial Q&A
- Complete section authoring workflow
- Sections requiring Beads WBS for multi-session work

**❌ DO NOT use for:**
- Revising existing drafts (use `/section-publish` instead)
- Quick edits or corrections
- Sections without visual requirements

## Related Skills 
/textbook-bestpractices, /infographics-bestpractices, /narrative-refine-validate, /validate, /section-publish

## Critical Success Factors

### 🔴 MOST IMPORTANT: Data Accuracy
- Every statistic verified against primary sources
- No hallucinated numbers or unverified claims
- All quantitative statements traceable to authoritative research
- `/validate` command MUST be run on every draft
- Fact-check reports documented in files

### Beads WBS Tracking
- Create detailed work breakdown structure at START
- Track all tasks, subtasks, and dependencies
- Enable easy pickup without context overhead
- Document progress in Beads, not just conversation

### Narrative Quality
- 🚨 **QUESTION-FOCUSED**: Every section must directly answer its stated question
- Clean, consistent voice for university students
- Supplement narrative with visuals (not replace)
- Follow textbook best practices
- 30-40% conciseness vs academic style
- **No sideramps**: All content must serve answering the core question

### Visual Excellence
- 3-5 well-spaced infographics (landscape, concise)
- Consistent design language across section
- EventAI brand compliance
- Tufte principles (minimal cruft, high data-ink ratio)

## Required Skills Preload

**🔴 CRITICAL: Load these skills FIRST before any work:**

```markdown
/textbook-bestpractices       # Academic writing for university students
/infographics-bestpractices   # Tufte principles, EventAI brand, visual design
/narrative-refine-validate    # Claim validation, source attribution
/validate                     # Comprehensive fact-checking

Why preload? These skills contain essential context that informs ALL decisions throughout the workflow. Loading them upfront avoids context thrashing and ensures consistency.

Workflow Overview

┌──────────────────────────────────────────────────┐
│ INPUT: Section number + research files           │
│ (e.g., Section 2 + question + research/*.md)     │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 0: Beads WBS Creation                       │
│ - Create epic for section                        │
│ - Break down into tasks (research, draft, valid) │
│ - Track dependencies (draft → validate → visual) │
│ → Output: Beads WBS with 10-15 trackable tasks   │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 1: Archive Existing Visuals                 │
│ - Move docs/writing/{topic}/visuals/* → archive/ │
│ - Clean slate for new visual generation          │
│ → Output: Archived old visuals                   │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 2: Research & Context Review                │
│ - Read research/*.sources.md files               │
│ - Read initial question + answer                 │
│ - Identify key themes, statistics, arguments     │
│ → Output: Research synthesis notes               │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 3: Initial Draft Creation                   │
│ - Apply /textbook-bestpractices principles       │
│ - Write for university students                  │
│ - Conversational tone, bold headers, examples    │
│ - Include ALL statistics from research           │
│ → Output: {topic}.draft1.md                      │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 4: Validation & Refinement Loop             │
│ - Run /validate on draft1                        │
│ - Create fact-check report                       │
│ - Apply corrections → draft2                     │
│ - Review against success criteria                │
│ - Iterate until 90%+ accuracy                    │
│ → Output: {topic}.draftN.md (validated)          │
│ → Output: {topic}.draftN-FACT-CHECK-REPORT.md    │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 5: Visual Content Planning                  │
│ - Identify 3-5 infographic opportunities         │
│ - Create visual folders + .content.md/.prompt.md │
│ - Apply /infographics-bestpractices              │
│ - Ensure landscape, concise, consistent style    │
│ → Output: Visual folders with content/prompts    │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 6: Visual Generation & Evaluation           │
│ - Run gemini-generate for each visual (3 vars)   │
│ - Convert PNG → WebP via todd-image-convert      │
│ - Evaluate all variants via /ig-evaluate         │
│ - Select winners (90%+ score target)             │
│ → Output: Infographics (evaluated + selected)    │
└──────────────────────────────────────────────────┘
                    ↓
┌──────────────────────────────────────────────────┐
│ STEP 7: Final Integration                        │
│ - Insert visual references in narrative          │
│ - Add figure captions and alt text