@danhachuel/thunderbolt 0.2.49 → 0.2.51

package/seed/references/title-formulas.md

@@ -0,0 +1,288 @@
+# Title Formulas Library
+
+> 50+ proven title formulas organized by category with examples and platform notes.
+
+---
+
+## Curiosity-Gap Formulas
+
+### The Hidden Knowledge
+```
+What [group] won't tell you about [topic]
+```
+Examples:
+- "What senior engineers won't tell you about system design"
+- "What VCs won't tell you about fundraising"
+
+### The Secret
+```
+The [adjective] secret to [outcome]
+```
+Examples:
+- "The counterintuitive secret to writing faster"
+- "The brutal secret to getting promoted"
+
+### The Discovery
+```
+I discovered [thing] that [unexpected result]
+```
+Examples:
+- "I discovered a prompt pattern that 10x'd my output quality"
+- "We discovered why 90% of A/B tests fail"
+
+### The Truth
+```
+The [surprising] truth about [topic]
+```
+Examples:
+- "The uncomfortable truth about passive income"
+- "The real truth about 10x engineers"
+
+---
+
+## Contrarian Formulas
+
+### The Death Declaration
+```
+[Common practice] is dead. [New paradigm] is next.
+```
+Examples:
+- "Single-pass prompting is dead. Deliberative refinement is next."
+- "Traditional SEO is dead. Zero-click is the new game."
+
+### The Stop/Start
+```
+Stop [common action]. Start [better action].
+```
+Examples:
+- "Stop asking AI for answers. Start making it defend them."
+- "Stop chasing virality. Start building compounding content."
+
+### The Wrong Approach
+```
+[Popular opinion] is wrong — here's why
+```
+Examples:
+- "\"Ship fast\" is wrong — here's why deliberate speed wins"
+- "The 10x engineer myth is wrong — here's what actually matters"
+
+### The Bad Advice
+```
+[Common advice] is bad advice — do this instead
+```
+Examples:
+- "\"Fake it til you make it\" is bad advice — do this instead"
+- "\"Move fast and break things\" is bad advice — here's reality"
+
+---
+
+## Listicle Formulas
+
+### The Achievement List
+```
+[Number] ways to [achieve X] without [sacrifice]
+```
+Examples:
+- "7 ways to grow your audience without burning out"
+- "5 ways to ship faster without sacrificing quality"
+
+### The Mistake List
+```
+[Number] [topic] mistakes destroying your [metric]
+```
+Examples:
+- "9 headline mistakes destroying your CTR"
+- "6 thumbnail mistakes killing your views"
+
+### The Wish List
+```
+[Number] things I wish I knew before [starting X]
+```
+Examples:
+- "12 things I wish I knew before my first startup"
+- "8 things I wish I knew before learning to code"
+
+### The Lesson List
+```
+[Number] lessons from [notable experience]
+```
+Examples:
+- "15 lessons from 10 years of remote work"
+- "7 lessons from scaling to 1M users"
+
+---
+
+## How-To Formulas
+
+### The Complete Guide
+```
+How to [achieve X] in [timeframe] (step-by-step)
+```
+Examples:
+- "How to write viral headlines in 10 minutes (step-by-step)"
+- "How to build an MVP in one weekend (step-by-step)"
+
+### The Objection Handler
+```
+How to [achieve X] even if [common objection]
+```
+Examples:
+- "How to build an audience even if you're introverted"
+- "How to learn to code even if you think you're bad at math"
+
+### The Case Study
+```
+How I [achieved X] (and how you can too)
+```
+Examples:
+- "How I got 100K followers in 6 months (and how you can too)"
+- "How I doubled my income with one skill (and how you can too)"
+
+### The Authority Breakdown
+```
+How [authority] [achieved X] — broken down
+```
+Examples:
+- "How MrBeast designs thumbnails — broken down"
+- "How Stripe writes documentation — broken down"
+
+---
+
+## Question Formulas
+
+### The Myth Buster
+```
+Is [common belief] actually [myth/true]?
+```
+Examples:
+- "Is cold email actually dead?"
+- "Is SEO actually harder in 2025?"
+
+### The Challenge
+```
+Can [ordinary thing] really [impressive claim]?
+```
+Examples:
+- "Can one prompt really replace an entire workflow?"
+- "Can you really learn to code in 3 months?"
+
+### The Investigation
+```
+What happens when you [action] for [time]?
+```
+Examples:
+- "What happens when you post daily for 100 days?"
+- "What happens when you use AI for everything for a month?"
+
+---
+
+## Comparison Formulas
+
+### The Showdown
+```
+[A] vs [B]: Which [outcome] better?
+```
+Examples:
+- "Notion vs Obsidian: Which scales better?"
+- "Claude vs GPT-4: Which codes better?"
+
+### The Test
+```
+I tried [A] and [B] — here's the winner
+```
+Examples:
+- "I tried 10 AI writing tools — here's the winner"
+- "I tested 5 thumbnail styles — here's what won"
+
+---
+
+## Prediction Formulas
+
+### The Year Call
+```
+[Concept] is the [year] [category] that [outcome]
+```
+Examples:
+- "Deliberative refinement is the 2026 technique that matters most"
+- "Context windows are the 2025 bottleneck killing agents"
+
+### The Trend Alert
+```
+[Number] [topic] trends for [year] you need to know
+```
+Examples:
+- "7 AI trends for 2025 you need to know"
+- "5 content trends for 2026 you can't ignore"
+
+---
+
+## Problem/Solution Formulas
+
+### The Fix
+```
+[Common problem]? Here's the fix
+```
+Examples:
+- "Prompt outputs feel generic? Here's the fix"
+- "Blog posts not ranking? Here's the fix"
+
+### The Real Reason
+```
+The real reason [problem] keeps happening
+```
+Examples:
+- "The real reason your content doesn't go viral"
+- "The real reason developers hate meetings"
+
+---
+
+## Negative/Loss Aversion Formulas
+
+### The Warning
+```
+Warning: [Thing] is [damaging your thing]
+```
+Examples:
+- "Warning: This common habit is killing your productivity"
+- "Warning: Your thumbnail strategy is costing you views"
+
+### The Hidden Danger
+```
+The hidden danger of [common practice]
+```
+Examples:
+- "The hidden danger of over-optimization"
+- "The hidden danger of following best practices blindly"
+
+---
+
+## Platform-Specific Adaptations
+
+### YouTube (50-60 chars)
+- Front-load keywords
+- Add numbers when possible
+- Include emotional trigger words
+
+### Reddit (60-80 chars)
+- Add subreddit context
+- Use authentic voice
+- Include specificity
+
+### Twitter/X (<280 chars per hook)
+- Standalone viral potential
+- No numbering (1/, 2/, etc.)
+- Quotable fragments
+
+### LinkedIn (story-first)
+- Personal experience angle
+- "Unpopular opinion:" works well
+- Contrarian takes perform
+
+### Email (30-50 chars)
+- Personalization increases opens
+- Urgency/scarcity when appropriate
+- Questions perform well
+
+---
+
+**Test at least 20 variations before selecting final title.**

package/seed/references/trend-intelligence.md

@@ -0,0 +1,99 @@
+# Trend Intelligence Module
+
+> **Progressive Disclosure:** This module is only needed when the user does NOT already have a topic or trend to write about. If the content brief already specifies a subject, skip this section entirely.
+
+## When to Use This Module
+
+- User says "find me something viral" or "what's trending?"
+- User wants content but has no specific topic
+- User wants to ride a wave early
+
+## When to SKIP This Module
+
+- User already has a specific topic, product, or idea
+- User is optimizing existing content
+- User says "make THIS viral" (they have the content already)
+
+## Trend Detection Framework
+
+### Layer 1: Real-Time Signals (Free)
+
+**Reddit Rising**
+- Browse r/all, r/popular, r/trending
+- Sort by "rising" not "hot" (hot = already peaked)
+- Look for posts with high comment-to-upvote ratio (controversy = engagement)
+- Subreddit-specific: r/MachineLearning, r/LocalLLaMA, r/ChatGPT, r/technology, r/programming
+
+**Hacker News**
+- Front page + "new" sort
+- Comments > 50 usually signal a trending topic
+- Show HN posts = product launch opportunities
+
+**X/Twitter**
+- Trending topics (location-based)
+- Follow curated Lists in your niche
+- Search: "just shipped", "I built", "after X years" (high-engagement patterns)
+
+**Google Trends**
+- trends.google.com → daily search trends
+- Rising queries = emerging topics
+- Compare 5 topics, pick the steepest curve
+
+### Layer 2: Aggregator Tools (Free)
+
+| Tool | What It Finds | URL |
+|------|--------------|-----|
+| Exploding Topics | Rapidly growing search terms | explodingtopics.com |
+| Glimpse | Google Trends + social signals | glimpse.co |
+| Trend Hunter | Consumer trend reports | trendhunter.com |
+| Product Hunt | New product launches | producthunt.com |
+| BetaList | Pre-launch startups | betalist.com |
+| Hacker News Show | New projects | news.ycombinator.com/show |
+
+### Layer 3: Trend-to-Content Conversion
+
+Once you identify a trend, convert it using this framework:
+
+```
+TREND: [What's happening]
+↓
+ANGLE: [What's the contrarian/unexpected take?]
+↓
+HOOK: [Prediction or Stakes pattern from title-formulas.md]
+↓
+PLATFORMS: [Which platforms care about this?]
+↓
+CONTENT: [Generate using the main skill workflow]
+```
+
+### Trend Scoring Matrix
+
+Score each trend 1-5 on:
+
+| Factor | 1 (Low) | 5 (High) |
+|--------|---------|----------|
+| Growth velocity | Flat | Exponential |
+| Audience overlap | None | Perfect match |
+| Controversy potential | Safe | Divisiveness |
+| Timeliness | Old news | Breaking |
+| Your expertise | None | Deep knowledge |
+
+**Only pursue trends scoring 15+ out of 25.**
+
+### Trend Decay Awareness
+
+- **24-hour trends:** Meme formats, breaking news → act fast or miss
+- **Weekly trends:** Product launches, blog posts → 2-3 day window
+- **Monthly trends:** Industry shifts, seasonal topics → plan ahead
+- **Evergreen:** Always relevant → optimize for search, not speed
+
+## Platform-Specific Trend Sources
+
+| Platform | Where to Look | Signal |
+|----------|--------------|--------|
+| Reddit | r/trending, r/all (rising) | High comment velocity |
+| X/Twitter | Trending, Lists | Reply ratio > 1:1 |
+| YouTube | Trending tab | View velocity (views/hour) |
+| TikTok | For You page | Share-to-view ratio |
+| LinkedIn | News feed | Comment velocity |
+| Hacker News | New + Show HN | Points in first 2 hours |