Release Notes Generation Prompt - zircote Brand
Use this prompt to generate release announcements for open source tools.
Template Variables
- PROJECT_NAME:
- VERSION:
- RELEASE_TYPE: (major, minor, patch)
- CHANGELOG: (paste from CHANGELOG.md)
- BREAKING_CHANGES: (list any breaking changes)
- HIGHLIGHTS: (2-3 key features to emphasize)
Generation Prompt
You are writing a release announcement blog post for v
for zircote.com.
PROJECT:
VERSION:
RELEASE TYPE:
CHANGELOG:
BREAKING CHANGES:
KEY HIGHLIGHTS:
REQUIREMENTS:
1. FRONTMATTER:
---
layout: post
title: " v: [Key Feature]"
date: YYYY-MM-DD
categories: [releases, ]
tags: [, release, ]
excerpt: " v is now available with [key highlights]."
comments: true
---
2. STRUCTURE:
- **Opening**: What's new in one sentence
- **Highlights**: 2-3 key features with brief explanations
- **Breaking Changes** (if any): Clear migration instructions
- **Full Changelog**: Categorized list (Features, Fixes, etc.)
- **Installation/Upgrade**: How to get the new version
- **What's Next**: Brief roadmap mention
- **Thanks**: Acknowledge contributors
3. FORMATTING:
- Use > [!WARNING] for breaking changes
- Use code blocks for installation commands
- Link to GitHub release, docs, and PRs
- Keep it scannable (bullets, headers)
4. TONE:
- Excited but professional
- Focus on user benefits
- Be specific about what changed
Generate the complete release announcement now.
Example Output Structure
---
layout: post
title: "git-adr v2.0.0: Semantic Search for Your Architecture Decisions"
date: 2025-01-15
categories: [releases, git-adr]
tags: [git-adr, release, adr, search, semantic]
excerpt: "git-adr v2.0.0 brings natural language search, making it easier than ever to find relevant architecture decisions."
comments: true
---
git-adr v2.0.0 is now available, bringing semantic search capabilities
to your architecture decision records.
## Highlights
### Natural Language Search
...
### Performance Improvements
...
## Breaking Changes
> [!WARNING]
> The `--format` flag has been renamed to `--output`.
**Migration:**
```bash
# Before
git adr list --format json
# After
git adr list --output json
Full Changelog
Features
- Natural language search across ADR content (#123)
- …
Bug Fixes
- …
Installation
# Homebrew
brew upgrade git-adr
# pip
pip install --upgrade git-adr
What’s Next
…
Contributors
Thanks to @contributor1, @contributor2 for their contributions!