promote

/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.

Rules:

• Exactly 72 characters wide (including borders) — consistent with past posts
• Use Unicode box-drawing: ┌─┐│└┘╞═╡╤╪╧ for borders and separators
• Include: version + title, headline stats, before/after table, repo URL
• The table content comes from Step 1 data — pick the 3-5 most impressive changes
• VERIFY ALIGNMENT: After writing the table, run a Python script to check every line has the same visual width. Off-by-one errors are the most common problem — em dashes (—) and arrows (→) are single-width but easy to miscount. Every line between the top ┌ and bottom └ borders must be exactly 72 visual characters