@gurupanguji

Technical Specification: Improved April 2026 Social Snippets

1. Goal

Generate high-quality, voice-aligned social media snippets for blog posts starting from 2026-04-02 onwards, replacing the existing scaffolds in _snippets/.

2. Scope

Target posts in _posts/:

• 2026-04-02-llm-in-a-flash.md
• 2026-04-03-amazon-phone.md
• 2026-04-04-we-are-in-weird-times.md
• 2026-04-05-maintenance-overload.md
• 2026-04-06-nobody-gets-promoted-for-simplicity.md
• 2026-04-07-gratitude-for-the-small-moments.md
• 2026-04-08-everything-is-shit-is-lazy.md
• 2026-04-09-metallica-megadeth-the-who.md
• 2026-04-10-android-is-the-fastest-web-browsing-experience.md
• 2026-04-11-the-evaporation-of-gatekeeping.md
• 2026-04-12-a-month-inside-the-agent-loop.md
• 2026-04-13-feedback.md

Output: Updated markdown files in _snippets/ matching the source filenames.

3. Constraints

• Voice Calibration: Strictly adhere to my-voice.md, compounding-voice-fidelity.md, and about-me.md.
• Formatting: No em-dashes. Use “I” (first person singular).
• Platform Strategy:
  • Twitter: Sharp, click-forward, hashtags (2), < 280 chars.
  • Tumblr: Internet-native, reflective, hashtags (2).
  • LinkedIn: Thesis-first, professional, hashtags (2).
  • Threads: Conversational friction, hashtag (1).
  • Bluesky: Idea-first, brisk, hashtags (2), < 300 chars.
  • Mastodon: Substance-high, humble, hashtags (2), < 500 chars.
  • Instagram/Pixelfed: Caption-style, save-forward.
• Link Posts (🔗): Use “I linked to…” and source attribution.
• Consistency: Keep core tension parity across platforms but vary the expression.

4. Verification

• Validate markdown structure against scripts/validate_posts.py.
• Peer review for voice fidelity (LLM self-correction).
• Character count checks for Twitter and Bluesky.