release-flow

name	release-flow
description	Execute this personal overlay repository release process with conventional commits.
whenToUse	Use when asked to commit or release changes in the personal overlay repo, including prompts like "create a release" or "ship it".
tags	["release","git","conventional-commits"]

Release Flow (Personal Overlay)

Use when asked to commit or release changes in the personal overlay repo. Explicit trigger phrases include "create a release" and "ship it".

Goal

Use a clean commit flow for personal overlay changes.

Rules

• Use Conventional Commits.
• Include scope when possible.
• Keep commits focused by module/area.

Workflow

1. Classify pending changes by area.
2. Run syntax checks for changed scripts.
3. Commit code changes with a clear Conventional Commit title.
4. If a CHANGELOG.md exists and changelog updates are requested, commit changelog updates separately.

Validation

zsh -n <changed-file>.zsh

rg --files -g '*.zsh' | while read -r f; do zsh -n "$f" || echo "SYNTAX_ERROR $f"; done

Examples

• feat(user): add new tmux helper aliases
• fix(user): guard gopen against empty branch name
• chore(user): clean stale helper function