tweet-angle-templates
Copy-paste templates for different types of engineering content on Twitter/X.
Table of Contents
- Learning Tweets
- Problem/Solution Tweets
- Debugging Story Tweets
- Architecture Decision Tweets
- Tool Comparison Tweets
- Milestone Tweets
- Hot Take Tweets
- Thread Starters
- Engagement Patterns
Learning Tweets
TIL Format
TIL while working on [project/feature]:
[Specific insight]
[Optional: code snippet or context]Surprise Discovery
I always assumed [common belief].
Turns out [actual finding] when you [context].
[Evidence or example]Quick Tip
[Technology] tip:
[One-liner tip]
Example:[code or command]Problem/Solution Tweets
Simple Format
Problem: [Pain point in one line]
Solution: [What you built/did]
[Optional: Brief how]Before/After
Before: [Old approach - pain]After: [New approach - gain]
The fix: [What changed]Bug Fix Story
Spent [time] debugging [symptom].
Root cause: [Unexpected thing]
Fix: [Solution]
Lesson: [What to check next time]Debugging Story Tweets
The Hunt
3 hours debugging "[error message]"
Tried:❌ [Thing 1]❌ [Thing 2]❌ [Thing 3]
Actual cause: [Surprising root cause]
Check this first next time.The Facepalm
Debugging story:
Symptom: [What was broken]Assumed cause: [Complex theory]Actual cause: [Simple mistake]
Sometimes the bug is [simple explanation].The Rabbit Hole
Started: Fix [simple thing]Ended up: Rewriting [bigger thing]
Here's what I learned down the rabbit hole 🧵Architecture Decision Tweets
Trade-off Analysis
Chose [Option A] over [Option B] for [context]:
✅ [Advantage 1]✅ [Advantage 2]⚠️ [Tradeoff accepted]
Would choose differently if [different context].Pattern Decision
When to use [Pattern A] vs [Pattern B]:
[Pattern A]: [Use case][Pattern B]: [Different use case]
In my case: [What you chose and why]Tech Stack Choice
For [project type], my stack:
• [Tool 1] - [one-line why]• [Tool 2] - [one-line why]• [Tool 3] - [one-line why]
Optimizing for [main constraint].Tool Comparison Tweets
Honest Review
After [time period] with [tool]:
✅ [Pro 1]✅ [Pro 2]❌ [Con 1]❌ [Con 2]
Use it if: [Ideal use case]Skip it if: [Anti-use case]Migration Experience
Migrated from [Tool A] to [Tool B]:
Worth it? [Yes/No/Depends]
The good: [Benefit]The bad: [Cost]The ugly: [Surprise]Quick Comparison
[Tool A] vs [Tool B] for [use case]:
[Tool A]: [One-line characterization][Tool B]: [One-line characterization]
I went with [choice] because [reason].Milestone Tweets
Feature Shipped
Shipped: [Feature name]
What it does: [One line]
The interesting part: [Technical detail]
[Link or screenshot]Project Progress
[Project] progress update:
✅ [Completed thing 1]✅ [Completed thing 2]🔄 Working on: [Current focus]📋 Next: [Upcoming]Numbers Milestone
[Project/Feature] milestone:
• [Metric 1]: [Number]• [Metric 2]: [Number]• [Metric 3]: [Number]
[Brief context on what this means]Version Release
[Project] v[X.Y.Z] released:
• [Feature/fix 1]• [Feature/fix 2]• [Feature/fix 3]
Breaking changes: [Yes/No + brief if yes]
[Link]Hot Take Tweets
Experience-Based Opinion
After [experience], hot take:
[Your opinion]
[Why based on your experience]Controversial Preference
Unpopular opinion: [Statement]
I've tried [alternatives].
[Your reasoning] makes [your choice] better for [context].
Change my mind.Industry Observation
[Common practice] is often wrong.
What works better: [Your alternative]
Proof: [Evidence from your work]Thread Starters
Build Thread Opener
Building [feature/project] from scratch 🧵
Goal: [What you're making]Why: [Motivation]
Let's go →Deep Dive Opener
How [technology/pattern] actually works 🧵
I spent [time] implementing it from scratch.
Here's what I learned →Tutorial Thread
How to [accomplish task] in [technology]:
A step-by-step thread 🧵
Prerequisites: [What you need]
Let's start →Post-Mortem Thread
We shipped [thing] last week.
Here's what went right, wrong, and what I'd do differently 🧵Engagement Patterns
Question for Discussion
Genuine question for [audience]:
[Your question]
Context: [Why you're asking]
Reply with your approach.Poll Setup
[Question about preference/approach]
Reply with:🅰️ [Option A]🅱️ [Option B]🆎 [Option C]🅾️ Other (explain)Call for Experience
[Technology/Pattern] users:
What's your biggest gotcha?
I'll start: [Your example]Best Practices
Do
- Be specific (numbers, names, details)
- Share the struggle, not just the win
- Include code snippets when relevant
- End with a question or CTA when appropriate
- Use line breaks for readability
Don’t
- Overhype (“game-changing”, “revolutionary”)
- Be vague (“working on something cool”)
- Only post wins (vulnerability builds connection)
- Thread everything (single tweets have reach too)
- Forget the link when relevant
Timing
- Post when you’re excited about the work
- Don’t force a tweet from every commit
- 2-3 substantial tweets/week beats 10 low-effort ones
- Threads work well for weekend reading
Quick Reference Card
| Commit Type | Best Angle | Template Style |
|---|---|---|
| New feature | Milestone or Learning | ”Shipped:” or “TIL:“ |
| Bug fix | Debugging Story | ”Spent X debugging…” |
| Refactor | Before/After | ”Before: / After:“ |
| Architecture | Trade-off | ”Chose X over Y because…” |
| Performance | Numbers | ”Before/After metrics” |
| Migration | Tool Comparison | ”Migrated from X to Y” |
| Learning | TIL | ”TIL while building…” |