From 04b793d2248126d2ffd280bb812d884931435f39 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 6 Dec 2025 04:50:06 +0000
Subject: [PATCH 1/9] Initial plan


From b1d264c47a7617ffcf4723aa475fdcd92f530889 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 6 Dec 2025 04:54:36 +0000
Subject: [PATCH 2/9] feat: add git cliff filters to ignore CI changelog
 commits and improve workflow

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 .github/workflows/changelog.yml |   8 ++
 CHANGELOG.md                    | 204 --------------------------------
 cliff.toml                      |   8 +-
 3 files changed, 13 insertions(+), 207 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 1aab7e1..852968c 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -1,8 +1,16 @@
 name: Changelog
 
 on:
+  workflow_dispatch: # Manual trigger
   push:
     branches: [main]
+    paths:
+      - "src/**"
+      - "www/**"
+      - "setup/**"
+      - ".devcontainer/**"
+      - "package.json"
+      - "pnpm-lock.yaml"
 
 permissions:
   contents: write
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1554f94..1d013ff 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,207 +4,3 @@ 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]
-
-### Added
-
-- Add make/just language support
-- Add Roo Code, improve comments
-- Add i18n support with next-intl for English and Brazilian Portuguese (#35)
-- Configure Dependabot for npm updates
-- Add Docker extension (docker.docker) to devcontainer configuration
-- Create a custom agent as Designer and Brand Expert
-- Add @google/jules to the default AI installs in devcontainer setup
-- Reorganize VS Code extensions into groups
-- Add architecture decision records for DevMagic project
-- Implement automatic cloning of dotfiles repository in devcontainer setup
-- Create world-class visual identity for DevMagic website (#23)
-- Add visual identity documentation for DevMagic
-- Add blog post on refactoring DevMagic's dev container setup
-- Update the logo and the favicon
-- Add GitHub Actions workflow for automated changelog generation
-- Recreate changelog file with git-diff and full project history and versioning details
-- Add shortcut script for changelog generation
-- Add git-cliff for changelog generation
-- Add pre-commit hook with lint-staged for code formatting
-- Enhance AI CLI tools setup with pnpm configuration; convert aider install to log doc
-- Comment out docker-compose.yml download before testing it
-
-### Changed
-
-- Update next.js version
-- Rename dotfiles installation plan file and update references
-- Consolidate AI context files into a single source of truth
-- Change how the dotfiles repo is provided to the devcontainer and document the change
-- Restructure main execution flow and encapsulate dotfiles setup in a dedicated function
-- Move the visual identity file to the docs folder
-- Remove rewrites from vercel.json (they are in next.config.ts); add command so vercel ignores the skip ci tag
-- Archive the old changelog file, as now it will be automatically generated by git-cliff
-- Remove version in setup script and package.json
-
-### Documentation
-
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update VISUAL_IDENTITY.md to reflect current design implementation (#30)
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update documentation to clarify handling of environment variables and default values in DevMagic
-- Update changelog [skip ci]
-- Enhance Copilot instructions with current stack and best practices (#10)
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Refine insights on over-engineering in AI suggestions
-- Update changelog [skip ci]
-- Add blog post on the pitfalls of over-engineering with AI suggestions
-- Add blog post on using containerEnv vs remoteEnv for Dev Container setup
-- Save outline for potential blog posts and notes on AI context files
-- Archive the comprehensive refactor plan for DevContainer from script to features
-- Update docs
-- Update installation flow with Mermaid diagram and synchronization notes
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update Copilot instructions with commit message guidelines and changelog automation details
-
-### Fixed
-
-- Load showcase projects from www/data/showcase.yml (#33)
-- Button content stacking vertically instead of inline (#26)
-- Revert logo to previous simpler version without animation (#24)
-- Update dotfiles configuration to handle default values in bash due to spec limitation
-- Update docs to mention the correct devcontainer property to consider
-- Update dotfiles integration with conditional automatic cloning and installation during container setup
-- Update changelog script to output to CHANGELOG.md instead of prepending
-- Comment out GitHub Releases link in ChangelogPage as we don't use releases for now
-## [0.2.1] - 2025-11-25
-
-### Added
-
-- Update devcontainer setup script to install correct AI CLI tools
-
-### Fixed
-
-- Devcontainer build and AI tool packages
-- Comment out Node.js feature in devcontainer configuration, as image already has node
-## [0.2.0] - 2025-11-25
-
-### Added
-
-- Enhance documentation with architecture details and dotfiles integration
-- Add dotfiles installation script execution to container setup
-- Update changelog and getting started pages for improved project setup instructions
-- Update devcontainer setup script and routes for AI CLI tools installation
-- Do most of the migration work (see TODO.md)
-- The config script is too long. reviewed and decided to refactor to use devcontainer features instead
-
-### Changed
-
-- Prepare v0.2.0 release
-- Make consumer mode the default
-- Reorder features and add more docs
-- Add pnpm workspace configuration and turbo.json for task management
-- Remove devcontainer.json, as it was moved to the .devcontainer folder
-
-### Documentation
-
-- Improve documentation
-## [0.1.0] - 2025-11-20
-
-### Added
-
-- Add devcontainer setup configuration and update setup scripts
-- Add Git CLI support to devcontainer configuration
-- Add .editorconfig, .gitignore, package.json, and pnpm-lock.yaml for project configuration (prettier only respects md formatting with 4 spaces in version 3+)
-- Add OpenAI ChatGPT extensions to devcontainer configuration
-- Add .env.example for setup configuration and update README for customization instructions
-- Mention quick and interactive modes in the devcontainer.json
-- Add showcase entries for multiple projects
-- Delete www/public/CNAME
-- Add CNAME file for custom domain
-- Build site in docs folder
-- Add logo to header, purple theme, and working dark mode toggle
-- Add complete DevMagic documentation website and project files
-- Add devmagic setup script for submodule-based development environment
-- Update shell history configuration for WSL and Windows in devcontainer.json
-- Add environment variables for shell history and workspace folder in devcontainer.json
-- Remove container name; remove unused ports; clean up comments
-- Add more extensions that I use and refactor them in devcontainer.json
-- Add git lfs as devcontainer feature
-- Restructure devcontainer setup with new Dockerfiles and configuration
-- Use a smaller image by default
-- Add Table of Contents to README
-- Revise README for improved clarity on usage
-- Add standalone usage to usage instructions
-- Enhance README with usage instructions (consumer/self-usage)
-- Add devcontainer configuration for DevMagic
-- Add claude code and gemini cli companion extensions
-- Disable mise by default. not necessary now
-- Improve README with DevMagic usage instructions
-- Add tailwind extension
-- Update files to latest version
-- Update devcontainer
-- Add reference devcotnainer, docker-compose and dockerfile
-
-### Changed
-
-- Update file download structure in setup script, along with names
-- Improve git check in devmagic.sh setup script
-- Replace submodule approach with direct file downloads
-- Migrate website from Astro to Next.js 16
-- Update LICENSE.md to include full Apache License text and formatting improvements
-- Update author name in about page
-- Update lockfile
-- Migrate from GitHub Pages to Vercel with dynamic routes
-- Deploy website for c9eb606
-- Deploy website for b8b5fc6
-- Deploy website for f15a133
-- Deploy website for c7751e5
-- Update site
-- Use pnpm instead of npm
-- Add .gitattributes to prevent merge conflicts in auto-generated docs folder
-- Update pnpm version to 10.9.0
-- Update to Node.js 22 and pnpm 10, modernize copyright
-- Upgrade to Tailwind CSS v4 and pnpm
-- Update README for clarity and consistency in usage instructions
-
-### Documentation
-
-- Add documentation for handling auto-generated docs folder
-- Improve comments for user settings and environment variables in devcontainer.json
-
-### Fixed
-
-- Update copyright attribution in LICENSE.md
-- Update author name in About page
-- Get tailwind to work correctly
-- Update customization link in devcontainer setup script
-- Update to version 0.1.0 and add /install@version support
-- Update setup script URLs to use devmagic.run for consistency
-- Resolve /setup route and theme toggle issues
-- Configure Tailwind v4 @theme to generate custom color utilities
-- Resolve build errors and complete Tailwind v4 migration
-- Correct PostgreSQL environment variable name in docker-compose.yml
-- Update comments and correct image version in devcontainer configuration
-- Remove devcontainer with invalid setting and update documentation
-- Update README links to use correct anchors
-[unreleased]: https://github.com/marcelocra/devmagic/compare/v0.2.1...HEAD
-[0.2.1]: https://github.com/marcelocra/devmagic/compare/v0.2.0...v0.2.1
-[0.2.0]: https://github.com/marcelocra/devmagic/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/marcelocra/devmagic/releases/tag/v0.1.0
-
diff --git a/cliff.toml b/cliff.toml
index ba634a8..483ee35 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -65,6 +65,11 @@ split_commits = false
 
 # Commit parsers for grouping
 commit_parsers = [
+  { message = "^docs.*\\[skip ci\\]", skip = true },
+  { message = "^docs.*update changelog", skip = true },
+  { message = "^chore\\(release\\)", skip = true },
+  { message = "^chore\\(deps\\)", skip = true },
+  { message = "^ci", skip = true },
   { message = "^feat", group = "Added" },
   { message = "^fix", group = "Fixed" },
   { message = "^doc", group = "Documentation" },
@@ -73,10 +78,7 @@ commit_parsers = [
   { message = "^refactor", group = "Changed" },
   { message = "^style", group = "Changed" },
   { message = "^test", group = "Changed" },
-  { message = "^chore\\(release\\)", skip = true },
-  { message = "^chore\\(deps\\)", skip = true },
   { message = "^chore", group = "Changed" },
-  { message = "^ci", skip = true },
   { message = "^build", group = "Changed" },
   { body = ".*security", group = "Security" },
   { message = "^revert", group = "Removed" },

From 28becf3a43abe4f4d761c70744a6ef00319fa34f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 6 Dec 2025 05:05:21 +0000
Subject: [PATCH 3/9] fix: make changelog CI commit filters case-insensitive

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 cliff.toml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/cliff.toml b/cliff.toml
index 483ee35..744079f 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -65,8 +65,8 @@ split_commits = false
 
 # Commit parsers for grouping
 commit_parsers = [
-  { message = "^docs.*\\[skip ci\\]", skip = true },
-  { message = "^docs.*update changelog", skip = true },
+  { message = "(?i)^docs.*\\[skip ci\\]", skip = true },
+  { message = "(?i)^docs.*update changelog", skip = true },
   { message = "^chore\\(release\\)", skip = true },
   { message = "^chore\\(deps\\)", skip = true },
   { message = "^ci", skip = true },

From e6206404b530084aee21f38fa44affa84c56f6aa Mon Sep 17 00:00:00 2001
From: Marcelo Almeida <2532492+marcelocra@users.noreply.github.com>
Date: Sun, 7 Dec 2025 12:49:53 -0300
Subject: [PATCH 4/9] feat: fix incorrect path in
 .github/workflows/changelog.yml

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 852968c..16d7625 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -5,7 +5,7 @@ on:
   push:
     branches: [main]
     paths:
-      - "src/**"
+      - "www/**"
       - "www/**"
       - "setup/**"
       - ".devcontainer/**"

From 39ad036328b3b3e839b9aacc91c36d966d0759a9 Mon Sep 17 00:00:00 2001
From: Marcelo Almeida <2532492+marcelocra@users.noreply.github.com>
Date: Wed, 10 Dec 2025 01:36:08 -0300
Subject: [PATCH 5/9] Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 16d7625..6e89085 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -6,7 +6,7 @@ on:
     branches: [main]
     paths:
       - "www/**"
-      - "www/**"
+
       - "setup/**"
       - ".devcontainer/**"
       - "package.json"

From 74f215d3ae104231cb464703a1a609b59fc5aa54 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 10 Dec 2025 04:42:33 +0000
Subject: [PATCH 6/9] fix: restore CHANGELOG.md and fix configuration to
 preserve manually curated history

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 .github/workflows/changelog.yml |  13 +-
 CHANGELOG.md                    | 204 ++++++++++++++++++++++++++++++++
 cliff.toml                      |   3 +
 package.json                    |   4 +-
 4 files changed, 211 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 6e89085..633206c 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -1,16 +1,7 @@
 name: Changelog
 
 on:
-  workflow_dispatch: # Manual trigger
-  push:
-    branches: [main]
-    paths:
-      - "www/**"
-
-      - "setup/**"
-      - ".devcontainer/**"
-      - "package.json"
-      - "pnpm-lock.yaml"
+  workflow_dispatch: # Manual trigger only
 
 permissions:
   contents: write
@@ -27,7 +18,7 @@ jobs:
         uses: orhun/git-cliff-action@v4
         with:
           config: cliff.toml
-          args: -o CHANGELOG.md
+          args: --unreleased --prepend CHANGELOG.md
 
       - name: Commit changelog
         uses: stefanzweifel/git-auto-commit-action@v7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1d013ff..1554f94 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,3 +4,207 @@ 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]
+
+### Added
+
+- Add make/just language support
+- Add Roo Code, improve comments
+- Add i18n support with next-intl for English and Brazilian Portuguese (#35)
+- Configure Dependabot for npm updates
+- Add Docker extension (docker.docker) to devcontainer configuration
+- Create a custom agent as Designer and Brand Expert
+- Add @google/jules to the default AI installs in devcontainer setup
+- Reorganize VS Code extensions into groups
+- Add architecture decision records for DevMagic project
+- Implement automatic cloning of dotfiles repository in devcontainer setup
+- Create world-class visual identity for DevMagic website (#23)
+- Add visual identity documentation for DevMagic
+- Add blog post on refactoring DevMagic's dev container setup
+- Update the logo and the favicon
+- Add GitHub Actions workflow for automated changelog generation
+- Recreate changelog file with git-diff and full project history and versioning details
+- Add shortcut script for changelog generation
+- Add git-cliff for changelog generation
+- Add pre-commit hook with lint-staged for code formatting
+- Enhance AI CLI tools setup with pnpm configuration; convert aider install to log doc
+- Comment out docker-compose.yml download before testing it
+
+### Changed
+
+- Update next.js version
+- Rename dotfiles installation plan file and update references
+- Consolidate AI context files into a single source of truth
+- Change how the dotfiles repo is provided to the devcontainer and document the change
+- Restructure main execution flow and encapsulate dotfiles setup in a dedicated function
+- Move the visual identity file to the docs folder
+- Remove rewrites from vercel.json (they are in next.config.ts); add command so vercel ignores the skip ci tag
+- Archive the old changelog file, as now it will be automatically generated by git-cliff
+- Remove version in setup script and package.json
+
+### Documentation
+
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update VISUAL_IDENTITY.md to reflect current design implementation (#30)
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update documentation to clarify handling of environment variables and default values in DevMagic
+- Update changelog [skip ci]
+- Enhance Copilot instructions with current stack and best practices (#10)
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Refine insights on over-engineering in AI suggestions
+- Update changelog [skip ci]
+- Add blog post on the pitfalls of over-engineering with AI suggestions
+- Add blog post on using containerEnv vs remoteEnv for Dev Container setup
+- Save outline for potential blog posts and notes on AI context files
+- Archive the comprehensive refactor plan for DevContainer from script to features
+- Update docs
+- Update installation flow with Mermaid diagram and synchronization notes
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update changelog [skip ci]
+- Update Copilot instructions with commit message guidelines and changelog automation details
+
+### Fixed
+
+- Load showcase projects from www/data/showcase.yml (#33)
+- Button content stacking vertically instead of inline (#26)
+- Revert logo to previous simpler version without animation (#24)
+- Update dotfiles configuration to handle default values in bash due to spec limitation
+- Update docs to mention the correct devcontainer property to consider
+- Update dotfiles integration with conditional automatic cloning and installation during container setup
+- Update changelog script to output to CHANGELOG.md instead of prepending
+- Comment out GitHub Releases link in ChangelogPage as we don't use releases for now
+## [0.2.1] - 2025-11-25
+
+### Added
+
+- Update devcontainer setup script to install correct AI CLI tools
+
+### Fixed
+
+- Devcontainer build and AI tool packages
+- Comment out Node.js feature in devcontainer configuration, as image already has node
+## [0.2.0] - 2025-11-25
+
+### Added
+
+- Enhance documentation with architecture details and dotfiles integration
+- Add dotfiles installation script execution to container setup
+- Update changelog and getting started pages for improved project setup instructions
+- Update devcontainer setup script and routes for AI CLI tools installation
+- Do most of the migration work (see TODO.md)
+- The config script is too long. reviewed and decided to refactor to use devcontainer features instead
+
+### Changed
+
+- Prepare v0.2.0 release
+- Make consumer mode the default
+- Reorder features and add more docs
+- Add pnpm workspace configuration and turbo.json for task management
+- Remove devcontainer.json, as it was moved to the .devcontainer folder
+
+### Documentation
+
+- Improve documentation
+## [0.1.0] - 2025-11-20
+
+### Added
+
+- Add devcontainer setup configuration and update setup scripts
+- Add Git CLI support to devcontainer configuration
+- Add .editorconfig, .gitignore, package.json, and pnpm-lock.yaml for project configuration (prettier only respects md formatting with 4 spaces in version 3+)
+- Add OpenAI ChatGPT extensions to devcontainer configuration
+- Add .env.example for setup configuration and update README for customization instructions
+- Mention quick and interactive modes in the devcontainer.json
+- Add showcase entries for multiple projects
+- Delete www/public/CNAME
+- Add CNAME file for custom domain
+- Build site in docs folder
+- Add logo to header, purple theme, and working dark mode toggle
+- Add complete DevMagic documentation website and project files
+- Add devmagic setup script for submodule-based development environment
+- Update shell history configuration for WSL and Windows in devcontainer.json
+- Add environment variables for shell history and workspace folder in devcontainer.json
+- Remove container name; remove unused ports; clean up comments
+- Add more extensions that I use and refactor them in devcontainer.json
+- Add git lfs as devcontainer feature
+- Restructure devcontainer setup with new Dockerfiles and configuration
+- Use a smaller image by default
+- Add Table of Contents to README
+- Revise README for improved clarity on usage
+- Add standalone usage to usage instructions
+- Enhance README with usage instructions (consumer/self-usage)
+- Add devcontainer configuration for DevMagic
+- Add claude code and gemini cli companion extensions
+- Disable mise by default. not necessary now
+- Improve README with DevMagic usage instructions
+- Add tailwind extension
+- Update files to latest version
+- Update devcontainer
+- Add reference devcotnainer, docker-compose and dockerfile
+
+### Changed
+
+- Update file download structure in setup script, along with names
+- Improve git check in devmagic.sh setup script
+- Replace submodule approach with direct file downloads
+- Migrate website from Astro to Next.js 16
+- Update LICENSE.md to include full Apache License text and formatting improvements
+- Update author name in about page
+- Update lockfile
+- Migrate from GitHub Pages to Vercel with dynamic routes
+- Deploy website for c9eb606
+- Deploy website for b8b5fc6
+- Deploy website for f15a133
+- Deploy website for c7751e5
+- Update site
+- Use pnpm instead of npm
+- Add .gitattributes to prevent merge conflicts in auto-generated docs folder
+- Update pnpm version to 10.9.0
+- Update to Node.js 22 and pnpm 10, modernize copyright
+- Upgrade to Tailwind CSS v4 and pnpm
+- Update README for clarity and consistency in usage instructions
+
+### Documentation
+
+- Add documentation for handling auto-generated docs folder
+- Improve comments for user settings and environment variables in devcontainer.json
+
+### Fixed
+
+- Update copyright attribution in LICENSE.md
+- Update author name in About page
+- Get tailwind to work correctly
+- Update customization link in devcontainer setup script
+- Update to version 0.1.0 and add /install@version support
+- Update setup script URLs to use devmagic.run for consistency
+- Resolve /setup route and theme toggle issues
+- Configure Tailwind v4 @theme to generate custom color utilities
+- Resolve build errors and complete Tailwind v4 migration
+- Correct PostgreSQL environment variable name in docker-compose.yml
+- Update comments and correct image version in devcontainer configuration
+- Remove devcontainer with invalid setting and update documentation
+- Update README links to use correct anchors
+[unreleased]: https://github.com/marcelocra/devmagic/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/marcelocra/devmagic/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/marcelocra/devmagic/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/marcelocra/devmagic/releases/tag/v0.1.0
+
diff --git a/cliff.toml b/cliff.toml
index 744079f..16388ad 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -63,6 +63,9 @@ conventional_commits = true
 filter_unconventional = true
 split_commits = false
 
+# Skip tags to preserve manually curated history
+skip_tags = "v0\\.1\\.0|v0\\.2\\.0|v0\\.2\\.1"
+
 # Commit parsers for grouping
 commit_parsers = [
   { message = "(?i)^docs.*\\[skip ci\\]", skip = true },
diff --git a/package.json b/package.json
index b69a569..8042111 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
   "scripts": {
-    "changelog": "git-cliff -o CHANGELOG.md",
+    "changelog": "git-cliff --unreleased",
     "cl": "pnpm run changelog",
-    "changelog:unreleased": "git-cliff --unreleased",
+    "changelog:update": "git-cliff --unreleased --prepend CHANGELOG.md",
     "prepare": "husky"
   },
   "devDependencies": {

From 7d5d86af1a8f8b9267cca3df948f66336bfee319 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 10 Dec 2025 04:44:11 +0000
Subject: [PATCH 7/9] refactor: combine duplicate CI commit filter patterns
 into single regex

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 cliff.toml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/cliff.toml b/cliff.toml
index 16388ad..4b629c8 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -68,8 +68,7 @@ skip_tags = "v0\\.1\\.0|v0\\.2\\.0|v0\\.2\\.1"
 
 # Commit parsers for grouping
 commit_parsers = [
-  { message = "(?i)^docs.*\\[skip ci\\]", skip = true },
-  { message = "(?i)^docs.*update changelog", skip = true },
+  { message = "(?i)^docs.*(?:update changelog|\\[skip ci\\])", skip = true },
   { message = "^chore\\(release\\)", skip = true },
   { message = "^chore\\(deps\\)", skip = true },
   { message = "^ci", skip = true },

From e9f0ffc4042745e2b70785853acc774cb75b2724 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 10 Dec 2025 04:45:36 +0000
Subject: [PATCH 8/9] chore: remove redundant CI commit entries from manually
 curated changelog

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 CHANGELOG.md | 25 -------------------------
 1 file changed, 25 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1554f94..e7ad2f7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -45,41 +45,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Documentation
 
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
 - Update VISUAL_IDENTITY.md to reflect current design implementation (#30)
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
 - Update documentation to clarify handling of environment variables and default values in DevMagic
-- Update changelog [skip ci]
 - Enhance Copilot instructions with current stack and best practices (#10)
-- Update changelog [skip ci]
-- Update changelog [skip ci]
 - Refine insights on over-engineering in AI suggestions
-- Update changelog [skip ci]
 - Add blog post on the pitfalls of over-engineering with AI suggestions
 - Add blog post on using containerEnv vs remoteEnv for Dev Container setup
 - Save outline for potential blog posts and notes on AI context files
 - Archive the comprehensive refactor plan for DevContainer from script to features
 - Update docs
 - Update installation flow with Mermaid diagram and synchronization notes
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
-- Update changelog [skip ci]
 - Update Copilot instructions with commit message guidelines and changelog automation details
 
 ### Fixed

From b2f320784f93f7b61b8305c5d51c6f53c5aa3685 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 21 Dec 2025 17:15:34 +0000
Subject: [PATCH 9/9] fix: restore automatic changelog generation and add
 explanatory comments

Co-authored-by: marcelocra <2532492+marcelocra@users.noreply.github.com>
---
 .github/workflows/changelog.yml | 5 +++--
 cliff.toml                      | 4 ++++
 package.json                    | 4 ++--
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
index 633206c..1aab7e1 100644
--- a/.github/workflows/changelog.yml
+++ b/.github/workflows/changelog.yml
@@ -1,7 +1,8 @@
 name: Changelog
 
 on:
-  workflow_dispatch: # Manual trigger only
+  push:
+    branches: [main]
 
 permissions:
   contents: write
@@ -18,7 +19,7 @@ jobs:
         uses: orhun/git-cliff-action@v4
         with:
           config: cliff.toml
-          args: --unreleased --prepend CHANGELOG.md
+          args: -o CHANGELOG.md
 
       - name: Commit changelog
         uses: stefanzweifel/git-auto-commit-action@v7
diff --git a/cliff.toml b/cliff.toml
index 4b629c8..33b4450 100644
--- a/cliff.toml
+++ b/cliff.toml
@@ -68,9 +68,13 @@ skip_tags = "v0\\.1\\.0|v0\\.2\\.0|v0\\.2\\.1"
 
 # Commit parsers for grouping
 commit_parsers = [
+  # Skip automated changelog update commits to prevent recursive entries
   { message = "(?i)^docs.*(?:update changelog|\\[skip ci\\])", skip = true },
+  # Skip release preparation commits
   { message = "^chore\\(release\\)", skip = true },
+  # Skip dependency update commits from Dependabot
   { message = "^chore\\(deps\\)", skip = true },
+  # Skip all CI-related commits
   { message = "^ci", skip = true },
   { message = "^feat", group = "Added" },
   { message = "^fix", group = "Fixed" },
diff --git a/package.json b/package.json
index 8042111..b69a569 100644
--- a/package.json
+++ b/package.json
@@ -1,8 +1,8 @@
 {
   "scripts": {
-    "changelog": "git-cliff --unreleased",
+    "changelog": "git-cliff -o CHANGELOG.md",
     "cl": "pnpm run changelog",
-    "changelog:update": "git-cliff --unreleased --prepend CHANGELOG.md",
+    "changelog:unreleased": "git-cliff --unreleased",
     "prepare": "husky"
   },
   "devDependencies": {