Specialized commands that pre-fill frontmatter and enforce consistent structure for the three most common KB document types, reducing manual setup vs the generic /save-doc:save command. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.0 KiB
2.0 KiB
| description | allowed-tools |
|---|---|
| Save release notes for a deployment to the knowledge base | Read,Write,Edit,Glob,Grep,Bash |
Save release notes documenting a deployment. Gathers context from git history and produces a structured KB document.
Defaults
- type:
reference - tags: always include
release-notesanddeployment - filename:
release-YYYY.M.DD.md(ordatabase-release-YYYY.M.DD.mdfor DB-only releases) - save path:
/mnt/NV2/Development/claude-home/{domain}/
Gathering Context
Before writing, collect what you can automatically:
- Git log — recent commits on
mainsince last tag or last release notes - Tags — latest CalVer tag for the version number
- PRs — merged PR numbers and titles if available
- Ask the user for anything you can't determine: target server, deploy method, image tag, domain
Document Structure
---
title: "{Project} Release — YYYY.M.DD"
description: "One-line summary of what this release covers."
type: reference
domain: {domain}
tags: [release-notes, deployment, ...]
---
# {Project} Release — YYYY.M.DD
**Date:** YYYY-MM-DD
**Tag:** `{calver or semver tag}`
**Image:** `{docker image}` (if applicable)
**Server:** {target host} (`{deploy path}`)
**Deploy method:** {how it was deployed}
## Release Summary
One paragraph overview of the release.
## Changes
### New Features
- ...
### Bug Fixes
- ...
### Dependencies
- ...
## Infrastructure Changes
(Only if applicable — CI, Docker, config changes)
## Hotfix During Release
(Only if a hotfix was needed — include root cause and lesson)
## Deployment Notes
- Migration commands, config changes, rollback instructions
- Rollback: {how to roll back}
Rules
- Omit empty sections — only include sections that have content
- Use PR numbers as references (e.g., "PR #88") when available
- Include rollback instructions when the deployment method supports it
- For database-only releases, prefix filename with
database- - If the user provides partial info, fill in what you can and ask about the rest