@riotprompt/riotdoc 1.0.3-dev.0 → 1.0.4

package/templates/podcast-script-template.md

@@ -0,0 +1,496 @@
+# Podcast Script Document Template
+
+## Template Structure
+
+This defines the structure and questions for creating podcast script documents in RiotDoc.
+
+**Template Type**: podcast-script  
+**Version**: 2.0  
+**Last Updated**: 2026-01-30
+
+---
+
+## Questions to Answer
+
+### Idea/Draft Phase
+
+These are the questions you can answer **NOW** when planning your podcast episode. Focus on the core content and format decisions.
+
+#### Episode Basics
+- **Episode title**: What's the episode called?
+- **Episode number**: What number is this episode? (if part of a series)
+- **Topic**: What's the main subject?
+- **Angle**: What's your unique take or approach?
+- **Target length**: Short (10-15 min), medium (20-30 min), long (45-60 min+)?
+
+#### Format & Structure
+- **Format**: Interview, solo, co-hosted, panel, narrative storytelling?
+- **Segments**: What are the main segments? (intro, main content, Q&A, outro, ads, etc.)
+- **Tone**: Conversational, educational, entertaining, serious, humorous?
+- **Pacing**: Fast-paced, relaxed, contemplative?
+
+#### Content Planning
+- **Key points**: What are the 3-5 main points to cover?
+- **Stories/examples**: What stories or examples will you use?
+- **Guests**: Who will be on the episode? (if applicable)
+- **Questions**: What questions will you ask? (for interviews)
+
+#### Audio Elements
+- **Music/sound**: Intro music, outro music, sound effects?
+- **Transitions**: How will segments transition?
+
+---
+
+### Publishing Phase
+
+These are questions you figure out **LATER** - after recording and during production/distribution.
+
+#### Production Details
+- **Show notes**: What should go in the show notes?
+- **Timestamps**: Key moments to timestamp?
+- **Links**: Resources, references, or links to include?
+- **Transcript**: Will there be a transcript?
+- **Audio editing**: What editing is needed? (remove filler words, add music, etc.)
+
+#### Distribution
+- **Podcast feed**: Which podcast feed/show?
+- **Release date**: When will this be published?
+- **Social media**: How will this be promoted? (Twitter, LinkedIn, Instagram, TikTok clips?)
+- **Episode description**: SEO-optimized description for podcast platforms?
+- **Tags/categories**: Apple Podcasts categories, tags?
+- **Audiogram/clips**: Create short clips for social media?
+
+#### Guest Coordination (if applicable)
+- **Guest approval**: Does guest need to approve before publishing?
+- **Guest promotion**: How will guest promote the episode?
+- **Guest materials**: Bio, headshot, links for show notes?
+
+---
+
+## Available Approaches
+
+Choose the approach that best fits your podcast format and production goals.
+
+### Approach 1: Quick Solo Episode
+
+**When to use**:
+- Short episode (10-20 minutes)
+- Solo host, no guests
+- Timely topic or quick update
+- Minimal production needed
+- Personal or conversational podcast
+
+**Strategy**:
+- Light scripting - outline with bullet points, not full script
+- Record in one take (or minimal editing)
+- Simple intro/outro music
+- Quick turnaround from recording to publishing
+
+**Output**: Single podcast episode, 10-20 minutes
+
+**Workflow**:
+1. Answer core Idea/Draft questions (title, topic, key points, length)
+2. Create bullet-point outline (not full script)
+3. Record episode in one session
+4. Light editing (remove major mistakes, add music)
+5. Answer Publishing phase questions
+6. Write show notes
+7. Publish
+
+**Timeline**: 1-2 days from idea to published
+
+**Script Format**: Bullet-point outline with key talking points
+
+---
+
+### Approach 2: Structured Interview Episode
+
+**When to use**:
+- Interview format with guest
+- Medium to long episode (30-60 minutes)
+- Professional or educational podcast
+- Want polished, high-quality result
+- Guest requires coordination
+
+**Strategy**:
+- Prepare detailed questions and research guest
+- Coordinate with guest (scheduling, tech check, pre-interview)
+- Record with structured segments
+- Professional editing and production
+- Comprehensive show notes with timestamps
+
+**Output**: Single interview episode, 30-60 minutes
+
+**Workflow**:
+1. Answer all Idea/Draft phase questions
+2. Research guest and prepare questions
+3. Coordinate with guest:
+   - Schedule recording
+   - Tech check (audio quality, software)
+   - Pre-interview discussion (topics, boundaries)
+4. Create interview script with segments:
+   - Intro (introduce guest and topic)
+   - Main interview (prepared questions + follow-ups)
+   - Rapid-fire or fun segment (optional)
+   - Outro (thank guest, where to find them)
+5. Record episode
+6. Edit audio:
+   - Remove filler words and long pauses
+   - Add intro/outro music
+   - Balance audio levels
+   - Add transitions
+7. Get guest approval (if required)
+8. Answer Publishing phase questions
+9. Create show notes with timestamps
+10. Create audiogram clips for social media
+11. Coordinate promotion with guest
+12. Publish
+
+**Timeline**: 1-2 weeks from booking guest to published
+
+**Script Format**: Detailed question list with intro/outro scripts
+
+---
+
+### Approach 3: Narrative Series
+
+**When to use**:
+- Multi-episode story or investigation
+- Highly produced, scripted content
+- Complex topic that needs multiple episodes
+- Want cinematic, immersive experience
+- Documentary or storytelling style
+
+**Strategy**:
+- Plan entire series arc before recording
+- Write full scripts for each episode
+- Record narration, interviews, and ambient sound
+- Extensive editing and sound design
+- Release episodes on schedule (weekly, bi-weekly)
+
+**Output**: Series of 3-8 episodes with narrative arc
+
+**Workflow**:
+1. Answer Idea/Draft questions for overall series theme
+2. Break story into episode structure:
+   - Episode 1: Hook and setup
+   - Episodes 2-N: Development and investigation
+   - Final episode: Resolution and conclusion
+3. For each episode:
+   - Write full script with narration
+   - Identify interview subjects
+   - Plan sound design (music, effects, ambient sound)
+4. Record all narration
+5. Conduct and record interviews
+6. Gather ambient sound and music
+7. Edit each episode:
+   - Assemble narrative structure
+   - Mix narration, interviews, and sound
+   - Add music and effects
+   - Balance audio levels
+8. Create series trailer
+9. Answer Publishing phase questions for each episode
+10. Create comprehensive show notes for each episode
+11. Plan release schedule
+12. Create promotional materials (audiograms, social media posts)
+13. Publish series
+
+**Timeline**: 2-3 months from concept to full series published
+
+**Script Format**: Full scripts with narration, interview clips, and sound design notes
+
+**Series Structure Example**:
+```
+Series: "The Rise of Remote Work" (6 episodes)
+1. Introduction: The Office is Dead (20 min)
+2. The Pandemic Shift: March 2020 (30 min)
+3. The Great Resignation: Why People Quit (35 min)
+4. Building Remote Culture: What Works (30 min)
+5. The Hybrid Debate: Best of Both Worlds? (30 min)
+6. The Future: What's Next for Work (25 min)
+```
+
+---
+
+## Output Document Structure
+
+```markdown
+# Podcast Script: [Episode Title]
+
+**Show**: [Podcast Name]
+**Episode**: [Number]
+**Length**: [Target length]
+**Format**: [Format type]
+**Date**: [Recording/Release date]
+
+---
+
+## Episode Overview
+
+**Topic**: [Main topic]
+**Angle**: [Unique perspective]
+**Key Takeaways**:
+- [Takeaway 1]
+- [Takeaway 2]
+- [Takeaway 3]
+
+---
+
+## Script
+
+### [INTRO MUSIC - 0:00]
+
+**[HOST]**: [Opening lines]
+
+[Intro content - welcome, episode topic, what listeners will learn]
+
+---
+
+### [SEGMENT 1: Main Content - X:XX]
+
+**[HOST]**: [Transition to main content]
+
+[Main discussion points, stories, examples]
+
+**[GUEST]** (if applicable): [Guest responses/contributions]
+
+[Continue with structured conversation/narrative]
+
+---
+
+### [SEGMENT 2: Topic Name - X:XX]
+
+**[HOST]**: [Transition]
+
+[Content for this segment]
+
+---
+
+### [SEGMENT 3: Q&A / Discussion - X:XX]
+
+**[HOST]**: [Questions or discussion points]
+
+[Responses and elaboration]
+
+---
+
+### [OUTRO - X:XX]
+
+**[HOST]**: [Summary of key points]
+
+[Call to action - subscribe, review, visit website, etc.]
+
+[Thank guests, credits]
+
+### [OUTRO MUSIC - X:XX]
+
+---
+
+## Production Notes
+
+### Audio Elements
+- **Intro music**: [Track name/description]
+- **Outro music**: [Track name/description]
+- **Sound effects**: [List of effects and where they appear]
+- **Transitions**: [Description of transition style]
+- **Ambient sound**: [Any background audio or atmosphere]
+
+### Timing
+- **Total length**: [Actual length]
+- **Segment breakdown**:
+  - Intro: [X:XX]
+  - Segment 1: [X:XX]
+  - Segment 2: [X:XX]
+  - Outro: [X:XX]
+
+### Editing Notes
+- [Any specific editing instructions]
+- [Sections that need tightening]
+- [Places to add music or effects]
+
+---
+
+## Show Notes
+
+### Episode Description
+[SEO-optimized description for podcast platforms - 2-3 paragraphs]
+
+[Hook that makes people want to listen]
+
+[What listeners will learn or gain]
+
+### Timestamps
+- 0:00 - Intro
+- X:XX - [Segment name]
+- X:XX - [Key moment]
+- X:XX - [Important quote or insight]
+- X:XX - Outro
+
+### Links & Resources
+- [Resource 1 mentioned in episode]
+- [Resource 2 mentioned in episode]
+- [Book/article/tool referenced]
+
+### Guest Information (if applicable)
+**Name**: [Guest name]
+**Bio**: [Short bio - 2-3 sentences]
+**Links**: 
+- Website: [URL]
+- Twitter: [@handle]
+- LinkedIn: [URL]
+
+### Quotes
+> "[Memorable quote from episode]" - [Speaker]
+
+> "[Another great quote]" - [Speaker]
+
+---
+
+## Metadata
+- **Show**: [Podcast name]
+- **Season**: [Season number]
+- **Episode**: [Episode number]
+- **Category**: [Apple Podcasts category]
+- **Tags**: [tag1, tag2, tag3]
+- **Explicit**: [Yes/No]
+- **Transcript available**: [Yes/No]
+- **Guest**: [Guest name if applicable]
+```
+
+---
+
+## Example Use Cases
+
+### Solo Episodes
+- Personal reflections
+- Educational content
+- News commentary
+- Quick tips and updates
+
+### Interview Episodes
+- Expert interviews
+- Founder stories
+- Industry insights
+- Q&A sessions
+
+### Co-hosted Episodes
+- Debates and discussions
+- Recap episodes
+- News roundups
+- Banter and conversation
+
+### Panel Episodes
+- Multiple guests discussing topic
+- Roundtable discussions
+- Live recordings
+
+### Narrative Episodes
+- Investigative journalism
+- Documentary storytelling
+- Historical deep-dives
+- Serialized fiction
+
+---
+
+## Production Tips
+
+### For Quick Solo Episodes
+- Use bullet points, not full scripts
+- Record in a quiet space
+- Keep it conversational and authentic
+- Don't over-edit - some imperfection is okay
+- Batch record multiple episodes
+
+### For Structured Interviews
+- Research your guest thoroughly
+- Prepare 10-15 questions (use 5-7)
+- Listen actively and ask follow-ups
+- Test audio quality before recording
+- Send questions to guest beforehand (optional)
+- Record locally (not just over internet) for better quality
+
+### For Narrative Series
+- Write full scripts before recording anything
+- Plan the entire arc before starting
+- Record extra material (you'll need it in editing)
+- Invest in good microphone and recording space
+- Use professional editing software
+- Consider hiring audio engineer for mixing
+
+---
+
+## Common Pitfalls to Avoid
+
+❌ **Don't**: Wing it without any preparation
+✅ **Do**: At least create a bullet-point outline
+
+❌ **Don't**: Record in a noisy environment
+✅ **Do**: Find a quiet space with minimal echo
+
+❌ **Don't**: Forget to hit record (it happens!)
+✅ **Do**: Do a test recording first
+
+❌ **Don't**: Talk over your guest constantly
+✅ **Do**: Let them finish, then respond
+
+❌ **Don't**: Publish without show notes
+✅ **Do**: Always include timestamps and links
+
+❌ **Don't**: Forget to promote the episode
+✅ **Do**: Create social media clips and posts
+
+---
+
+## Technical Considerations
+
+### Recording Setup
+- **Microphone**: USB or XLR microphone (not laptop mic)
+- **Headphones**: Closed-back headphones to prevent bleed
+- **Recording software**: Audacity (free), Adobe Audition, Logic Pro, GarageBand
+- **Remote recording**: Riverside.fm, Zencastr, SquadCast for remote guests
+
+### Audio Quality
+- **Sample rate**: 44.1 kHz or 48 kHz
+- **Bit depth**: 16-bit or 24-bit
+- **Format**: WAV for recording, MP3 for distribution
+- **Levels**: Peak around -6 dB to -3 dB, avoid clipping
+
+### Editing Checklist
+- [ ] Remove long pauses and filler words
+- [ ] Cut out false starts and mistakes
+- [ ] Add intro and outro music
+- [ ] Balance audio levels between speakers
+- [ ] Add transitions between segments
+- [ ] Export at proper bitrate (128-192 kbps for MP3)
+
+---
+
+## Template Notes
+
+**Version 2.0 Changes** (2026-01-30):
+- Added three approaches: Quick Solo, Structured Interview, Narrative Series
+- Kept existing Idea/Draft and Publishing phase split (already correct)
+- Added detailed workflows for each approach
+- Added production tips and technical considerations
+- Follows canonical template structure from TEMPLATE-STRUCTURE.md
+
+**Why this template works**:
+- Existing phase split was already correct (87% compliant)
+- Just needed approaches added for different podcast formats
+- Handles solo, interview, and narrative formats
+- Includes production and technical details specific to podcasting
+
+---
+
+## Related Templates
+
+- **Blog Post Template**: For show notes or blog post versions of episodes
+- **Meeting Notes Template**: For planning meetings with guests or team
+- **Email Template**: For guest outreach and coordination
+
+---
+
+## Version History
+
+- **v2.0** (2026-01-30): Added approaches and workflows, enhanced production notes
+- **v1.0** (2026-01-XX): Initial template with lifecycle phases (87% compliant)