diff --git a/.github/linters/.codespellrc b/.github/linters/.codespellrc
index 9b4a74a..aa644eb 100644
--- a/.github/linters/.codespellrc
+++ b/.github/linters/.codespellrc
@@ -1,2 +1,2 @@
 [codespell]
-skip = ./.git,.claude/*,.codex/*,.config/gh/*,.github/agents/*,.github/copilot-instructions.md,.github/copilot/*,.github/instructions/*,.github/prompts/*,.github/skills/*,.vscode/*,*/composer.json,*/composer.lock,*/dist/*,*/node_modules/*,*/package-lock.json,*/tests/*,code_coverage/*,composer.lock,runtime/*,scaffold-lock.json,tests/**,vendor/*
+skip = ./.git,.claude/*,.codex/*,.config/gh/*,.github/agents/*,.github/copilot-instructions.md,.github/copilot/*,.github/instructions/*,.github/prompts/*,.github/skills/*,.vscode/*,*/composer.json,*/composer.lock,*/dist/*,*/node_modules/*,*/package-lock.json,*/tests/*,code_coverage/*,composer.lock,CHANGELOG.md,UPGRADE.md,runtime/*,scaffold-lock.json,tests/**,vendor/*
diff --git a/CHANGELOG.md b/CHANGELOG.md
index edcd2a1..33ead8d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## 0.1.5 Under development
 
+- ci: update codespell skip list to include `CHANGELOG.md` and `UPGRADE.md`.
+
 ## 0.1.4 July 05, 2026
 
 - ci: exclude VSCode and local GitHub CLI and Copilot config paths from scaffolded quality checks.
diff --git a/metadata/.github/linters/.codespellrc b/metadata/.github/linters/.codespellrc
index 9b4a74a..aa644eb 100644
--- a/metadata/.github/linters/.codespellrc
+++ b/metadata/.github/linters/.codespellrc
@@ -1,2 +1,2 @@
 [codespell]
-skip = ./.git,.claude/*,.codex/*,.config/gh/*,.github/agents/*,.github/copilot-instructions.md,.github/copilot/*,.github/instructions/*,.github/prompts/*,.github/skills/*,.vscode/*,*/composer.json,*/composer.lock,*/dist/*,*/node_modules/*,*/package-lock.json,*/tests/*,code_coverage/*,composer.lock,runtime/*,scaffold-lock.json,tests/**,vendor/*
+skip = ./.git,.claude/*,.codex/*,.config/gh/*,.github/agents/*,.github/copilot-instructions.md,.github/copilot/*,.github/instructions/*,.github/prompts/*,.github/skills/*,.vscode/*,*/composer.json,*/composer.lock,*/dist/*,*/node_modules/*,*/package-lock.json,*/tests/*,code_coverage/*,composer.lock,CHANGELOG.md,UPGRADE.md,runtime/*,scaffold-lock.json,tests/**,vendor/*