diff --git a/.changeset/thirty-feet-ring.md b/.changeset/thirty-feet-ring.md
new file mode 100644
index 0000000..9283c48
--- /dev/null
+++ b/.changeset/thirty-feet-ring.md
@@ -0,0 +1,5 @@
+---
+"commitflow": patch
+---
+
+add initial changelog
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..bd12d81
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,19 @@
+# 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 [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
+
+---
+
+## [1.0.0] - 2025-11-03
+### Added
+- ✨ Initial release of CommitFlow — AI-powered GitHub Insight & Project Management Tool
+
+### Chore
+- chore: setup changesets for versioning and releases
+- chore: update changelog and package versions
+
+### Docs
+- docs: change README title to "🧠 CommitFlow - Smart Project Insights"