diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3c2f7e2..e57a477 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,13 @@
+## [v0.3.1] - 2026-03-28
+
+### Added
+- Add directory creation for .grokkit to ensure it exists before writing.
+
+### Changed
+- Change default output path to .grokkit/analysis.md for project-local storage.
+- Move project analysis from analyze.md to .grokkit/analysis.md.
+- Refine project analysis with more accurate tech stack, directory structure, function references, and learning path details.
+- Update CHANGELOG.md with entry for v0.3.0 release.
 ## [v0.3.0] - 2026-03-28
 
 Grokkit levels up with deep project analysis—because who doesn't love a good codebase dissection?