changelog-release が docs- fragment を silent skip → 孤児化する (0.7.0 dogfood で surface)

[nao-amj]

観察 (0.7.0 リリースの dogfood で surface)

scripts/changelog-release.mjs の有効 category は .changelog/README.md 記載の
7つ: fixed / changed / added / removed / deprecated / security / breaking。

0.7.0 を切ったとき、docs- prefix の fragment 4件が category 不正として warn を
出して skip され、.changelog/next/ に孤児として取り残された:

• docs-agent-claude-md-refit.md (docs: refit CLAUDE.md (philosophy-first) + complete AGENT.md verb signatures #430)
• docs-devil-extension-lense-judgment.md (docs(devil): document extension lenses for judgment-axis review (#134 G) #438)
• docs-maintenance-executor-drift.md
• docs-swarm-per-slice-closure-resolved.md

これらは将来の release でも永遠に拾われない。warn は流れるログに埋もれ、
release は exit 0 で「成功」するため、silence reads as success になっている
(まさに guild-cli が各所で潰してきた touch-feel の失敗形)。

解決案

A — docs は changelog 対象外と明文化 (recommended)

• Keep a Changelog は docs-only 変更を notable change に含めない流儀。docs/ の
  変更は PR / git history が正本で、user-facing changelog に出す必要は薄い。
• .changelog/README.md の category 節に「docs-only は fragment 不要」を明記。
• 孤児4件は削除 (work は docs: refit CLAUDE.md (philosophy-first) + complete AGENT.md verb signatures #430/docs(devil): document extension lenses for judgment-axis review (#134 G) #438 等で既に landed)。

B — docs category を追加

• changelog-release.mjs + README に docs を足し、### Documentation に描画。
• docs も追える反面、Keep a Changelog の慣習からは外れ、changelog が肥大化。

どちらを採っても要る改善 (silent-skip 自体がバグ)

カテゴリ不正の fragment を見逃すと release が静かに取りこぼす。最低限:

• release script は skip した fragment を最後にまとめて列挙し、未知 category が
  あれば exit 非0 にする (CI / 手動どちらでも気づける)。
• もしくは gate doctor に「.changelog/next/ に未知 category の fragment」検査を足す。

dogfood trail

• gate issue (local): i-2026-06-22-0001
• release commit: claude/guild-cli-latest-check-7vqsrg 上の 0.7.0 確定コミット。
  孤児4件は convention 未決のためあえて据え置き (この issue 決着後に処理)。