Edit Changelog

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