Ship
Cut a release — bump version, update CHANGELOG, tag, push, create GitHub release, install local binaries.From its SKILL.md
npx -y skills add onur-gokyildiz-bhi/codescope --skill shipAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.6 KB, as published. Nobody here has run it
/ship
Full release workflow. Use when the user says "ship", "release X.Y.Z", "tag and push", or after a sprint concludes.
When to invoke
- All P0/high-priority planned work is
status:donein the knowledge graph cargo clippy --workspace -- -D warningscleancargo fmt --all -- --checkcleancargo test --workspacegreen (or explicitly waived)- Tool count ≤ 40
Protocol
-
Pre-flight (hand off to Ada for signoff):
- Run clippy, fmt check, test
grep -c '#\[tool(' crates/mcp-server/src/tools/*.rs | awk -F: '{s+=$2}END{print s}'- If any check fails, stop and report
-
Version bump:
# Edit workspace Cargo.toml version = "X.Y.Z" cargo check --workspace # updates Cargo.lock -
Commit:
git add Cargo.toml Cargo.lock git commit -m "release: vX.Y.Z — <one-line summary>" -
Tag and push:
git tag -a vX.Y.Z -m "vX.Y.Z: <summary>" git push origin main vX.Y.Z -
GitHub release:
gh release create vX.Y.Z \ --title "vX.Y.Z — <title>" \ --notes "<markdown notes with features, fixes, breaking changes, migration>" -
Local binary install:
taskkill /F /IM codescope.exe 2>&1 | head -2 # Windows # or: pkill -f codescope # Unix cargo build --release # Copy all 4 binaries to ~/.local/bin/ -
Knowledge entry:
knowledge(action="save", title="Release vX.Y.Z", kind="decision", tags=["status:done", "release", "shipped:YYYY-MM-DD", "vX.Y.Z"]) -
Update planned items to done: Update knowledge entries that were
status:plannedand shipped in this release — replace tag withstatus:done+shipped:YYYY-MM-DD+vX.Y.Z.
Semver
- patch (X.Y.Z+1): bug fix only, no new MCP tools, no tool description changes
- minor (X.Y+1.0): new features, tool additions, backwards-compatible
- major (X+1.0.0): breaking changes to MCP/LSP/CLI surface, tool removals or renames
Guardrails
- Never
--forceon tag push - Never skip CHANGELOG for minor/major releases
- Never release if
cargo test --workspacefails (waive explicitly in commit message if needed) - Never break
.mcp.jsoncompatibility without clear migration
Codescope-first rule
knowledge(action="search", query="status:planned priority:high")before starting — confirm scopeknowledge(action="search", query="shipped:YYYY-MM-DD")after — confirm you didn't miss anything