HTMLとJSONを「別々のファイル」として管理すると、どちらかを更新したときにもう一方が古いままになる。
２つのケースを比較する。
Case A
別々に管理する
HTML と JSON を独立した2ファイルとして手動更新
Case B
HTMLが唯一の正
JSONはHTMLのExport JSONボタンで毎回生成
更新する
HTML
フェーズを追加した。
アクティビティマップも修正した。
触っていない
JSON
前のセッションのまま。
誰も更新していない。
↓ この状態でClaude Codeにどちらを渡すか？
HTMLを渡す？
HTMLを渡す
Claude Codeはコードとして読む。
アーキテクチャ情報として使いにくい。
JSONを渡す？
JSONを渡す
古いまま。
HTMLとの乖離が発生している。
問題
更新のたびに「どちらが最新か」を確認する必要がある。セッションが増えるほど乖離のリスクが高まる。ツールが育つほど管理コストが上がる。
唯一の更新点
HTML
フェーズ・コンポーネント・アクティビティマップ・ブロッキング課題。
全データをSECTION 1〜5に集約。
↓ Export JSON ボタンを押す
自動生成
JSON
HTMLのデータから生成される。
常にHTMLと一致。乖離しない。
↓ Copy → Claude Code セッション冒頭に貼る
コンテキスト注入
Claude Code
スクリプト名・フェーズ詳細・関節・関数・
ブロッキング課題・禁止事項を一括でコンテキスト注入。
Export JSON ← HTMLに組み込まれたボタン。押すたびに最新のJSONを生成。
解決
更新はHTMLのデータセクションだけ。JSONは常にそこから生成される。「どちらが最新か」を確認する必要がなくなった。