---

name: dev-release description: Release preparation — changelog generation, version bump, tag creation. Generic version (not project-specific). For EvoNexus releases, use custom-release instead.

Dev Release

Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.

Generic release preparation: changelog generation from git log, version bump, tag creation. For EvoNexus-specific releases, use custom-release (the existing skill that handles git-flow develop→main).

Use When

• Releasing a non-EvoNexus project (Evolution API, Evo AI, Evo Go, etc.)
• Generic semver bump on a library you're maintaining

Do Not Use When

• Releasing EvoNexus itself → use custom-release instead
• Project has its own custom release process → follow that

Workflow

Phase 1 — Pre-flight

• Verify on the right branch (not main/master directly)
• Verify clean working tree (no uncommitted changes)
• Verify CI is green on the target commit
• Verify tests pass locally (dev-verify)

Phase 2 — Determine version

• Read current version from manifest (package.json, Cargo.toml, go.mod, pyproject.toml)
• Determine bump type: major / minor / patch (semver)
• Confirm with user

Phase 3 — Generate changelog

• Read commits since last tag: git log {last-tag}..HEAD --oneline
• Group by type (feat / fix / docs / etc.) if conventional commits
• Save to CHANGELOG.md with new version section

Phase 4 — Bump version

• Update manifest file
• Update any version references in docs

Phase 5 — Commit and tag

• git commit -m "chore(release): vX.Y.Z"
• git tag vX.Y.Z
• git push origin vX.Y.Z (after user confirmation)

Phase 6 — Verify

• @oath-verifier confirms the release commit and tag are correct

Output

Save release notes to workspace/development/research/[C]release-{version}-{date}.md.

Pairs With

• @flow-git (commits and tags)
• @oath-verifier (verification)
• @quill-writer (changelog formatting)
• dev-verify (pre-flight)

EvoNexus-Specific Note

EvoNexus has its own release skill (custom-release) that handles the git-flow develop→main workflow with EvoNexus-specific gates (CHANGELOG entry, version sync across files, GitHub release creation). Use custom-release for EvoNexus releases. Use dev-release only for projects in workspace/projects/ that have their own release lifecycle.