TODOを二刀流にしたら、「次にやるべきこと」も1件から2件に増えた話

前回の記事ではQwen CLI単体での定例更新の話を書いた。今回はまたダッシュボード周りの話で、これまで開発プロジェクト用のTODOしか扱えなかった仕組みを、主個人の人生タスクにも広げた顛末についてまとめる。

upload_todo.jsonだけでは足りなかった

これまでTODOはai_data/upload_todo.json一本で管理していた。MY-life本体やサブプロジェクトの開発・データ整備に関するタスクが対象で、ダッシュボードのヒーロー枠にも「🎯 次にやるべきこと」として優先度最小の1件が自動で表示される仕組みがすでにあった。

ただこのファイル、開発関連以外のタスク――買い物や連絡、生活の雑務のようなものを入れる場所としては筋が悪い。実際、開発と無関係な思いつきをここに書き足すたびに違和感があった。そこで新たにai_data/whyyou_todo.json（完了アーカイブはwhyyou_todo_done.json）を新設し、開発用の「MY-life_Todo」と人生用の「whyyou_Todo」の2ファイル制に切り替えることになった。

セクション生成処理を共通化する

dashboard_viewer/server.py側では、TODO一覧セクションを組み立てる処理をもともとupload_todo.json専用で書いていた。今回はこれを_build_todo_list_section()という共通関数に切り出し、todo_list_section()（🛠️ MY-life_Todo 一覧）とwhyyou_todo_list_section()（🧑 whyyou_Todo 一覧）の2つがそれぞれ薄いラッパーとして呼ぶ形にした。whyyou_todo.jsonが空の間はセクション自体を出さないようにもしてあるので、運用が始まっていない状態でも表示が壊れることはない。

見出しの絵文字は後にアイコン画像へ差し替えた。whyyou_Todo側には専用アイコン（whyyou_todo.ico）を用意し、静的アセットとして永続化した。ついでにセクション見出しの絵文字/アイコン描画部分も共通のsetSectionTitleContent()にまとめている。

TODOステータスも整理した

このタイミングでTODOのステータス種別も見直した。もともと5種類あったうち、実質使われていなかった「依存待ち」を廃止し、「ユーザー対応待ち」は「他人対応待ち」に改称した。AI以外の人手対応待ち全般を指す、より汎用的な名前にしたかったからだ。カンバンの列・配色・既存データ・スキーマ定義まで一通り追随させ、4種類に整理して落ち着いた。

「次にやるべきこと」欄、数時間で2回作り直した

ここからが今回いちばん面白かったところだ。「次にやるべきこと」欄はもともとupload_todo.jsonだけを見て優先度最小の1件を選ぶ仕組みだった。2ファイル制になった以上、これもwhyyou_todo.jsonを見るように直す必要がある。

最初に書いたのは、2ファイルを横断してまとめて1件を選ぶ実装だった。upload_todoとwhyyou_todoはそれぞれ独立採番のidを持つため、優先度が同率になった場合の決着方法として「upload_todoを先に評価する」というタイブレークルールを足した。これで動くには動く。

ただ実装し終えてすぐ、これだと不便だと気づいた。横断選択である以上、常にどちらか一方のファイルのタスクしか表示されない。開発中のプロジェクトタスクが優先度で勝ち続ければ、人生タスク側は「次にやるべきこと」欄に一生出てこないことになる。これでは2ファイルに分けた意味が半減してしまう。

そこで6分後、同率優先度のタイブレークルールごと実装を差し替えた。2ファイルそれぞれから独立に1件ずつ選び、最大2件を並べて表示する方式に変えたのだ。片方が候補なし（該当タスクが0件）の場合はもう一方の1件だけを表示する。さっき書いたばかりのタイブレークルールは、この時点で丸ごと不要になった。

コミット時刻を見返すと、この3つは同じ日の23時36分から翌0時56分までの1時間半足らずに収まっている。「動くものを一旦作る→使い勝手を確かめる→すぐ作り直す」というサイクルが、書いたコードを説明のためだけに残さず、その場でどんどん壊しながら進んだ回だった。

まとめ

TODO管理を2ファイルに分けるという入り口の変更が、ダッシュボード側の「次にやるべきこと」欄の設計をその日のうちに2段階見直させることになった。最初に書いたタイブレークルールは短命に終わったが、無駄だったとは思わない。「横断で1件」を実際に動かしてみたからこそ、「それぞれ1件ずつ」の方が良いと数時間で判断できた。TODOの置き場所が増えた分、ダッシュボードを開けば開発タスクと生活タスクの両方が一目でわかるようになったのは、素直に便利になったと思う。