/promote, Release Promotion Post Generator

Generate data-driven X/Twitter posts for plugin releases with ASCII cards ready for CodeSnap screenshots.

When to use

Run /promote vX.Y.Z after tagging a release. Optionally add a title: /promote v2.8.0 "LiveView Streams Overhaul".

Output

All files go to scratchpad/x-posts/{version}-release.md (create directory if needed).

The output file contains three sections:

1. ASCII Card, box-drawing table for CodeSnap screenshot
2. Tweet Thread, 3-5 tweets in proven format
3. CodeSnap Command, exact CLI command to render the card
4. Fact-Check, every claim with verifiable data source

Execution Flow

Step 1: Gather Data

Collect these metrics (all are verifiable commands, run them, don't estimate):

Metric	How to get it
File count + insertions/deletions	git diff --stat {prev-tag}..{tag}
Skill count	ls plugins/elixir-phoenix/skills/ | wc -l
Agent count	ls plugins/elixir-phoenix/agents/*.md | wc -l
Iron Law count	Grep for numbered Iron Laws in CLAUDE.md
Eval scores	make eval-all (run it, report actual numbers)
Changelog entries	Read CHANGELOG.md for this version's section
Before/after metrics	Depends on release, look for quantifiable changes

The strongest posts have before/after comparisons. Look for changes in CHANGELOG.md that have measurable deltas (line counts, counts of affected files, error rates, coverage numbers).

Step 2: Write the ASCII Card

The card is the visual centerpiece, it gets screenshotted via CodeSnap and attached to tweet 1.