git:20260719.d6bc5a1 to v0.1.0

---

name: release-workflow

description: Release cycle conventions including CHANGELOG format, README maintenance, version bumping, and git workflow.

---

# Release Workflow Standards

<!-- Load this for all projects — defines the mandatory release cycle -->

## Mandatory Release Cycle

Every time code is pushed:

1. **Update CHANGELOG.md** — add entries for all changes since last push

2. **Review README.md** — update test counts, version references, any stale data

3. **Commit docs** — `git add CHANGELOG.md README.md && git commit -m "docs: ..."`

4. **Push** — `git push`

5. **Create/update release** — tag + release notes on GitHub (or equivalent)

**Never push code without updating CHANGELOG + README first. Never skip the release.**

## CHANGELOG Format

Follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/):

```markdown

## [VERSION] — YYYY-MM-DD

### Added

- New features

### Fixed

- Bug fixes

### Changed

- Modifications to existing behavior

### Removed

- Deprecated features

```

Group entries by FID when applicable. Include file references in parentheses.

## README Maintenance

On every release, verify:

- [ ] Version number matches Cargo.toml / package.json

- [ ] Test count matches `cargo test` output

- [ ] FID count matches `dev/fids/` directory

- [ ] All referenced features still exist

- [ ] No stale links or descriptions

## AGENTS.md

Each project should have an `AGENTS.md` at the root with:

- Project-specific release workflow (may override this standard)

- Build & test commands

- Protocol version reference

- Any project-specific conventions

## Version Bumping

- **Patch** (0.1.0 → 0.1.1): Bug fixes, small improvements

- **Minor** (0.1.0 → 0.2.0): New features, non-breaking changes

- **Major** (0.1.0 → 1.0.0): Breaking changes, architecture shifts

Update `VERSION` file first, then propagate to all config files.