diff --git a/docs/superpowers/specs/2026-04-11-handbook-changelog-design.md b/docs/superpowers/specs/2026-04-11-handbook-changelog-design.md
index bf065db..ee3d390 100644
--- a/docs/superpowers/specs/2026-04-11-handbook-changelog-design.md
+++ b/docs/superpowers/specs/2026-04-11-handbook-changelog-design.md
@@ -163,7 +163,14 @@ Both skills are project-local markdown files stored in `.claude/skills/` at the
 
 ## Out of Scope
 
-- Screenshots in the handbook (added manually, not by the skill)
+- Screenshots — the handbook is text-only; screenshots belong in the marketing site (separate project)
 - A separate marketing site (separate project, separate spec)
 - GitHub wiki or any external hosting for these docs
-- Automated changelog generation from git commits (we write entries intentionally, not mechanically)
+- Automated changelog generation from git commits (entries are written intentionally, not mechanically)
+
+---
+
+## Notes
+
+- Both skills live in `.claude/skills/` inside the repo so all collaborators using Claude get them automatically
+- The `update-changelog` skill should check recent git commits and the roadmap for context on what changed since the last entry, making it easy to catch anything that slipped through without a manual trigger