Claude Codeに「進捗どう?」と聞くのをやめた ― 隣の画面で勝手に育つ"きょうのボード"
複数のプロジェクトを Claude Code に委任して並行で進めていると、1日に何度も同じことをやる羽目になります。
チャット窓を切り替えて「進捗どう?」と聞く。長い返事を読む。別の窓に切り替えて、また聞く。夕方になると「今日って結局何が終わったんだっけ」とスクロールで遡る——委任した作業そのものより、状況把握のほうが仕事になっている瞬間がありました。
で、気づいたんです。Claude はファイルを書けるんだから、進捗ボードも Claude に書かせればいい。私が聞きに行くのではなく、向こうが書きに来る形にすればいい。
そうして作ったのが「きょうのボード」です。この記事はその紹介と、作る過程で分かった設計上の学びの共有です。ツールは GitHub で無料配布しています(MIT)。
朝に発行 → 作業が進むたびに Claude が書き換える → 隣の画面で勝手に育つ
作ったもの
「きょうのボード」= Claude Code が自分で更新する、今日のタスク管制盤(HTML 1ページ) です。
- 朝、Claude Code と今日の予定を整理すると、1ページの HTML ボードが発行される
- ボードをサブモニタや隣のウィンドウに置いたまま作業する
- タスクが終わるたび、Claude が自分でボードを書き換える(同梱のスクリプト経由。ページは5分ごとに自動リロード)
- 予定時刻になるとポップアップで通知(通知音は既定 OFF。⚙で ON にすると同梱の Deck が鳴らします)。「▶ 次」のタスクは現在時刻から自動でハイライト
構成は2層です。どちらも setup.bat のダブルクリック1回で入ります。
- ボード本体(スキル) — 外部サーバーなし・DB なし・追加 API なし。実体は Claude Code の「スキル」フォルダ1つ(指示書の Markdown 1本+HTML テンプレ+CSS/JS+アイコン+ボードを書き換える Python スクリプト+ボードの保護のフック)だけです
- Deck(同梱・常駐) — 並行で走らせている全セッションの状態(タスク一覧があれば進捗も)をボード下部に自動集約し、時刻トリガーの通知音も鳴らす常駐ウォッチャー。Python 標準ライブラリのみの単一ファイルで、セットアップで一緒に入り、次回以降は Windows のログオン時に起動します(後述)
Zenn には「Claude Code の進捗を可視化するダッシュボードを作った」系の記事がすでにたくさんあります。React でビューアを建てる、tmux で分割する——どれも良いのですが、私が欲しかったのは自動でClaudeにタスクの一覧と進捗の見える化をさせることでした。可視化はサーバーを建てずに Claude 自身のスキルへ、全セッションの集約と通知音は1ファイルの常駐へ。ここがこのツールの設計上の分かれ目です。
仕組み: ダッシュボードを「建てる」のではなく「書かせる」
普通、可視化ツールを作るとなると「データソースを読むプロセス」と「表示するUI」を建てます。このツールは表示側を建てません——UI は Claude が更新する HTML ページです。データを読む側も、外部サーバーではなく同梱の1ファイル常駐(後述の Deck)だけです。
朝: Claude が今日のタスクを JSON にし、同梱のスクリプト(board_edit.py)の create がテンプレから ~/.claude/today-board/board.html を作る
日中: 進捗が変わるたび、Claude が board_edit.py の操作でボードを書き換える
表示: ブラウザが5分ごとに自動リロードするだけ
翌日: 同梱の Deck が前の日のボードを history/ へ残し、終わっていないタスクを引き継いだ今日のボードを作る(local モード)
つまり LLM を「ダッシュボードの更新デーモン」として使う構成です。Claude Code はもともとファイルを読み書きし、コマンドを実行するのが本業なので、ボードの更新も、同梱のスクリプト(board_edit.py)に「この行を済にする」のような操作を渡すコマンドの実行で済みます。外部サーバーも DB も建てず、常駐するのは同梱の Deck(Python 標準ライブラリのみの1ファイル)だけ(Deck はボードの D&D 移動・通知音の設定・✎ の時刻の上書き・通知の受け渡しのために 127.0.0.1 限定の受信ポートを1つ開きますが、外部への送信はしません)。壊れる場所もほぼゼロ。
「それだけ?」と思われそうですが、それだけで成立させるために、スキル(指示書)側にいくつか運用ルールを埋め込んでいます。ここが今回いちばん面白かった部分なので、後半で詳しく書きます。
スキルという配布形態
ボード本体の「実体」は実行ファイルではなく、SKILL.md という日本語の指示書です(ボードへの書き込みと保護は、同梱の Python スクリプトが受け持ちます)。Claude Code のスキルは、フォルダを ~/.claude/skills/ に置くだけで、Claude が状況に応じて読み込んで従う仕組みです(ビルドも npm も不要。setup.bat はそのコピーと、ボードの保護のフックの設定ファイル(hooks.json など)の作成、Deck の配置・スタートアップへのショートカット作成・起動を代わりにやっているだけで、実行ファイルのインストールやレジストリの変更はしません)。
スキルのフォルダの中身はこれで全部です(hooks/hooks.json は setup.bat が作ります):
today-board/
├── SKILL.md ← Claudeへの指示書(ボードの作り方・更新ルール)
├── LICENSE ← ライセンスの文面(MIT)
├── .claude-plugin/
│ └── plugin.json ← プラグインとしての名前と説明(フックを読み込ませるため)
├── assets/
│ ├── board-template.html ← 約100行のテンプレ
│ ├── board.css ← 見た目
│ ├── board.js ← 自動機能(通知の描画・ハイライト・テーマ)
│ └── cat.png ← 見出しの猫アイコン
├── hooks/
│ ├── guard.py ← ボードの保護(専用のスクリプトを通さない書き換えを止める・戻す)
│ ├── hooks.json ← make_hooks.py が作る
│ ├── hooks.template.json ← hooks.json の雛形
│ └── make_hooks.py ← 雛形から hooks.json を作る
└── scripts/
└── board_edit.py ← ボードを書き換える専用のスクリプト
Claude がいつ・何をボードに書くかは、Markdown を書き換えれば変えられます(ボードへの書き込みそのもの——操作の種類や HTML の組み立て——は同梱の board_edit.py にあるので、そこを変えるには Python を直します)。「振る舞いの仕様が日本語の散文」というのは、配って改造してもらう前提のツールとして結構理想的な性質だと思っています。
ローカルHTMLか、Artifact か(ついでに誤解の訂正)
ボードの置き場所は2モードから選べるようにしました。
- local モード: 固定パスの HTML をブラウザで開く。PC の隣画面に常時表示する人向け。ボードのファイルはローカルに置かれます(Claude がボードを読み書きするので、その内容はふだんの会話と同じく Claude の API に送られます)
- artifact モード: claude.ai の Artifact として発行して URL で見る。スマホから見たい人向け
ここで1つ訂正しておきたい誤解があります。日本語圏の記事やSNSで「Claude Code からの Artifact 発行は Team/Enterprise プラン限定」という情報を何度か見かけましたが、個人プランでも使えます。私は個人アカウントで、このボードの artifact モードを実際に運用していました(このツールの初版はそもそも Artifact として生まれました)。公式ドキュメントも Claude Code から Artifact を発行してスキル化する使い方を紹介しています。
とはいえ常時表示ボードとしては、リロードが確実で複数プロジェクトを HTML 1ページで表示できる local モードのほうが快適だったので、デフォルトの推しは local です。
使い方
必要なものは Windows 11(10 は未検証)・Python 3・Claude Code(有料のアカウントが要ります)で、Git for Windows も入れておくのがおすすめです。Python と Claude Code を先に入れてから、きょうのボード本体を入れる2段の手順です。前提のソフトの入れ方と、途中で出る画面ごとの答え方は README の「インストール」に書いています。
- リポジトリを取得(
git cloneか ZIP。ZIP は右クリック →「すべて展開」してから使います。フォルダが二重になることがあります) 👉 GitHub: today-board setup.batをダブルクリック(管理者権限は不要)。スキルと Deck の配置・スタートアップ登録・起動まで済みます。拡張子が表示されない設定だとsetupが2つ並ぶので、エクスプローラーの上部の「表示」→「表示」→「ファイル名拡張子」にチェックを入れてから、setup.batを選びます。インターネットから落とした ZIP だと「開いているファイル - セキュリティの警告」が出るので、入手元を確かめて「実行」を押します- Claude Code を起動して「今日のタスクをボードにして」と言い、続けて今日のタスクを箇条書きで送る
初回は表示モード(local / artifact)を聞かれます。途中で作業フォルダの外のファイルを読む確認が出たら Yes 側を選んでください(No, and block reads outside the working directories from now on を選ぶと、以後すべてのセッションで作業フォルダの外が読めなくなり、ボードを作れなくなるおそれがあります)。すると Claude が送ったタスク(足りなければ会話やログも)を4分類(今日の予定/今日中/ルーチンタスク/明日以降)に整理したボードを発行し、ブラウザで開きます。
あとは普通に作業するだけです。「デプロイ終わった」と報告すれば済チップが付き、進捗バーが伸びる。夕方にボードを見れば、今日の全記録が結果メモ付きで残っています。日付が変わると、同梱の常駐ツール(Deck)が終わっていないタスクを引き継いだ今日のボードを作り、ボードのパスは毎日同じなので、local モードでは、タブを開きっぱなしにしておけば翌朝は自動で新しい日のボードに切り替わります(Deck を止めているときと artifact モードでは切り替わりません。Deck が動いていても、ボードの形が崩れているときなど、切り替えずにおくボードがあります。local モードでは、ヘッダの下に「書き込み停止中」と出ます)。
ダークテーマ(4分類のうちルーチンタスクを省いた例)。時刻付きタスクは時系列、特に重要なタスクは赤い左罫と「重要タスク」のチップで強調
予定時刻になるとトーストで通知。音は既定 OFF で、⚙から4種類のうち1つを選んで ON にする
設計の学び: LLM に UI を任せるときの線引き
作ってみて分かったのは、「Claude がボードを書く」構成の成否はどこを LLM に任せ、どこを決定論(ただのJS)に任せるかの線引きで決まる、ということでした。スキルの指示書に埋めた運用ルールと道具の側に置いた仕掛けのうち、汎用性がありそうなものを共有します。
1. 時間に関わる表示は LLM に任せない
「次のタスクはどれか」「時刻を過ぎたか」を Claude に書かせると、更新のたびに判定させることになり、更新頻度=鮮度になってしまいます。そこで現在時刻に依存する表示(「▶ 次」ハイライト・時刻超過チップ・相対時刻)は全部ブラウザ側の JS に寄せました(時刻トリガーの通知だけは Deck と分担です——通知音の発火判定と発音は Deck 側、ブラウザは受け取った通知を描画します。ブラウザ側でも同じ発火判定が常に走っており、Deck が止まっていてもポップアップは出ます〔board.js の checkAlarms。音は鳴らしません。Deck 経由と同じキーなら二重には出ません〕)。Claude が書くのは「事実」(タスクと状態)だけ。鮮度は JS が保証する。この分離で、Claude の更新が数時間止まってもボードは正しく振る舞います。
逆に SKILL.md には、これらの自動機能について「生成・更新時にこれらを付けたり消したりしようとしないこと」と明記しました。LLM は気を利かせて自動機能を手動で再現しようとするからです。
2. 「完了判定を先回りしない」を明文化する
初期に一番危なかったのはこれです。予定時刻が過ぎたタスクを、Claude が空気を読んで「済」にしてしまう。進捗ボードで一番壊れてはいけないのは「済」の信頼性なので、指示書に「ユーザーの報告か、自分が実際に完了させた作業だけを「済」にする」という1行を入れました。LLM に運用を任せるツールでは、こういう「善意の暴走」の抑止条項が UI 仕様と同じくらい効きます。
3. 複数セッションで壊れない「正本」を決める
Claude Code を並行で何セッションも走らせると、全員が同じボードを更新しに来ます。ここで Artifact のような「発行し直し」型だと板が分裂しがちでした。local モードでは固定パスの1ファイルを正本にして、書く直前に必ず読み直すというルールにしています。他セッションや Deck が先に書き換えている前提で、読み直しと書き込みは同梱の専用スクリプト(board_edit.py)に任せ、Claude は「この行を済にする」のような操作だけを渡します(Write・Edit での直接の編集はフックが止め、シェルからの書き換えも、タスクの行を変えたときなどは元に戻すか Claude に知らせます)。プロジェクトごとにセクションを区切り、自分のセクションしか触らない。人間のチーム運用と同じ話が、そのまま LLM のマルチセッション運用に適用できるのが面白いところです。
4. 進捗の分母を設計する
「N / M 完了」の分母に何を入れるかは意外と重要でした。ルーチンタスク(ログ更新とか)や「明日以降」を分母に入れると、進捗バーが1日の実感とズレます。今は時刻付きの予定と「今日中」だけを数える仕様です。ダッシュボードの数字は、正確さより「1日の体感と一致するか」で決めたほうが毎日見続けられます。
5. 壊れて困る書き方は、指示書に加えて道具でも止める
指示書に「ボードはこの手順で書く」と書いても、Claude が別のやり方で書き換えることがありました。そこで書き換えの入口を専用のスクリプト(board_edit.py)に絞り、書く前に形が崩れないかを確かめるようにしました。Write・Edit はフックで止め、シェルからの書き換えは、タスクの行を変えたときなどに、ツールが終わった時点で元に戻すか Claude に知らせます(戻す条件と戻さない変更は README に書いています)。
私の環境では、ボードの書き方については、指示書に手順を書くだけでは守られないことが続きました。上の「済」の1行のように指示書に書いておく場面もあるので、指示書が要らないという話ではありません。書き方を誤るとボードが壊れるような場所は、指示書に書くだけでなく道具の側でも止めるのがよいと思います(この道具で事故がどれだけ減るかは、まだ分かりません)。
複数セッションを1ページに集約する: Deck(同梱・常駐)
Claude Code を複数プロジェクトで並行させていると、「自分で書いたタスク」以外に、各セッションがいま何をしているか(作業中か・入力待ちか・確認を待っているか。タスク一覧を使っていれば進捗も)があります。これを1枚に集約するのが同梱の常駐ウォッチャー Deck です。時刻トリガーの通知音も Deck が鳴らします(ブラウザ側では自動再生制限のため、触らずに置いている画面では鳴らせませんでした)。setup.bat で一緒に入るので、利用者が別途やることはありません。
ボード下部の「全セッション」欄に、各セッションの状態カードが自動で並ぶ
- Claude Code の transcript を差分監視し、全セッションの状態をボード下部の予約領域に自動挿入します。予約領域の外に触れるのは、D&D の反映や日付の切り替えなどに限り、タスクの文言は書き換えません(詳しくは README)。
- Python 3 標準ライブラリのみ・単一ファイル・pip 依存ゼロ・外部ネットワーク通信なし(ボードの D&D 移動・通知音の設定・✎ の時刻の上書き・通知の受け渡しのための
127.0.0.1限定の受信ポートが1つだけ・送信なし) setup.batがスタートアップに登録するので、次回以降は Windows のログオン時に起動します(一時停止はタスクマネージャーでdeck_watcher.pyを含むpythonw.exeを終了〔Python install manager で入れた場合は2つ並ぶことがあり、両方終了します〕、自動起動だけやめるならスタートアップのtoday-board-deck.lnkを削除、消すならuninstall.bat〔ボードのデータも消すかは実行時に聞かれ、既定は残す〕)- ユーザーの承認・回答待ちで止まっているセッション(Claude の問いが未回答のものを含む)は「保留」チップで区別表示
なお Deck は Claude Code の transcript 内部形式に依存するため、Claude Code の更新で壊れる可能性があります(読めなくなったファイルは沈黙せず、ボード上にエラーが表示される設計です。デスクトップアプリの計画一覧の形式が変わった場合だけは、エラーにならず状態だけの表示に戻ります)。Deck が止まっていてもボード本体は普通に使えます(止まるのは、全セッションの自動集約・通知音・日付が変わったときの今日のボードへの切り替えなどです。日付が変わったら、Claude に「今日のボードを作って」と頼んでください)。
正直な注意点
- 反映ラグは最大5分です(自動リロード間隔)。リアルタイム監視ツールではなく「1日の管制盤」です
- Claude がタスクツールやログをきちんと使う運用をしているほど、ボードの質が上がります。逆に何も記録しない運用だと Claude が拾える材料も減ります(全セッション欄で進捗 N/M が出るのは、タスク一覧の道具〔TaskCreate 等、またはデスクトップアプリの計画一覧〕を使ったセッションだけで、それ以外は「作業中」「入力待ち」などの状態だけが出ます)
- 動作確認は Windows 11 + Claude Code、ブラウザは Microsoft Edge です(ほかのブラウザでも動く想定ですが、Safari / Firefox は未検証。Chrome も全ての動作は確かめていません)。macOS / Linux は無保証(AS IS)で出しています(
setup.batと Deck は Windows 専用。スキル部分は手でコピーすれば動く想定ですが未検証です。要望が多ければ対応を検討します) - Deck は Claude Code の内部形式(transcript)に依存します。公式 API ではないため、将来の更新で追随修正が必要になる可能性があります
setup.batはスタートアップにショートカットを作ります。2026-10-26 に同じ PC の別のアカウントで、導入から再起動後の自動起動、アンインストールまでを1回通しました(当時の README に無い判断が5件要り、ボードを頼むところは確認用の手順の紙を併用しました。再起動の後は作者のアカウントの Deck も同時に動いていました)。その後に手順と仕組みを変えており、今の版をsetup.batから入れて通す確認はまだです。ボードの書き換えと保護を確かめた範囲は README の「動作環境」に書いています。
配布について
GitHub で公開しています。MIT ライセンスなので、テンプレの見た目もスキルの指示書も自由に改造して問題ありません。
役に立ったらリポジトリの ⭐ が励みになります。開発の支援は以下の Ko-fi で受け付けています(支援いただいた方は更新時の Special Thanks でお名前を紹介します)。
おわりに
「進捗どう?」と聞くのをやめて毎日このボードを使っていますが、複数プロジェクトの並行委任は明らかに楽になりました。状況把握のコストが下がると、委任の心理的なハードルも下がります。Claude Code の出力を人間が追いかけるのではなく、人間が見る場所へ Claude に書きに来させる——この向きの逆転は、ダッシュボードに限らず色々応用が効く気がしています。
この記事が面白かったら、クリエイターページをフォローしてもらえると嬉しいです(無料登録)。フォローすると新着記事がメールで届きます。
X: @jir0_dev でも開発ログを流しています。