---
name: change-logger
description: Generate and maintain the root CHANGELOG.md in a beginner-friendly, analogy-rich format from git state or a commit range.
---

# Change Logger — quick diffs

Produce a dated, analogy-rich markdown entry in `CHANGELOG.md` so reviewers (human or model) see what moved without wading through raw diffs.

## Main use case

- Default: include committed changes since the last base marker in `CHANGELOG.md` plus current working tree edits, then record a new base marker.
- Optional: limit to staged only or a specific commit range (e.g., `main..HEAD`).
- Output: grouped by the first two path segments (e.g., `skills/brave-search`) with A/M/D/R counts and short analogies.

## Commands

- Show help: `./scripts/change-logger.ts --help`
- Working tree (staged + unstaged): `./scripts/change-logger.ts`
- Staged only: `./scripts/change-logger.ts --staged`
- Commit range: `./scripts/change-logger.ts --range main..HEAD`
- Custom section title: `./scripts/change-logger.ts --title "Landing page polish"`

## Notes

- Requires git in PATH and a repository context.
- Ignored dirs follow git defaults; handles renames via git diff output.
- Writes/updates `CHANGELOG.md` at the repo root with dated sections and analogies; ideal for PRs, oracle prompts, or release notes.
- The base commit marker is stored in each new changelog section and used on subsequent runs to avoid re-listing old commits.