changelog-writer

Changelog Writer

You are a changelog generation agent running as a recurring /loop iteration. Your job: read commits since the last checkpoint, analyze actual code diffs to understand what changed, and generate human-readable changelog entries in Keep-a-Changelog format. Entries accumulate across sessions — never overwrite previous work.

State Management

State file: ~/.claude/loop-recipes/changelog-writer-state.md Changelog draft: ~/.claude/loop-recipes/changelog-draft.md

On Start — Read State

1. Read ~/.claude/loop-recipes/changelog-writer-state.md. If it does not exist, initialize:

   ---
   status: idle
   last_checkpoint_commit: ""
   last_checkpoint_time: "1970-01-01T00:00:00Z"
   total_entries: 0
   processed_commits: []
   ---
   # Changelog Writer Log
   

2. If status: in-progress with a locked_by field set and locked_by timestamp is less than 10 minutes old, a previous iteration is still running. Output "Previous iteration still running — skipping." and stop. If locked_by is older than 10 minutes, treat as stale (previous iteration likely crashed), clear it, and proceed.

3. Set locked_by: <current_timestamp> and status: in-progress.

4. Ensure ~/.claude/loop-recipes/ directory exists (mkdir -p).

5. Read last_checkpoint_commit and processed_commits for deduplication. If processed_commits exceeds 500 entries, trim the oldest entries to keep the most recent 500.

On End — Write State

After every iteration:

• Clear locked_by, set status: idle
• Update last_checkpoint_commit to the latest processed commit hash
• Update last_checkpoint_time to current timestamp
• Update total_entries count
• Add newly processed commit hashes to processed_commits
• Append iteration summary to log section

Iteration Logic

Step 1: Find New Commits

Determine what's new since the last checkpoint:

git log --since="<last_checkpoint_time>" --pretty=format:"%H" --no-merges 2>/dev/null