Summary

Add automated release notes generation using Claude when a GitHub Release is created.

Changes

Claude Workflow (claude.yml):

• New release-notes job triggered on release: created event
• Generates comprehensive release notes analyzing commits, PRs, and diffs
• Publishes to both GitHub Release and documentation website
• Auto-bumps version.py to next patch version for development
• Mandatory self-review step ensures Claude verifies its output

Docs Validation Workflow (docs.yml):

• New workflow triggered on changes to docs/**
• Validates full MDX syntax using Mintlify CLI (mintlify build)

Release Notes Validator (util/validate_release_notes.py):

• Validates release notes MDX files
• Checks frontmatter (title, description required)
• Validates required sections (Overview, What's New, Full Changelog)
• Verifies changelog comparison link

CLAUDE.md:

• Added "Always Review Your Changes" guidance for all Claude Code interactions

Features

Release Flow

Release v0.16.0 created
        │
        ▼
1. Generate context (commits, PRs, diffs by component)
2. Claude writes release notes
   ├── RELEASE_NOTES.md
   └── docs/releases/v0.16.0.mdx
3. Claude reviews its output (reads back files, verifies formatting)
4. Validate MDX (frontmatter, sections, links)
5. Update docs.json (add to Releases tab)
6. Bump version.py → 0.16.1
7. Commit & push to main
8. Update GitHub Release with notes

Robustness

• MDX validation - Checks frontmatter (title, description), required sections, changelog link
• Version validation (skips bump on non-standard versions like v1.0.0-beta)
• Empty commit prevention
• Graceful handling of first release (no previous tag)
• Component-based diff splitting for token limits