最近の気付きみたいなものなんだけれども、ClaudeCodeでHTMLダッシュボードを作ったらめちゃくちゃ調子が良かったので、その話を今回はしていこうかなと思う。
ClaudeCodeでプロジェクトを運営していると結構ぶち当たりがちなポイントだと思うので、ClaudeCodeの非エンジニアユーザーの参考になれば幸い。
僕が感じていた課題
僕がClaudeCodeでプロジェクトを運営する時に最近感じていたことがある。
それは「AIと共通認識が取れていない」という感触。
前提として、これが起きるのは「ゴールは一つなんだけど、そこに向かうための要素が複数ある」プロジェクト。
例えば、物販のプロジェクトの時って、「売上を上げていく」「費用対効果の最適化をしていく」という全体のゴールがあると思うんだけれども、そのなかにはAmazon広告があったり、Meta広告があったり、TikTokがあったりとか個別の要素に分解されていく。

できればコンテクストを一個に集約させてシームレスにプロジェクト運営をしていきたい。
ただ、そうすると、AIが考えている全体像や目下やるべきことと、僕が考えているそれが徐々に離れていくような錯覚が生じる。
- 「これをまずやりましょう!」というAIの提案が、僕からするとすごく優先順位の低いものだったりする
- 「⚪︎月⚪︎日までにこれを設定していきましょう」と提案してくれるんだけど、他の要素を加味すると全然間に合わないスケジュール感になっている
- Todoリストを出してもらっても粒度が謎に抽象的だったり、MECE(漏れなくダブりなく)になっていなかったりする
こんなところが具体的な現象。
こういった細かいズレが随所で出てくるというのが最近のプロジェクト運営で悩んでいたところ。
どうしてこんなことが起きるのか
AI側が把握しているコンテクストと僕が抱えているコンテクストが若干ずれているので、こういう現象が起きてくるのだろうと思っている。
実際、AIはゴールとTodoリスト、それに伴う資料などのコンテクストしか把握していない。
一方で、僕の手元にはそれ以外の情報もある。クライアントが持っている「これだけは先に確認したい」みたいな温度感とか、AIが認識している以上にステークホルダーが多かったりとか。あと、他のタスクとの兼ね合いで優先順位が変わったりもする。
ここら辺の情報がAIに届いていないことで、微妙なズレが生じているんだと思う。

解決策|共通認識を取るためのダッシュボードを作るのが望ましい
とはいえ、コンテクストを100%揃えるのは結構難しいと思う。
まず情報を与えていくことが難しいし、たくさん情報を与えすぎることによってAIの動きがバカになってしまっては元も子もない。
じゃあどうするのかというと、逆に全体像・ゴール・現在地点のアウトプット部分を揃えてしまうという手段が考えられる。
ここがそろっていれば、多少コンテクストがズレても誤差の範囲に収まるし、重要なものは改めて渡せばいいってことになる。
この全体像・ゴール・現在地点を一目でわかるようにまとめたものが、ここで言うダッシュボード。

Markdown・Excel・Notionは認知負荷がすごい
なるほどダッシュボードを作るのが大事というのはわかった。問題はどうやってそれを実現するのかということ。
いろいろ試してみて、見出しの通りMarkdownファイルとExcelファイル、Notionでやったけど上手くいかなかった。
Markdownファイル
まず試したのがMarkdownファイル。結論、AIには扱いやすいけど、人間には見づらかった。
Markdownはテキストベースなので、情報がどんどん書きなぐられていく。AIからすると編集コストも少ないし、情報管理もしやすいのかもしれない。
ただ、人間からすると、文字だけで全体像を掴んだり、現在地点を把握したりするのはすごく難しい。
というのも、Markdownはビジュアライズにすごく弱いから。Mermaidで図解もできるんだけど、場合によってはめちゃくちゃ見づらい図になってしまう。
Excelファイル
次に、人間が扱いやすいものとしてExcelが候補になるんじゃないかと思って試してみた。Excelならビジュアライズもできるし、グラフも作れる。
と思ったんだけど、これもいまいちだった。
というのも、「AIが見やすい」と「人間が見やすい」がなかなか両立しなかったから。
AIが作るExcelは配色が独特だったり、行や列の固定がうまくできていなかったりして、人間から見るとかなり見づらい。
あと、作り方の問題もある。まず表を作って、そこからダッシュボードに整形するという流れになるので、メンテナンスが結構大変だった(僕のExcelだけかもしれんけど)。
それに、僕自身がそこまでExcelを使い込んでいないこともあって、自分の中に型がなかった。Excelに慣れている人なら、これはこれでいいかもしれない。
Notion
最後に試したのがNotion。慣れているツールでやるのが一番いいかと思って、Notionページにダッシュボードを作ってみた。
ただ、これもいまいちだった。
無料版のNotionだと描画に限界があって、結局Markdownファイルと同じ悩みにぶつかる。人間側の認知負荷を下げることができなかった。
たどり着いた最適解がHTML
もはやこれまでかと諦めたんだけど、めっちゃ良かったファイル形式に出会った。
それがHTML。
Webサイトを作る言語として有名だと思うんだけど、これを使って「AIと人間の共通認識図解サイト」みたいな感じでダッシュボード化するのがおすすめ。
理由としては
- AIにとって編集が容易
- 人間にとっても見やすい
- ビジュアライズの自由度が高く、直感的に共通認識を取りやすい
- プロジェクトの要素ごとにタブ管理ができるので情報量の制御もしやすい
ここら辺が挙げられる。

実際の運用方法
ここからは、僕が実際にどんな感じでダッシュボードを運用しているのかを紹介する。

実際のものはクライアントの情報が入っているので、構成はそのままに中身をダミーに差し替えたものを載せておく。
一番上に「今いちばん大事な数字」を4つ並べて、その下に媒体ごとのタブ(Amazon/Meta広告/TikTok/共通)を置いている。どのタブも、ステップの矢印図に「▶ いまここ」が付いていて、その下に大項目ごとの担当・期限・状態が色分けで並ぶ。あとは近い節目と、まだ決まっていないことを1枚にまとめている。
タスクは「段階1 まず回す」と「段階2 質を上げる」の2段に分けている。最初の2割の工数で、品質を問わずとにかく回る状態まで持っていく、という進め方をAIにも共有しておくと、提案の優先順位がだいぶ揃うようになった。
運用のポイントは、ダッシュボードの更新を日課に組み込んでしまうこと。
僕は /daily というスキル(ClaudeCodeに決まった作業手順を覚えさせておける機能)を作ってあって、そこにダッシュボードの更新を追加している。/daily を実行すると、各種情報を拾ってきてダッシュボードを更新してくれる。

/daily の流れ具体的には、Notionのプロジェクトページと、チャット・メールに来た前回以降の新しい連絡を読みにいく。拾った内容で手元の資料とNotionのタスクを更新して、その最後にダッシュボードを書き換える。ついでに、返し忘れていそうな連絡も挙げてもらっている。
大事なのは、連絡に進展がない日でも「いまここ」の位置や期限の色は毎回見直すようにしていること。これで「ダッシュボードを開けば今の状況」という状態が崩れない。
こうしておけば、更新を忘れることがない。毎回同じ全体像を見ながらAIと話せるので、提案のズレにも気付きやすくなる。
ただ、ダッシュボードに何でも載せようとすると、結局情報が多すぎて見づらくなる。載せるのは全体像・ゴール・現在地点に絞るのがおすすめかな。
まとめ ~ AIにとって働きやすい職場を ~
最後に、今回の内容を振り返っておく。
- ClaudeCodeでプロジェクトを運営していると、AIと共通認識が取れていない感触が出てくる
- 原因は、AIが把握しているコンテクストと僕が抱えているコンテクストのズレ
- コンテクストを100%揃えるのは難しいので、全体像・ゴール・現在地点のアウトプットを揃える
- Markdown・Excel・Notionも試したけど、AIと人間の両方が見やすかったのはHTMLだった
大事なのは、AIにとって働きやすい職場を作ってあげることだと思う。
人間でも、会社の方針やチームの状況が見えていないと、的外れな提案をしてしまう。AIも同じで、ズレた提案が出てくるのはAIがポンコツだからというより、全体像が共有されていないからなのかもしれない。
ClaudeCodeでプロジェクトを回していてモヤモヤしている人は、ぜひHTMLダッシュボードを試してみて欲しい。

