HANDOFF — Phase 5:集中原則波及の仕上げ¶
| 項目 | 内容 |
|---|---|
| 起案 | Chat Claude |
| 宛先 | Code Claude(ローカル Mac) |
| 起案日 | 2026-05-17 |
| 前提 | Phase 4 完了(8 .skill 化済・9スキル追加修正済)。Part 4 論点は B案で確定 |
| 所要時間 | 30-40 分 |
0. 背景¶
Phase 4 完了。残るは仕上げ5パート。Part 4 論点(CLAUDE.md の Chat/Cowork 不可視)は B案で確定: CLAUDE.md は Code 環境用の集約索引として残すが、8スキルの「CLAUDE.md §3 参照」を実体スキルへ張り替える。
Part 1:B案実装 — 8スキルの §3 参照張り替え¶
1-1. 対象8スキル¶
autonomous-execution-protocol / brand-architecture / deck-generation-router / design-mockup / designer-lens-library / presenter-lens-library / proposal-deck / schedule-budget
1-2. 張り替えルール¶
各スキルの「保存先パス/NFC-NFD対策は CLAUDE.md §3 が一次ソース」という記述を、文脈別に張り替え:
| 元の参照 | 文脈 | 張り替え先 |
|---|---|---|
| CLAUDE.md §3(保存先パス) | 生成物の格納先の話 | kudo-shared-storage-protocol §5.5 |
| CLAUDE.md §3(NFC-NFD) | 文字正規化の話 | kudo-naming-unification-protocol §6 |
| CLAUDE.md §3.2(二層ワークスペース) | 案件直下 vs global | kudo-context-routing §1.3 |
grep で該当箇所を特定:
SNAP=~/.claude/skills.git-mirror/snapshots/2026-05-17
grep -rn "CLAUDE.md §3\|CLAUDE.md§3" "$SNAP"/*/SKILL.md
各ヒットを文脈判断で上表の実体スキルへ張り替え。
1-3. CLAUDE.md 自体の索引化¶
~/.claude/CLAUDE.md の §3 冒頭に索引注記を追加:
※ §3 の各規律の実体(一次ソース)は以下のスキルにある。本セクションは
Code 環境向けの集約索引。Chat/Cowork では各スキルが直接参照される:
- §3.1/§3.3 集中原則・特例配置 → kudo-shared-storage-protocol §5.5
- §3.2 二層ワークスペース → kudo-context-routing §1.3
- §3.4 文字正規化 → kudo-naming-unification-protocol §6
Part 2:phase4-patches-extra/ の 9 SKILL.md を .skill 化¶
Part 1-3 で修正された 9 SKILL.md(autonomous / brand-architecture / designer-lens / design-mockup / deck-generation-router / presenter-lens / proposal-deck / schedule-budget / project-state-recovery)を .skill 化。
順序重要:Part 1 の B案実装で8スキルが更に編集される。Part 1 完了後に .skill 化すること(二度手間防止)。
→ ~/working/_claude_workspace_global/outputs/phase5-skills/ に9件配置。
description 1024字を validate_skill.py で全件チェック(kudo-persist-settings/scripts/validate_skill.py)。
Part 3:Entry #16 追加¶
kudo-ai-error-watchlist に追加(§4 タイトルを15件→16件に):
### Entry #16:snapshot サブフォルダを走査範囲から除外し validate_skill.py を「不在」と誤認
- 日付:2026-05-17
- 領域:ファイル探索 / 走査範囲の設定
- 誤り:Phase 3 で「validate_skill.py 不在」と報告したが、実際は
kudo-persist-settings/scripts/validate_skill.py に同梱されていた(6987B/2026-05-07作成)
- 真相:snapshot 配下のスキルフォルダの s------ サブフォルダ(scripts/ 等)を
走査範囲から除外していたため見落とした
- 一次ソース:Phase 4 で実機発見・17件全件 PASS 確認
- 永続化ルール:スキル付随スクリプトを探すときは {skill}/scripts/ サブフォルダまで
含めて走査する。「{skill}/SKILL.md のみ」と走査範囲を狭めない
- 関連:Entry #15 と同じ「作業前の確認不足」系
Part 4:(完了済み)v8 完了報告¶
Cowork v8 完了報告は Chat が reports/2026-05-17-cowork-v8-completion.md に永続化済(ID: 1NOjgHt68qAIvC1FTKXHQG0__VmVKcDTA)。Code 側作業は不要。
ただし、v8 Task D の「リスクマネジメント全角/半角カッコ」は Mac 実体側確認が Code に残っている:
結果を completion 報告に記載。Part 5:完了報告¶
~/working/_claude_workspace_global/reports/2026-05-17-phase5-completion.md に配置:
- Part 1 張り替え:8スキル [N箇所]
- Part 2 .skill 化:9件 [全件成功/失敗]
- Part 3 Entry #16:追加済
- Part 4 リスクマネジメント実体確認:[結果]
- 全 .skill リスト(phase3-skills 8件 + phase5-skills 9件 = 17件)
★Phase 5 完了後の最終アクション(工藤さん手作業)¶
Phase 5 完了で、保存すべき .skill が出揃う:
- outputs/phase3-skills/ … 8 .skill(Phase 4 作成)
- outputs/phase5-skills/ … 9 .skill(Phase 5 Part 2 作成)
- 合計 17 .skill
工藤さんが claude.ai > 設定 > カスタマイズ > スキル で 17 .skill を保存 → 集中原則の全 SKILL 波及が真の SSOT に反映され完了。
絶対遵守事項¶
- ❌ Part 1 完了前に Part 2 の .skill 化をしない(順序厳守)
- ❌ description 1024字超過のまま .skill 化しない
- ✅ 全成果物は
_claude_workspace_global/配下(outputs/reports/) - ✅ 完了報告に「17 .skill の最終リスト」を明記