Changelog Social

Generate engaging social media announcements from changelog entries.

Workflow

Step 1: Extract Changelog Entry

Read ./CHANGELOG.md and extract the latest version entry. The changelog follows this format:

## [VERSION]

### 🎁 Features
* **Title** — Description

### 🐛 Bug Fixes
* **Title** — Description

### 📚 Documentation
* **Title** — Description

### 🔧 Maintenance
* **Title** — Description

Parse:

Version number (e.g., 6.0.0-Beta.5)
Features - New functionality, enhancements
Bug Fixes - Fixes users will care about
Documentation - New or improved docs
Maintenance - Dependency updates, tooling improvements

Step 2: Get Git Contributors

Use git log to find contributors since the previous version. Get commits between the current version tag and the previous one:

# Find the previous version tag first
git tag --sort=-version:refname | head -5

# Get commits between versions with PR numbers and authors
git log <previous-tag>..<current-tag> --pretty=format:"%h|%s|%an" --grep="#"

Extract PR numbers from commit messages that contain # followed by digits. Compile unique contributors.

Step 3: Generate Discord Announcement

Limit: 2,000 characters per message. Split into multiple messages if needed.

Use this template style:

🚀 **BMad vVERSION RELEASED!**

🎉 [Brief hype sentence]

🪥 **KEY HIGHLIGHT** - [One-line summary]

🎯 **CATEGORY NAME**
• Feature one - brief description
• Feature two - brief description
• Coming soon: Future teaser

🔧 **ANOTHER CATEGORY**
• Fix or feature
• Another item

📚 **DOCS OR OTHER**
• Item
• Item with link

🌟 **COMMUNITY PHILOSOPHY** (optional - include for major releases)
• Everything is FREE - No paywalls
• Knowledge shared, not sold

📊 **STATS**
X commits | Y PRs merged | Z files changed

🙏 **CONTRIBUTORS**
@username1 (X PRs!), @username2 (Y PRs!)
@username3, @username4, username5 + dependabot 🛡️
Community-driven FTW! 🌟

📦 **INSTALL:**
`npx bmad-method@VERSION install`

⭐ **SUPPORT US:**
🌟 GitHub: github.com/bmad-code-org/BMAD-METHOD/
📺 YouTube: youtube.com/@BMadCode
☕ Donate: buymeacoffee.com/bmad

🔥 **Next version tease!**

Content Strategy:

Focus on user impact - what's better for them?
Highlight annoying bugs fixed that frustrated users
Show new capabilities that enable workflows
Keep it punchy - use emojis and short bullets
Add personality - excitement, humor, gratitude

Step 4: Generate Twitter Post

Limit: 25,000 characters per tweet (Premium). With Premium, use a single comprehensive post matching the Discord style (minus Discord-specific formatting). Aim for 1,500-3,000 characters for better engagement.

Threads are optional — only use for truly massive releases where you want multiple engagement points.

See examples/twitter-example.md for the single-post Premium format.

Content Selection Guidelines

Include:

New features that change workflows
Bug fixes for annoying/blocking issues
Documentation that helps users
Performance improvements
New agents or workflows
Breaking changes (call out clearly)

Skip/Minimize:

Internal refactoring
Dependency updates (unless user-facing)
Test improvements
Minor style fixes

Emphasize:

"Finally fixed" issues
"Faster" operations
"Easier" workflows
"Now supports" capabilities

Examples

Reference example posts in examples/ for tone and formatting guidance:

discord-example.md — Full Discord announcement with emojis, sections, contributor shout-outs
twitter-example.md — Twitter thread format (5 tweets max for major releases)
linkedin-example.md — Professional post for major/minor releases with significant features

When to use LinkedIn:

Major version releases (e.g., v6.0.0 Beta, v7.0.0)
Minor releases with exceptional new features
Community milestone announcements

Read the appropriate example file before generating to match the established style and voice.

Output Format

CRITICAL: ALWAYS write to files - Create files in _bmad-output/social/ directory:

{repo-name}-discord-{version}.md - Discord announcement
{repo-name}-twitter-{version}.md - Twitter post
{repo-name}-linkedin-{version}.md - LinkedIn post (if applicable)

Also present a preview in the chat:

## Discord Announcement

[paste Discord content here]

## Twitter Post

[paste Twitter content here]

Files created:

_bmad-output/social/{filename}

Offer to make adjustments if the user wants different emphasis, tone, or content.

bmad-os-changelog-social