Phase 4 完了報告¶
| 項目 | 値 |
|---|---|
| 起案 | Code Claude（Mac ローカル） |
| 実行日時 | 2026-05-17 06:10 JST |
| 所要時間 | 約 35 分 |
| Part 1-1 バージョン番号整合 | ✅ 4 スキル全件修正（タイトル + description 追記） |
| Part 1-2 reference rot 修正 | ✅ kudo-persist-settings の CLAUDE.md §4 参照 6 箇所を修正 |
| Part 1-3 横断 grep + 追加修正 | ✅ 9 スキル 11 箇所を修正（HANDOFF Part 2 対象外） |
| Part 2 .skill 化 | ✅ 8 件全件成功（valid ZIP・kudo-persist-settings は scripts/ 同梱） |
| Part 2-3 Drive 配置 | ✅ outputs/phase3-skills/ に 8 件 |
| description 1024 字チェック | ✅ 全 17 件合格（validate_skill.py v1.1 / 7 検査項目） |
Part 1-1：バージョン番号整合（4 スキル全件修正）¶
phase3-patches/ 内の SKILL.md でバージョン更新が本文タイトル + description 末尾に未反映だったことが Chat の contentSnippet レビューで判明。本 Phase 4 で修正：
| スキル | タイトル更新 | description 末尾追記 | description 字数 | 圧縮対象 |
|---|---|---|---|---|
| kudo-naming-unification-protocol | v2.0 → v2.4 |
v2.4 集中原則言及追記 | 1003 字 | v2.1-2.3 説明を圧縮（-77 字 → +57 字 net -20 字） |
| kudo-cowork-code-handoff-protocol | （タイトル無し・元構造維持） | v1.13 集中原則言及追記 | 949 字 | 「2026-05-05 実証経験」5 項目列挙を 1 文に圧縮（net -77 字） |
| kudo-workflowy-double-save | v3.1 → v3.2 |
v3.2 集中原則言及追記 | 672 字 | 圧縮不要（余裕 +352 字） |
| kudo-persist-settings | v3.7 → v3.8 |
v3.8 集中原則言及追記 | 1024 字 | 圧縮不要（ぴったり制限上限・今後追記時は要圧縮） |
注意：kudo-persist-settings の description は 1024/1024 でマージン無し。次回改訂時は何かを圧縮しないと追記不可。
Part 1-2：kudo-persist-settings の CLAUDE.md §4 reference rot（6 箇所修正）¶
「WorkFlowy 書込ルール詳細は CLAUDE.md §4 を参照」を kudo-workflowy-double-save §運用ルール SSOT 参照に統一：
| 行番号 | 修正前 | 修正後 |
|---|---|---|
| L38 | WorkFlowyの書込ルール詳細はCLAUDE.md §4を参照すること |
WorkFlowyの書込ルール詳細は kudo-workflowy-double-save §運用ルール SSOT を参照すること |
| L72 | 詳細手順は CLAUDE.md §4「WorkFlowy統合運用ルール」に従う |
詳細手順は kudo-workflowy-double-save §運用ルール SSOT に従う |
| L87 | WorkFlowyへの書込ルールは CLAUDE.md §4 が一次ソース |
WorkFlowyへの書込ルールは kudo-workflowy-double-save §運用ルール SSOT が一次ソース |
| L196 | 一次ソース表「CLAUDE.md §4」 | 一次ソース表に kudo-workflowy-double-save §運用ルール SSOT／kudo-brand-tokens.json／kudo-shared-storage-protocol §5.5／CLAUDE.md §3 / §4.3 を列挙 |
| L198 | 「SKILL.md内に「CLAUDE.md §4参照」等の1行」 | 「SKILL.md内に「kudo-workflowy-double-save §運用ルール SSOT 参照」等の1行」 |
| L211 | 「WorkFlowy統合運用 / CLAUDE.md §4 / 各SKILL.md「§4参照」」 | 「WorkFlowy統合運用 / kudo-workflowy-double-save §運用ルール SSOT / 各SKILL.md「§運用ルール SSOT 参照」」 |
履歴記述（L186, L259, L1018, L1050, L1065, L1066）はそのまま残置（過去の事実として正史価値あり）。
Part 1-3：横断 grep で発見された追加修正（9 スキル 11 箇所）¶
CLAUDE.md §4 で WorkFlowy 書込ルールを参照していたPhase 3 対象外の 9 スキルを一括修正：
A. 「3. CLAUDE.md §4「WorkFlowyへの書き込みルール」（ノードID・note禁止）」パターン（8 スキル）¶
定型行のため sed 一括置換：
旧: CLAUDE.md §4「WorkFlowyへの書き込みルール」（ノードID・note禁止）
新: `kudo-workflowy-double-save §運用ルール SSOT`（WorkFlowy書込ルール一次ソース・ノードID/note禁止/失敗検知/読込先優先順位等を完全規定）
対象：kudo-autonomous-execution-protocol L16 ／ kudo-brand-architecture L16 ／ kudo-designer-lens-library L16 ／ kudo-design-mockup L17 ／ kudo-deck-generation-router L16 ／ kudo-presenter-lens-library L16 ／ kudo-proposal-deck L16 ／ kudo-schedule-budget L16
B. 文脈別個別修正¶
- kudo-autonomous-execution-protocol L196：「CLAUDE.md §4（WorkFlowy書込ルール）に従い」→「kudo-workflowy-double-save §運用ルール SSOT（v3.0 で CLAUDE.md §4 から昇格）に従い」
- kudo-designer-lens-library L354：同様修正 + 「親ノードIDは §4 参照」→「kudo-workflowy-double-save §運用ルール SSOT §1 参照」
- kudo-project-state-recovery L49：「§失敗検知プロトコル（CLAUDE.md §4.5と連動）」→「§失敗検知プロトコル（v3.0 で kudo-workflowy-double-save §運用ルール SSOT §5 へ昇格）」（§4.5 は新 CLAUDE.md に存在しないため reference rot）
- kudo-project-state-recovery L72：「書き込み先・形式は CLAUDE.md §4 が一次ソース」→「kudo-workflowy-double-save §運用ルール SSOT が一次ソース」
C. 残置（修正不要）¶
新 CLAUDE.md §4.3「読込先優先順位」と整合する参照は残置：
- kudo-project-state-recovery L3 description／L10／L14／L16／L142 →
CLAUDE.md §4.3 = 読込先優先順位で整合 ✅
履歴記述（kudo-persist-settings L186/L259/L1018/L1050/L1065/L1066、kudo-workflowy-double-save L491-493）はそのまま残置（過去の事実）。
Part 2：.skill ZIP パッケージング（8 件全件成功）¶
| # | スキル | ZIP サイズ | 同梱物 |
|---|---|---|---|
| 1 | kudo-naming-unification-protocol.skill | 12929 B | SKILL.md |
| 2 | kudo-cowork-code-handoff-protocol.skill | 27641 B | SKILL.md |
| 3 | kudo-context-routing.skill | 7854 B | SKILL.md |
| 4 | kudo-gemini-image-bridge.skill | 7887 B | SKILL.md |
| 5 | kudo-html-publish.skill | 10142 B | SKILL.md |
| 6 | kudo-workflowy-double-save.skill | 11555 B | SKILL.md |
| 7 | kudo-persist-settings.skill | 27734 B | SKILL.md + scripts/validate_skill.py |
| 8 | kudo-ai-error-watchlist.skill | 13936 B | SKILL.md |
全件 ZIP 形式 valid、{skill-name}/SKILL.md 構造（kudo-persist-settings §.skill ファイル形式準拠）。
★Phase 3 完了報告の訂正¶
Phase 3 完了報告で「validate_skill.py 不在」と書きましたが、これは誤断（Phase 4 で発見・kudo-ai-error-watchlist Entry #16 候補）。実体は ~/.claude/skills.git-mirror/snapshots/2026-05-17/kudo-persist-settings/scripts/validate_skill.py（v1.1 / 6987 B / 2026-05-07 作成）。
Phase 4 で実機実行し、17 スキル全件 PASS を確認（7 検査項目：frontmatter / name / description / 1024 字以内 / XML タグなし / 動詞群明示 / セッション固有パス禁止）：
PASS: kudo-naming-unification-protocol / kudo-cowork-code-handoff-protocol /
kudo-context-routing / kudo-gemini-image-bridge / kudo-html-publish /
kudo-workflowy-double-save / kudo-persist-settings / kudo-ai-error-watchlist /
（以下 Part 1-3 追加修正）
kudo-autonomous-execution-protocol / kudo-brand-architecture /
kudo-designer-lens-library / kudo-design-mockup / kudo-deck-generation-router /
kudo-presenter-lens-library / kudo-proposal-deck / kudo-schedule-budget /
kudo-project-state-recovery
★Part 4 論点：CLAUDE.md の Chat/Cowork 不可視性¶
HANDOFF Part 4 で指摘された通り、~/.claude/CLAUDE.md は Claude Code が自動読込する Mac ローカルファイルであり、Chat / Cowork 環境では読まれない。8 スキルが「CLAUDE.md §3 が一次ソース」と参照していても、Chat でそのスキルが起動したとき CLAUDE.md は不可視。
Phase 3 で生まれた構造的論点。Code は判断せず、Chat に差し戻し：
| 案 | 内容 | メリット | デメリット |
|---|---|---|---|
| A | CLAUDE.md §3 集中原則を個人設定 項目15 に全文インライン化（既に項目15 はある）→ 8 スキルの「CLAUDE.md §3 参照」を「個人設定 項目15」参照に変更 | Chat / Cowork / Code 全環境で読まれる | 個人設定が肥大化、claude.ai UI 編集限界（300 行制限等）に近づく可能性 |
| B | CLAUDE.md の §3 内容を kudo-shared-storage-protocol §5.5 に集約し、8 スキルの参照先をそちらに変更 |
スキルとして 3 環境共通参照可能（SKILL.md は Chat も読む） | shared-storage-protocol が肥大化、SSOT が複数化 |
| C | 現状維持（CLAUDE.md は Code 環境専用一次ソースと割り切る）。Chat/Cowork からは参照しない | 既存構造を変えない | Chat/Cowork での集中原則ガバナンスが緩い |
Code 側からの仮説提案（★参考）：案 B が最も合理的。理由：
1. kudo-shared-storage-protocol は元々 v1.2 §5.5 で集中原則ガバナンスの本体 SSOT。CLAUDE.md §3 はその要約に過ぎず、本体に集約する方が SSOT 階層的に整合
2. SKILL.md は Chat / Cowork / Code すべてで読まれるため、可視性最大
3. CLAUDE.md は §4 状態再構成（Code 用ローカル読込ルール）と §1-§2（環境共通の優先順位）に絞り、§3 を kudo-shared-storage-protocol に統合
4. 8 スキルの参照文字列も「kudo-shared-storage-protocol §5.5」で統一できる（既に kudo-cowork-code-handoff-protocol v1.13 等で実装済）
ただし最終判断は Chat 側・工藤さんへ。Phase 5 として別途。
HANDOFF からの逸脱（reasonable assumption 補正・2 件）¶
- validate_skill.py 発見：Phase 3 完了報告で「不在」と書いたが、kudo-persist-settings/scripts/ 内に同梱されていた。Phase 4 で発見・実機実行で 17 スキル全件 PASS を確認。Entry #16 候補：「snapshot の
references/scripts/等のサブフォルダを Phase 2 grep 時に走査範囲から除外してしまった失敗」。 - Part 1-3 の影響範囲拡大：HANDOFF Part 2 は「対象 8 件」だが、Part 1-3 で追加修正された 9 スキルが発生。これらは .skill 化対象外。Chat 側でPhase 5 として 9 件追加 .skill 化が必要。snapshot 直編集は次回 auto-snapshot で上書きされる可能性があるため、
phase4-patches-extra/にコピー保存（9 ファイル）。
出力物パス¶
Code 環境で実体化済（次回 snapshot で再生成される可能性あり）¶
~/.claude/CLAUDE.md（Phase 3 で新設・本 Phase 4 で参照腐敗無しを確認）~/.claude/skills.git-mirror/snapshots/2026-05-17/{17 skills}/SKILL.md（snapshot 直編集）
真の永続化（Drive 集中原則準拠・global 集中）¶
~/working/_claude_workspace_global/outputs/phase3-skills/（.skill ZIP 8 件・Chat が即時 present_files で使える形）~/working/_claude_workspace_global/outputs/phase3-patches/（SKILL.md 8 件・Part 1-1/1-2 修正反映済 + CLAUDE.md）~/working/_claude_workspace_global/outputs/phase4-patches-extra/（SKILL.md 9 件・Part 1-3 追加修正）- 本完了報告：
~/working/_claude_workspace_global/reports/2026-05-15-phase4-completion.md
★最重要：Chat 側で必要な残作業（Phase 5）¶
- Phase 3 対象 8 件の .skill 取り込み：
outputs/phase3-skills/*.skillを Chat が読み込み → present_files → 工藤さん「保存」ボタン → claude.ai > 設定 > カスタマイズ > スキル に反映 - Phase 5 追加 .skill 化：
outputs/phase4-patches-extra/の 9 SKILL.md を Chat 側で .skill ZIP 化 → 工藤さん保存（Code から Chat への Phase 5 HANDOFF 候補） - Part 4 論点（CLAUDE.md Chat/Cowork 不可視性）の判断：案 A/B/C のいずれかを工藤さんが判断（Code 側仮説提案は案 B）
- 保存後の整合確認：次回 auto-snapshot（月曜 4:00）で snapshot に v1.13 / v1.3 / v0.2 / v0.5 / v3.2 / v3.8 / v2.4 / Entry #15 + Part 1-3 修正が反映されているか確認
- Entry #16 追加候補：「snapshot の
references/scripts/等のサブフォルダを Phase 2 grep 走査時に除外してしまった失敗」を kudo-ai-error-watchlist に追加（Phase 5 か別 HANDOFF）
絶対遵守事項チェック¶
- ✅ バージョン番号を上げてから .skill 化（Part 1-1 → Part 2 の順）
- ✅ reference rot を修正してから .skill 化（Part 1-2/1-3 → Part 2 の順）
- ✅ .skill は
_claude_workspace_global/outputs/phase3-skills/のみに配置 - ✅ description 1024 字以内を全 17 件で確認（validate_skill.py 実機実行）
- ✅ 完了報告に Part 4 論点を明記して Chat に差し戻し