Combine /version and /release into a single /deploy skill

[sebastientaggart]

Currently the workflow requires two separate commands to go from a tagged version to a production release: /version (bump, tag, push) and then /release (create GitHub Release, promote branch). This adds friction and an extra step that can be forgotten.

The new /deploy skill combines both into a single command that:

1. Checks current state (latest tag, commits since tag, open PRs)
2. Optionally bumps the version (patch/minor/major) with user confirmation
3. Creates the GitHub Release and, in multi-branch workflows, promotes the pre-production branch to main

This reduces the workflow from six commands to five and makes the deploy step self-contained.

[sebastientaggart]

Agent Implementation Notes

New file: skills/deploy.md

Combined skill with three phases:

1. Check state — find latest version tag, list commits on integration branch since that tag, check for open unmerged PRs
2. Optional version bump — ask user if they want to bump (patch/minor/major/specific), run the appropriate BUMP_*_CMD, push commit + tag
3. Release — compute release contents from merge commits/PRs, human gate ("type release to confirm"), create GitHub Release, and in multi-branch mode create promotion PR and merge it

All three branching modes (trunk, two-branch, three-branch) handled via conditional blocks same as current skills.

New file: docs/skills/deploy.md

Documentation combining content from docs/skills/version.md and docs/skills/release.md.

Files to delete

• skills/version.md
• skills/release.md
• docs/skills/version.md
• docs/skills/release.md

Cross-reference updates

All files referencing /version and/or /release updated to reference /deploy:

• skills/setup.md — skill table
• skills/submit-for-review.md — issue closure reference
• README.md — workflow diagram, skill table
• docs/index.md — workflow diagram, skill links
• docs/branching.md — all mode descriptions
• docs/config-reference.md — Used in columns
• docs/customization.md — version placeholder docs
• templates/AGENTS.md.template — skill list
• AGENTS.md — skill list and rules
• config.schema.yaml — used_in arrays

Sync

Run ./sync.sh to regenerate adapter files. Old version/release adapter files will need manual deletion since sync.sh only creates, doesn't delete.

[sebastientaggart]

Resuming work. Starting implementation of the combined /deploy skill — creating the new skill file, docs, updating cross-references, and cleaning up old version/release files.