Edit changelog

GOAL: generate changelog entries from git history and update CHANGELOG.md.

WHEN: the agent needs to update the changelog with recent commits.

NOTE: requires CHANGELOG.md and .last-aggregated-commit (auto-initialized).

Efficiency directives

• •Optimize all operations for token and context efficiency
• •Batch operations on file groups, avoid individual file processing
• •Target only relevant files
• •Reduce token usage

Workflow

• •Run scripts/edit-changelog.sh
• •Capture status from first line of output
• •Handle the status:
  • •If ERROR: Stop and report to user
  • •If WARN: Report no changes needed
  • •If SUCCESS: Report success with entry count
• •DONE

Output

Files modified:

• •CHANGELOG.md - Unreleased section updated
• •.last-aggregated-commit - Updated to HEAD

Status communication:

First line of output indicates status:

• •SUCCESS: [message] - Operation completed with changes
• •WARN: [message] - Operation completed but no changes needed
• •ERROR: [message] - Operation failed

References

The following reference files serve as strict guidelines:

• •references/keep-a-changelog-spec.md: Format specification
• •references/changelog-templates.md: Template variations
• •references/changelog-structure.md: Structure documentation
• •references/aggregation-patterns.md: Aggregation patterns