diff --git a/CHANGELOG.md b/CHANGELOG.md
index fcdae69d..5ebe09b9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0](https://github.com/symposium-dev/symposium/compare/symposium-v0.4.0...symposium-v0.5.0) - 2026-06-06
+
+### Added
+
+- *(hook)* suggest `cargo agents --help` at session start
+- *(help)* audience-grouped --help listing plugin-vended subcommands.
+- *(plugins)* add subcommand manifest schema
+- move skill layout to [package.metadata.symposium] in crate Cargo.toml
+
+### Fixed
+
+- add `self-update` to reserved subcommand names and fix typo
+- make crate_metadata module pub(crate)
+- address review nits on source.crate
+
+### Other
+
+- Add a sentence about global use case
+- Add global install option for cargo and add env vars
+- pacify the merciless fmt
+- add Plugin::get_installation, capture subcommand output, snapshot tests
+- pacify the merciless cargo fmt
+- *(help)* hoist section headings into shared constants
+- Agent help guidance:
+- add the built-in dispatch step to hook-flow.md, an "Agent
+- document the --help renderer and reclassify crate-info
+- dispatch external `cargo agents <name>` via clap catch-all
+- *(plugins)* pass empty source_name to scan_source_dir
+- *(installation)* lift hook resolver into shared module
+- Merge pull request #236 from nikomatsakis/skills-from-specific-crate
+- make init and sync modules pub(crate)
+- redesign source.crate as a nested table
+- apply fmt
+- improve docs
+- Add `source.crate` field to decouple skill fetch target from activation predicates
+- pacify the merciless fmt
+- fix macOS CI test failure (symlink canonicalization)
+- Also watch battery-pack.toml for sync staleness
+- pacify the merciless fmt
+- Skip auto-sync when Cargo.lock is unchanged
+- pacify the merciless fmt
+- Add user-facing hook documentation and SDK guide
+- Add design tenets and hook architecture docs
+- Implement per-plugin hook format selection
+- Introduce symposium-hook SDK crate
+- Change default crate skills path from `.symposium/skills` to `skills`
+
 ## [0.4.0](https://github.com/symposium-dev/symposium/compare/symposium-v0.3.0...symposium-v0.4.0) - 2026-05-14
 
 ### Added
diff --git a/Cargo.lock b/Cargo.lock
index 93ad2d1f..c40e0bec 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -2424,7 +2424,7 @@ checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
 
 [[package]]
 name = "symposium"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "anyhow",
  "assert_matches",
diff --git a/Cargo.toml b/Cargo.toml
index 16679fba..01b929ea 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "symposium"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2024"
 license = "MIT OR Apache-2.0"
 description = "AI the Rust Way"
diff --git a/symposium-hook/CHANGELOG.md b/symposium-hook/CHANGELOG.md
new file mode 100644
index 00000000..0b11a324
--- /dev/null
+++ b/symposium-hook/CHANGELOG.md
@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0](https://github.com/symposium-dev/symposium/releases/tag/symposium-hook-v0.1.0) - 2026-06-06
+
+### Other
+
+- extract symposium-install crate and make symposium-hook async
+- pacify the merciless fmt
+- Add user-facing hook documentation and SDK guide
+- Introduce symposium-hook SDK crate
diff --git a/symposium-install/CHANGELOG.md b/symposium-install/CHANGELOG.md
new file mode 100644
index 00000000..a870f12f
--- /dev/null
+++ b/symposium-install/CHANGELOG.md
@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0](https://github.com/symposium-dev/symposium/releases/tag/symposium-install-v0.1.0) - 2026-06-06
+
+### Other
+
+- Add global install option for cargo and add env vars
+- introduce GitSource enum and reduce git API surface
+- extract symposium-install crate and make symposium-hook async