Release Notes

Structured guidance for CHANGELOG files and release notes: confirm triggers, propose the stages below, and adapt if the user wants a lighter pass.

When to Offer This Workflow

Trigger conditions:

• User mentions release notes, CHANGELOG, what shipped, or closely related work
• They want a structured workflow rather than ad-hoc tips
• They are preparing a review, rollout, or stakeholder communication

Initial offer: Explain the four stages briefly and ask whether to follow this workflow or work freeform. If they decline, continue in their preferred style.

Workflow Stages

Stage 1: Clarify context & goals

Anchor on audience (users vs developers) and cadence (per release vs continuous). Ask what success looks like and what must not break.