Internal Build Spec: YouTube β Interactive Playbook Generator
In-House Tool for 5x PlaybookOS Acceleration | MasteryMade Internal
Product: Internal tool that converts YouTube videos (or webpages) into interactive HTML playbooks using our paint-by-numbers framework.
Strategic Purpose: Accelerate PlaybookOS Phase 1 from 10-14 hours β 2-4 hours per playbook, enabling 30 expert deployments in Year 1 (vs 10 manual limit).
This is NOT a public SaaS product. We're keeping this in-house as strategic advantage. Will white-label for SMB clients at $997/month, but never sell as self-service tool.
PlaybookOS Overview: 6-phase system for turning expert methodologies into multi-purpose conversion assets. Each playbook serves 6 simultaneous purposes (internal learning, expert partnerships, audience building, JV lead gen, ValidationHub acquisition, community distribution).
Current Bottleneck: Phase 1 (Playbook Creation) takes 10-14 hours of manual expert extraction, framework building, and validation per playbook.
| Aspect | Before Tool | After Tool |
|---|---|---|
| Phase 1 Speed | 10-14 hours/playbook | 2-4 hours/playbook |
| Expert Outreach | Permission funnel only | Permission funnel + cold outreach |
| Annual Capacity | 10 playbooks/year | 30+ playbooks/year |
| Monetization | Expert JVs only | Expert JVs + white-label |
| 6-Purpose Strategy | β Unchanged | β Unchanged |
| Quality Gates | β GOLDEN+SHARP 4+ | β GOLDEN+SHARP 4+ |
| Expert Focus | β Core business model | β Core business model |
| Component | PlaybookOS | This Tool | Reconciliation |
|---|---|---|---|
| Expert Extraction | Manual (10-14 hrs) | Automated via Claude API | Tool automates Phase 1 |
| HTML Template | Paint-by-numbers format | Same template | Reuse existing template |
| GOLDEN+SHARP Validation | Manual scoring | Automated + human review | Tool scores, human validates |
| Email Capture | Phase 3 infrastructure | Built into playbook | Tool generates Phase 3 code |
| Distribution | Phase 2 infrastructure | Not included | Still use Phase 2 manually |
This tool automates Phase 1 + generates Phase 3 code. It does NOT replace Phases 2, 4, 5, 6 of PlaybookOS. Think of it as "Phase 1 on steroids."
Goal: Functional tool that can accept YouTube URL and output interactive HTML playbook with 4+ GOLDEN+SHARP score.
SYSTEM PROMPT (Custom Framework): You are a playbook generation expert. Your job is to transform raw content into executable paint-by-numbers playbooks. EXTRACTION METHODOLOGY: 1. Watch/read the entire source material 2. Identify the core methodology or framework 3. Extract ALL actionable steps (don't filter) 4. Apply atomic action test: one verb + one object per step 5. Map dependencies: which steps require which 6. Score against GOLDEN+SHARP criteria (1-5 per letter) OUTPUT REQUIREMENTS: - Interactive HTML using provided template - 8-12 steps minimum - Each step has: goal, instructions, code blocks, verification - Email gate at Step 3-4 - Embedded LLM assistance prompts - Collapsible deeper insights - Mobile responsive QUALITY GATES: - Must score 4+ on ALL GOLDEN+SHARP letters - If score <4 on any letter, explain why and regenerate - Include second-order effects for each major concept - Explicit dependencies marked - What each step unlocks clearly stated TEMPLATE: [Inject HTML template here]
| Feature | Technology | Why This Choice |
|---|---|---|
| HTML Generation | Python Jinja2 templates | Already in stack, simple variable injection |
| PDF Export | Client-side html2pdf.js | No server processing, works offline |
| Markdown Export | JavaScript string templating | Native browser, instant download |
| Email Gate | Mailchimp API webhook | We already use Mailchimp for PlaybookOS |
| Progress Tracking | localStorage API | No database needed, privacy-friendly |
Single-file output: Each playbook is ONE HTML file with all CSS/JS embedded. No external dependencies. This ensures playbooks work forever even if our server goes down.
PROJECT STRUCTURE:
/playbook-automation-tool/
βββ app.py # FastAPI backend
βββ requirements.txt # Python dependencies
βββ .env # API keys (Claude, Jina, Mailchimp)
βββ /templates/
β βββ playbook-template.html # Jinja2 template
βββ /extractors/
β βββ youtube.py # YouTube transcript extraction
β βββ webpage.py # Jina AI webpage extraction
β βββ upload.py # File upload handler
βββ /generators/
β βββ claude_processor.py # Claude API integration
β βββ html_builder.py # HTML generation
βββ /outputs/
βββ [generated-playbooks] # Temp storage before download
STORAGE STRATEGY:
- Generated playbooks stored in /outputs/ for 24 hours
- After download, files auto-delete (no long-term storage)
- User's browser handles playbook persistence via downloads
- No database needed for MVP (add later if white-label requires it)
If ANY of the 3 test playbooks score <4 on ANY GOLDEN+SHARP letter, we iterate the prompt before moving to Phase 2. Do not proceed with quality issues.
| Hours | Task | Owner | Blockers |
|---|---|---|---|
| 0-8 | Setup FastAPI backend + YouTube extraction | Sumit | None |
| 8-16 | Claude API integration + prompt engineering | Jason + Sumit | Requires working extraction |
| 16-24 | HTML template integration + generation logic | Lee + Sumit | Requires Claude working |
| 24-32 | Email gate + download functionality | Lee | Requires HTML generation |
| 32-48 | Testing + prompt iteration | Jason + Will | Requires full pipeline |
| 48-72 | 3 test playbooks + validation | Jason | Requires passing tests |
Brad likes it but doesn't share β Still validates quality, use for cold outreach social proof
Brad says quality is lacking β Iterate tool before proceeding to Alan or cold expert
EMAIL TEMPLATE: Subject: Built an interactive guide from your [Video Title] Hey [Expert Name], I'm a fan of your work on [specific topic from video]. I built this interactive "paint-by-numbers" playbook from your [video title] to help people implement your methodology step-by-step: [Link to playbook] It's completely free, fully attributed to you, and you own it. No strings attached. If your audience would find it useful, feel free to share it. If not, no worriesβjust wanted to create something valuable. - Jason MasteryMade P.S. If you ever want to explore how we could build more of these for your content library, happy to chat.
| Day | Action | Expected Response Time |
|---|---|---|
| Monday | Generate Brad playbook + send | 24-48 hours |
| Tuesday | Generate Alan playbook + send | 24-48 hours |
| Wednesday | Generate cold expert playbook + send | 48-72 hours |
| Thursday-Friday | Track responses, iterate outreach if needed | - |
| # | Expert | Domain | Audience Size | Strategic Value |
|---|---|---|---|---|
| 1 | Brad Himel | Newsletter Growth | 50k+ | Existing partner |
| 2 | Alan | Probiotic Gardening | 25k+ | Existing partner |
| 3 | Alex Hormozi | Business Acquisition | 2M+ | High-value target |
| 4 | Justin Welsh | Solopreneur Systems | 500k+ | Aligned ICP |
| 5 | Dickie Bush | Writing/Content | 300k+ | Content methodology |
| 6 | Dan Koe | Personal Brand | 400k+ | Leverage focus |
| 7 | Bridger Pennington | Sales/Coaching | 150k+ | Warm intro possible |
| 8 | Codie Sanchez | Business Buying | 800k+ | SMB acquisition angle |
| 9 | Leila Hormozi | Operations/Scaling | 1M+ | Systems thinking |
| 10 | Kieran Drew | LinkedIn Growth | 200k+ | Distribution strategy |
Goal: Rank for "[Expert Name] framework" and "[Expert Name] methodology" keywords to capture their audience via organic search.
SEO OPTIMIZATION CHECKLIST: Title Tag: "[Expert Name]'s [Framework/Methodology] - Complete Interactive Playbook" Meta Description: "Step-by-step playbook based on [Expert]'s [video]. Learn [key outcome] with paint-by-numbers execution guide." H1: [Expert Name]'s [Framework]: Interactive Playbook H2s: - What You'll Learn - Who This Is For - The [Expert] Methodology - Step-by-Step Implementation - Resources & Next Steps Internal Links: - Link to other expert playbooks (topical authority) - Link to PlaybookOS architecture page - Link to expert's original video (attribution) Schema Markup: - HowTo schema for step-by-step - Person schema for expert attribution - BreadcrumbList for navigation Image Alt Text: - "[Expert Name] methodology diagram" - "[Framework] step [N] visualization"
| Month | Rankings | Traffic/Playbook | Email Captures |
|---|---|---|---|
| Month 1 | Index + rank page 2-3 | 10-50 visits | 3-15 emails |
| Month 3 | Rank page 1 (positions 5-10) | 100-300 visits | 30-90 emails |
| Month 6 | Rank page 1 (positions 1-5) | 300-1000 visits | 90-300 emails |
Email Gate Location: Step 3-4 of every playbook (after they've seen value, before critical content)
QUALIFICATION QUESTION (At Email Gate): "What brings you to this playbook?" [ ] I'm building [similar thing] for my audience (ICP: Experts/Creators) [ ] I want to learn [expert methodology] for myself (ICP: Operators) [ ] I'm looking for validation/consulting help (ICP: ValidationHub) [ ] Just exploring (ICP: Low priority) SEGMENTATION LOGIC: Building for audience β "Expert Partnership Pipeline" segment Learning for self β "Operator Learning" segment Validation help β "ValidationHub Leads" segment Just exploring β "Nurture - Low Priority" segment Each segment gets tailored email sequence based on intent.
Different ICPs get different sequences. Expert partnership segment gets relationship-building emails. ValidationHub segment gets conversion emails. Operator segment gets long-term nurture.
| Purpose | Metric | Month 1 Target | Success Threshold |
|---|---|---|---|
| 1. Internal Learning | Team competence | Learn 10 methodologies | Can explain each framework |
| 2. Expert Partnerships | Positive responses | 5 of 10 experts respond | 50% response rate |
| 3. Audience Building | Email captures | 300 qualified emails | 30 per playbook avg |
| 4. Expert JV Lead Gen | Expert segment size | 50 creators/experts | 15-20% of total emails |
| 5. ValidationHub | Discovery calls | 5 validation calls | 1.5% of email captures |
| 6. Community Distribution | Organic shares | 50+ upvotes/shares | 5 per playbook avg |
Goal: 20 more playbooks in Months 2-3 (total: 30 by end of Month 3)
At 1-2 partnerships per 10 playbooks, 30 playbooks = 3-6 expert partnerships. This is the critical mass needed to prove the JV model scales.
| Stage | Metric | Target | Conversion Rate |
|---|---|---|---|
| Outreach Sent | Emails sent | 30 | 100% |
| Opened | Email opens | 24 | 80% |
| Responded | Any reply | 12-15 | 40-50% |
| Positive Response | Interested in chat | 6-9 | 20-30% |
| Discovery Call | Call scheduled | 4-6 | 13-20% |
| Partnership Signed | JV agreement | 2-3 | 6-10% |
Use CRM or spreadsheet to track each expert through funnel. Need data to identify where drop-off happens and iterate outreach accordingly.
If failed: Analyze root cause. Is it tool quality? Outreach approach? Expert selection? ICP mismatch? Fix before continuing.
Offering: "Playbook Automation as a Service" for SMB clients and expert partners
WHITE-LABEL PRICING: $997/month or $9,970/year (save 2 months) INCLUDES: - Unlimited playbook generation (realistically 4-8 per month) - White-label branding (logo, colors, domain) - Email integration setup (one-time) - Monthly usage report (which playbooks drove most leads) - 2 hours of support per month - Access to playbook template updates VALUE CALCULATION: Manual playbook creation: 10-14 hours Γ $150/hr = $1,500-$2,100 per playbook They generate 4 playbooks/month β $6,000-$8,400 in value Price: $997/month (83-87% discount vs DIY cost) ROI FOR CLIENT: If 1 playbook drives 50 leads @ $50 CPL = $2,500 value 4 playbooks/month = $10k value generated Cost: $997/month Net ROI: 10x
Pitch: "Turn your internal training videos into onboarding playbooks for new hires."
Pitch: "Automate your lead magnet creation. Generate playbooks from every new video you publish."
Pitch: "Convert your course content into pre-sell playbooks. Let people try before they buy."
| Feature | Description | Build Time | Priority |
|---|---|---|---|
| Client Portal | Upload videos, request playbooks, download outputs | 40 hours | HIGH |
| Branding Config | Logo, colors, fonts, domain customization | 16 hours | HIGH |
| Email Integration | Connect their Mailchimp/ConvertKit API | 8 hours | HIGH |
| Usage Dashboard | Show playbooks generated, leads captured | 24 hours | MEDIUM |
| Support Ticketing | Simple ticket system for support requests | 16 hours | MEDIUM |
| Billing/Stripe | Subscription management | 12 hours | HIGH |
Option 1: Build custom portal (116 hours) - full control, perfect integration
Option 2: Use Airtable + Zapier (16 hours setup) - faster but limited
Recommended: Start with Airtable for first 3-5 clients, build custom when proven (don't over-engineer before validation)
AIRTABLE BASE STRUCTURE: Table 1: Clients - Client Name - Logo URL - Brand Colors (hex codes) - Email Provider (Mailchimp/ConvertKit) - API Key - Subscription Status - Monthly Playbook Count Table 2: Playbook Requests - Client (linked to Clients table) - Video URL - Request Date - Status (Pending/Processing/Complete) - Output URL (link to generated playbook) - Leads Captured (updated monthly) Table 3: Support Tickets - Client (linked) - Issue Description - Status (Open/Resolved) - Created Date ZAPIER AUTOMATION: 1. New row in Playbook Requests β Trigger our tool 2. Tool completes β Update Status to Complete 3. Upload to client's custom domain (or our subdomain) 4. Send email to client with download link CLIENT ACCESS: - Give each client Airtable interface (read-only for outputs) - They submit via form (not direct base access) - We process requests manually until workflow proven
| Layer | Technology | Purpose | Cost |
|---|---|---|---|
| Input | youtube-transcript-api | YouTube transcript extraction | Free |
| Jina AI Reader API | Webpage content extraction | $0 (existing account) | |
| File upload handler | .txt/.docx fallback | Free | |
| Processing | Claude API (Sonnet 4.5) | Content extraction + generation | ~$5-10 per playbook |
| Python + FastAPI | Backend orchestration | Free | |
| Output | Jinja2 Templates | HTML generation | Free |
| html2pdf.js | Client-side PDF export | Free | |
| localStorage API | Progress tracking | Free | |
| Mailchimp API | Email capture | $0 (existing account) | |
| Hosting | Railway or AWS Lambda | Backend hosting | $10-20/month |
| Vercel or Netlify | Static site hosting | Free tier sufficient | |
| AWS S3 | Playbook file storage (temp) | ~$5/month | |
| White-Label | Airtable + Zapier | Client management (Phase 5) | $50/month |
Phases 1-4: ~$15-35/month (hosting + storage)
Phase 5 (White-Label): ~$65-85/month (add Airtable + Zapier)
Variable Cost: ~$5-10 per playbook (Claude API usage)
At 30 playbooks/month: ~$150-300 API costs + $85 fixed = $235-385/month total
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β INPUT LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββ€
β YouTube URL β youtube-transcript-api β
β Webpage URL β Jina AI Reader API β
β File Upload β Python file handler β
ββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β PROCESSING LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββ€
β FastAPI Backend β
β ββ Transcript cleaning β
β ββ Claude API integration β
β β ββ Custom prompt (paint-by-numbers) β
β ββ GOLDEN+SHARP validation β
β ββ HTML template injection β
ββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β OUTPUT LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Generated HTML (single file) β
β ββ Interactive collapsibles β
β ββ Email gate (Step 3-4) β
β ββ PDF export button β
β ββ Markdown export button β
β ββ localStorage progress tracking β
ββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β DELIVERY LAYER β
βββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Download to user's browser β
β OR β
β Upload to S3 β Shareable link β
β OR β
β White-label: Client's subdomain β
βββββββββββββββββββββββββββββββββββββββββββββββββββ
| Person | Role | Responsibilities | Phase Involvement |
|---|---|---|---|
| Jason | Product Owner + Strategy |
β’ Define requirements & success criteria β’ Prompt engineering for Claude β’ Expert outreach & relationship building β’ Quality validation (GOLDEN+SHARP scoring) β’ Strategic decisions at phase gates |
All phases (strategic oversight) |
| Sumit | Backend Engineer |
β’ FastAPI backend development β’ YouTube/webpage extraction integration β’ Claude API integration β’ Hosting setup (Railway/AWS) β’ Debugging & maintenance |
Phase 1-5 (technical build) |
| Lee | Frontend Engineer |
β’ HTML template development β’ Interactive features (collapsibles, progress) β’ Email gate integration β’ PDF/Markdown export functionality β’ Mobile responsiveness |
Phase 1, 5 (UI/UX) |
| Will | Testing + Validation |
β’ Test all 3 validation playbooks β’ Document bugs & edge cases β’ Provide feedback on UX β’ Help with expert research β’ Support white-label client onboarding |
Phase 2-5 (QA + support) |
Year 1 Goal: $100k-$500k revenue from tool-enabled strategy
Breakdown:
| Metric | Frequency | Target | Alert Threshold |
|---|---|---|---|
| Playbooks Generated | Weekly | 2-3 per week | <2 per week (behind pace) |
| Expert Response Rate | Weekly | 40-50% | <30% (outreach issue) |
| Email Captures | Weekly | 60-100 per week | <30 (traffic or conversion issue) |
| GOLDEN+SHARP Scores | Per playbook | All 4+ | Any <4 (quality problem) |
| Generation Time | Per playbook | <5 minutes | >10 minutes (performance issue) |
| Tool Uptime | Daily | 99%+ | <95% (infrastructure problem) |