From 34443b0c192f41241135008df3a7f6590bc32070 Mon Sep 17 00:00:00 2001 From: Aaron Wood Date: Sat, 11 Apr 2026 16:28:30 -0400 Subject: [PATCH] docs: update handbook/changelog spec with repo-local skills and changelog cadence note --- .../specs/2026-04-11-handbook-changelog-design.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) 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