すべてのAIコーディングエージェントは忘れてしまいます。Claude Codeのセッションを閉じて、翌朝に開き直すと、モデルはあなたがどの機能の途中で止めていたのかまったく分かりません。チームは通常、LinearのボードやNotionページでこれを補っていますが、どちらもリポジトリの外側にあり、エージェントが信頼性に欠ける（場合によってはまったく到達できない）APIの背後にあります。Trackboiは別の賭けに出ます。すべてのタスクを、プロジェクト内にコミットされたプレーンなマークダウンファイルとして保存し、コーディングエージェントがすでに完全な読み書き権限を持つ場所に置くのです。
実際のコーディングエージェントがボードを動かす状況でも、「データベースとしてのマークダウン」が成り立つのか、プロジェクトを掘り下げて検証しました。
Trackboiとは実際に何か
Trackboiは、データベースを持たない、ホスティングされたダッシュボードもない、稼働し続ける別アプリもないオープンソースのカンバンツールです。ボードはリポジトリ内のマークダウンファイルの集合です。各タスクはファイルとして表され、そのステータス（バックログ、作業中、完了）は外部システムではなく、ファイル自体に記録されます。タスクをボード上で移動するとは、テキストを編集してコミットすることを意味します。
この設計には、即座に現れる結果が1つあります。ボードはコードとまったく同じようにgitでバージョン管理されます。ステータス変更はすべて差分（diff）になります。完了したタスクには、コミットログに著者とタイムスタンプが残ります。別途の同期ステップもなく、矛盾を調整する必要もありません。なぜなら、ボードは「真実のコピー」ではなく「真実そのもの」だからです。説明しているコードと隣り合う場所のgitに、そのまま存在しています。
人間にとっては、それは少し便利です。AIエージェントにとっては、失敗のまるごと1カテゴリを取り除きます。エージェントは、何に取り組むべきかを学ぶのに、MCPサーバー、OAuthトークン、壊れやすい画面スクレイピングを必要としません。ファイルを読みます。リポジトリ内の他のものを読むのと同じやり方で。
エージェントの引き継ぎで、プレーンなマークダウンが勝つ理由
提案が刺さるのは、タスクの途中でエージェントが糸を失うのを見たことがある場合だけです。ファイルベースのタスク追跡が解決するのは次の点です：
壊れるための統合がない。 すべてのコーディングエージェント—Claude Code、Cursor、Codex—は、すでにファイルを開き、検索し、編集できます。ファイルから作るトラッカーなら、アダプタ用のコードはゼロです。SaaSのボードにエージェントをつなぐと、APIの変更により、静かに壊れるのは「ちょっとした1回の変更」の距離です。
ボードはgrepできる。 起動直後のエージェントは、タスクリストのディレクトリを検索するだけで、1ステップで状態を復元できます。何が作業中か、何がブロックされているか、最後に何が出荷されたか。ページネーションも、レート制限も、認証の面倒な手続きもありません。
Gitの履歴が監査証跡になる。 2つのエージェント—あるいはエージェントと人間—が行き来するような場合でも、コミットログはすでに「誰が、どのタスクを、いつ変えたか」を記録しています。差分のうち機械によって書かれる割合が増えるほど重要になる、由来（プロヴェナンス）を、手間なく手に入れられます。
AGENTS.mdに組み込める。 AGENTS.mdという慣習では、リポジトリのルートに単一の指示ファイルを置き、準拠したエージェントが行動する前にそれを読みます。ファイルベースのボードはその自然な相棒です。AGENTS.mdにタスクディレクトリを指し示し、作業完了の一部としてタスクのステータスを更新するようエージェントに伝えます。指示と作業キューが同じツリー上に、同じ形式で存在します。
AGENTS.mdに1行追加してください：「開始する前に、オープン中のタスクを読み; 終了したら、タスクをdoneへ移動してコミットする。」このたった1つの指示によって、アドホックなチャットセッションは、再開可能なワークフローに変わります。次のエージェント実行は、あなたの記憶からではなくボードから始まるのです。
正直な反対意見もあります。マークダウンのボードにはライブのUIがなく、通知もなく、バーンダウンチャートもありません。チームが、技術に詳しくない関係者が見ている共有のビジュアルボードで回しているなら、それは本当の損失です。Trackboiは、タスクがすでにgitリポジトリの中で生まれ、埋もれているような人々のために作られています。
Trackboi と Vibekanban
どちらのツールも「AIエージェントにタスクボードをどう渡すか」という問いに答えますが、逆の方向から答えています。
Vibekanbanはアプリです。あなたがそれを起動すると、エージェントの実行をディスパッチし、監督するためのカンバンUIが返ってきます—多くの場合、複数を並行して行います。ボードは、あなたが見守るための操作面（コントロールサーフェス）です。Trackboiはファイル形式です。起動するアプリはありません。ボードとは、あなたのエディタとgitがすでに表示しているものそのものです。ボードは、コミットするデータ構造です。
どちらが厳密に優れているわけではありません。複数のエージェントを同時にオーケストレーションしながら、その作業を監視する日が多いなら、本物のUIを持つアプリが価値を発揮します。主に、1つのエージェントがきれいに中断・再開でき、さらにリポジトリの中に作業の経緯が残るようにしたいなら、ファイルベースの方式のほうが、壊れる要素が少なく、ホストするものもありません。
導入すべきか
Trackboiは若いプロジェクトで、「若いオープンソースツール」にはいつもの注意点が付きます。端のほうが荒い状態になることを想定し、依存する前に未解決のオープンイシューを読み、ファイル形式が固定されていると決めつけないでください。
ファイルベースのボードは、コミットが規律あるものの程度にしかなりません。エージェントがタスクを終えたのにファイルを移動（更新）しないなら、ボードは嘘をつきます—そして次のセッションは古い状態から始まります。ステータス更新を、エージェントの指示の中で明示的で、任意ではないステップにし、他の変更と同様にコードレビューで必ず取り込んでください。
とはいえ、核となるアイデアは健全で、特定のツールに強く結びついているわけではありません。エージェントの作業を、プレーンでコミットされたテキストとして追跡することは、エージェントがストロー越しにしか見られないシステムで追跡するよりも、より頑健です。仮にTrackboi自体をインストールしないとしても、「1つの作業単位につき1つのマークダウンタスクファイル」というパターン—差分（diff）の一部として更新する—は、エージェントが実際の作業を行うどんなリポジトリでも盗む価値があります。
もともとは pickuma.com で公開されました。新しいレビューは RSSを購読するか、@pickuma.bsky.social をフォローしてください。
