changelog-review

name	changelog-review
description	Review the Claude Code changelog and summarize recent changes and their significance.
disable-model-invocation	true
argument-hint	[--comprehensive] [--since <date>]
allowed-tools	Read, Write, WebFetch, WebSearch, Task, AskUserQuestion

Claude Code Changelog Review

Fetch the Claude Code changelog, analyze recent changes, and produce a report that explains the significance and implications of the most important updates.

$ARGUMENTS

Step 1: Parse Arguments

Extract from the arguments:

• Mode: Default (significant changes only) or comprehensive (--comprehensive flag)
• Time range: Past week (default), or custom range if --since <date> specified
• Output path: Current working directory (default)

Step 2: Fetch the Changelog

Fetch the Claude Code changelog from:

https://code.claude.com/docs/en/changelog

Use WebFetch to retrieve the full page content. If the fetch fails, try WebSearch to locate the current changelog URL — it may have moved.

Step 3: Identify Changes in Scope

Parse the fetched content and identify all changelog entries that fall within the target time range.

• Match entries by their date headers/labels
• If dates are ambiguous, include entries that could plausibly fall within range
• Collect the full text of each matching entry for analysis

Step 4: Categorize and Prioritize

Classify each change into one of these categories:

Category	Description	Default mode	Comprehensive mode
Major feature	New capabilities, workflows, or integrations	Include	Include
Significant enhancement	Meaningful improvements to existing features	Include	Include
Developer experience	CLI UX, performance, configuration changes	Include if impactful	Include
Minor enhancement	Small quality-of-life improvements	Omit	Include
Bug fix	Corrections to existing behavior	Omit	Include
Internal/infrastructure	Build, CI, dependency updates	Omit	Omit

In default mode, focus on changes that would affect how a user works with Claude Code — new capabilities, changed workflows, or features that unlock new use cases.

In comprehensive mode, cover all user-facing changes including minor enhancements and bug fixes. Still omit purely internal changes.

Step 5: Research Context

For each included change, determine whether additional research is needed to explain its significance:

• New features: Search for documentation, blog posts, or discussions that explain the feature's purpose and intended use cases
• Integration changes: Research the integrated tool/service if unfamiliar
• API or protocol changes: Look up relevant specifications or migration guides
• Terminology: Clarify any Claude Code-specific terms that may be unfamiliar

Use WebSearch and WebFetch to gather this context. The goal is to provide enough background that the reader understands why a change matters, not just what changed.

Step 6: Write the Report

Generate a markdown report with the following structure:

# Claude Code Changelog Review

**Period**: [start date] to [end date]
**Mode**: [Default | Comprehensive]
**Generated**: [current date]

## Highlights

[2-3 sentence executive summary of the most significant changes in this period]

## [Category Name]

### [Change Title]

[1-2 paragraph explanation covering:]
- What changed
- Why it matters — how it affects workflows, unlocks new capabilities, or changes existing behavior
- How to use it — brief practical guidance if applicable
- Any caveats or limitations discovered during research

[Repeat for each change in this category]

[Repeat for each category that has changes]

## Summary

[Brief closing that ties together themes across changes, if any patterns emerge]

Writing guidelines

• Do not merely restate the changelog entry — add context and analysis
• Explain significance from the perspective of a daily Claude Code user
• Use concrete examples where they help illustrate a change's impact
• Group related changes together even if they appeared as separate entries
• If a change builds on a previous change outside the time range, briefly note the connection

Step 7: Save and Present

Save the report as claude-code-changelog-review.md in the current working directory.

After saving, present a brief summary to the user highlighting the 2-3 most impactful changes.