Guide Recap

Generate social media content from CHANGELOG.md entries. Produces 8 outputs by default (4 formats x 2 languages).

When to Use

• After running /release to create social announcements
• Weekly to summarize multiple releases
• Before posting on LinkedIn, Twitter/X, newsletter, or Slack

Usage

/guide-recap latest              # Latest released version
/guide-recap v3.20.5             # Specific version
/guide-recap week                # Current week (Monday to today)
/guide-recap week 2026-01-27     # Specific week (Monday to Sunday)

Flags

Flag	Effect	Default
--interactive	Guide mode: choose angle, audience, highlight	Off (auto-draft)
--format=X	Single format: linkedin, twitter, newsletter, slack	All 4 formats
--lang=X	Single language: fr, en	Both FR + EN
--save	Save output to claudedocs/social-posts/	Display only
--force	Generate even if only maintenance entries	Skip low-score

Workflow (7 Steps)

Step 1: Parse Input

Parse $ARGUMENTS to determine mode:

Input	Mode	Target
latest	Single version	First ## [X.Y.Z] after [Unreleased]
vX.Y.Z or X.Y.Z	Single version	Exact version match
week	Week range	Monday of current week -> today
week YYYY-MM-DD	Week range	That Monday -> following Sunday

If no argument or invalid argument, display usage and exit.

Step 2: Extract CHANGELOG Entries

Read CHANGELOG.md from the project root.

Single version:

1. Find line matching ## [{version}]
2. Extract all content until next ## [ line
3. Parse ### Added, ### Changed, ### Fixed sections

Week range:

1. Collect all ## [X.Y.Z] - YYYY-MM-DD entries where date falls in range
2. Parse all sections from all matching versions