cm-readmelisted

# cm-readme Pre-release helper that keeps `README.md` honest. Reads a chosen range of `CHANGELOG.md`, aggregates Added/Changed/Removed entries to **net state as of HEAD**, edits only between HTML comment markers in the README, plans the media work with an explicit hero-recapture verdict, and verifies before handing off. This skill is **read-only on version metadata** — it never bumps `package.json` or moves `[Unreleased]` headers in `CHANGELOG.md`. --- ## Arguments (`$ARGUMENTS`) Parse the slash command argument string before anything else. Recognized tokens: | Token | Meaning | |---|---| | *(empty)* | Default: range = `[Unreleased]` only | | `since=<ver>` | Range = `<ver>` (exclusive) → `[Unreleased]` (inclusive). E.g., `since=0.2.0` | | `since=tag` | Range = last git tag (`git describe --tags --abbrev=0`) → `[Unreleased]`. Same as default in practice. | | `all` or `from-beginning` | Range = first version in CHANGELOG → `[Unreleased]` | | `dry-run` | Produce diff but do not write README.md | | `features-only` | Only update `<!-- features:* -->` | | `media-only` | Only run media plan + capture | | `hero` \| `features` \| `quickstart` \| `cli` | Restrict to a single marker block | Tokens combine: `/readme since=0.2.0 dry-run features-only` is valid. If `all` is set, also tell the user up front: "Running full-history aggregation — this rebuilds the entire feature list from net state, not just additions." --- ## Workflow Run these steps in order. ### 1. Inventory ``