ensemble-claude-changelog

Ensemble Command: /ensemble:claude-changelog

This Codex skill mirrors the Ensemble slash command /ensemble:claude-changelog. Follow the workflow below, adapt to the current repository, and keep outputs structured.

This command fetches and displays Claude changelog information from Anthropic documentation. It provides intelligent filtering by version, date, category, and importance level. Results are cached for 24 hours to optimize performance.

Workflow

Phase 1: Parameter Parsing

1. Validate Parameters Parse and validate command parameters

• Parse command-line arguments
• Validate version format (semver)
• Validate date format (YYYY-MM-DD or relative)
• Validate category names
• Validate output format

2. Handle Help Flag Display help if requested

• Check if --help flag is set
• Return comprehensive help text if true
• Continue to workflow if false

Phase 2: Data Fetching

1. Check Cache Check for cached changelog data

• Skip cache if --refresh flag is set
• Check cache directory ~/.ensemble/cache/changelog/
• Verify cache TTL (24 hours)
• Return cached data if fresh

2. Fetch from Network Fetch changelog from Anthropic documentation

• Attempt WebFetch MCP integration (if available)
• Fall back to Node.js HTTPS module
• Apply 5-second timeout
• Retry with exponential backoff (max 2 retries)
• Handle network errors gracefully

3. Cache Response Store fetched data in cache

• Create cache directory if needed
• Write JSON cache file with TTL metadata
• Handle cache write errors (non-critical)

Phase 3: Parsing & Categorization

1. Parse HTML Content Extract structured data from changelog HTML

• Parse HTML with cheerio
• Extract version (semver format)
• Extract release date (ISO 8601)
• Identify section headers (7 categories)
• Extract feature descriptions