# Github Release Best Practices

> GitHub release preparation for Rust workspace projects. Use when preparing releases with proper versioning, changelog, and quality gates.

- **Type:** Skill
- **Install:** `agentstack add skill-d-o-hub-rust-self-learning-memory-github-release-best-practices`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [d-o-hub](https://agentstack.voostack.com/s/d-o-hub)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [d-o-hub](https://github.com/d-o-hub)
- **Source:** https://github.com/d-o-hub/rust-self-learning-memory/tree/main/.agents/skills/github-release-best-practices
- **Website:** https://d-o-hub.github.io/rust-self-learning-memory/

## Install

```sh
agentstack add skill-d-o-hub-rust-self-learning-memory-github-release-best-practices
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GitHub Release Best Practices

Release management for Rust workspaces with versioning, changelog, and quality gates.

## Key Steps

1. **Quality Gates**: `./scripts/quality-gates.sh`
2. **Version Bump**: Update `Cargo.toml` workspace version
3. **Changelog**: Update `CHANGELOG.md` (Keep a Changelog format)
4. **Tag + Push**: `git tag -a v0.X.Y -m "Release v0.X.Y" && git push origin v0.X.Y`
5. **GitHub Release**: `gh release create v0.X.Y --title "v0.X.Y" --notes-file CHANGELOG.md`

## Semver Matrix

| Change Type | Bump | Example |
|-------------|------|---------|
| Breaking | MAJOR | 0.1.7 → 1.0.0 |
| New Feature | MINOR | 0.1.7 → 0.2.0 |
| Bug Fix | PATCH | 0.1.7 → 0.1.8 |

For 0.x: MINOR for most changes, PATCH for critical bug fixes.

## Changelog Categories

1. Added - New features
2. Changed - Modified functionality
3. Deprecated - Planned removals
4. Removed - Deleted features
5. Fixed - Bug fixes
6. Security - Vulnerability patches

## Modern Tooling (ADR-034)

```bash
# API compatibility check
cargo semver-checks check-release --workspace

# Version bump automation
cargo release patch  # handles version + commit + tag

# Binary distribution
cargo dist init      # generates release.yml workflow
```

**CRITICAL**: Cargo.toml version must match git tag (without 'v'). Use `cargo release` to ensure atomicity.

## Release Notes Template

```markdown
## Summary
Brief description of changes.

## Fixed / Changed / Added
- Item 1
- Item 2

## Performance / Security (if applicable)
- Metrics, improvements

## Full Changelog
https://github.com/d-o-hub/rust-self-learning-memory/compare/v0.1.7...v0.1.8
```

## References

- ADR-034: Release Engineering Modernization
- ADR-031: Cargo Lock Integrity

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [d-o-hub](https://github.com/d-o-hub)
- **Source:** [d-o-hub/rust-self-learning-memory](https://github.com/d-o-hub/rust-self-learning-memory)
- **License:** MIT
- **Homepage:** https://d-o-hub.github.io/rust-self-learning-memory/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-d-o-hub-rust-self-learning-memory-github-release-best-practices
- Seller: https://agentstack.voostack.com/s/d-o-hub
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.