コーディングタスク
コーディングボードは、書いたブリーフを、望むだけ少ない手間でマージ済みコードへと変えます:必要なものを書き、インタラクティブなプランニングエージェントで Plan(レビュー可能なフェーズに分解)するか One shot で一気に片付け、エージェントが自身の git worktree で作業するのを見守り、行に固定されたコメントで diff をレビューし、マージします。各ステージは 1 列、各タスクは 1 枚のカードです。
サイドバーは上部近くに細い TASKS セクションを保ちます — パルス行がボードを要約し(9 件計画済み · 1 件進行中 · 2 件レビュー待ち)、Testing/Review で待機中のカードを数えるオレンジのバッジと、エージェントがあなたの入力を必要とするときの赤いバッジが付きます。セクションタイトルまたはその行をクリックするとボードが開き、どこからでも ⇧⌘T でも開けます。
| 列 | そこに置かれるもの |
|---|---|
| Backlog | 書いたがまだ開始していないブリーフ。各カードは Plan と One shot を提示します。 |
| Plan | プランニングエージェントがブリーフからファイルしたフェーズカード — 番号付き、依存関係を意識、複数選択可能。 |
| In Progress | エージェントが実際に作業中のフェーズおよび One shot タスクで、それぞれ独自の worktree にあります。 |
| Testing/Review | あなたを待つ完了済みの作業:カードはブランチの diff を表示するレビューウィンドウを開きます。 |
| Done | マージ済み、プルリクエスト化済み、またはマージせず閉じられたタスク。 |
このページのすべては、リモートのリッチクライアントからも同一に機能します — ボード、プランニングウィンドウ、レビューウィンドウはすべて制御 API 経由でミラーリングされます。
タスクを書く
+ 新規タスク(またはバックログカードをクリック)でエディタが開きます:
- タイトル と、Markdown で書く 説明、そして 編集 / プレビュー の切り替え。ブリーフはエージェントのプロンプトになるので、そのつもりで書きましょう。
- ワークスペース と エージェント — タスクは選んだワークスペース内で、その設定済みエージェントの 1 つで実行されます。
- エージェントを開始する場所 — ワークスペース内のフォルダ。そこ自体が git リポジトリであれば、タスクはそこで新しい worktree とブランチで実行されます。
- 必要ならフォルダと git リポジトリを作成 — 新規開発向け:フォルダがまだ自身のリポジトリでない場合、開始または計画はまず
mkdir+git init(空のルートコミット付き)を実行します。既存リポジトリ内のフォルダではオフのままにします。
Backlog のブリーフは 2 つのボタンを提示します:
- One shot はタスクをそのまま In Progress に送ります:エージェントが全体を自律的に行い、Testing/Review で diff を手渡します。
- Plan はまずプランニングセッションを開きます。
プランニング
Plan は 可視でインタラクティブな プランニングセッションを起動し、そのウィンドウを開きます — ネイティブの会話ビューで、ターミナルは不要です。セッションはカードとしてレンダリングされた あなたのブリーフ で開きます。エージェントはリポジトリを読み取り専用で探索し、見つけたことを語り、ブリーフに本当の選択の余地があるときは質問します。
質問は タブ付きカード として届きます — 質問ごとに 1 タブで、エージェントが自身のセッションで見せるピッカーを正確に反映します。回答はローカルに収集され、送信 を押すまで編集可能で、押すと一式が一度に送られます。誤クリックが最終になることはありません。ウィンドウ下部のコンポーザーに自由形式の回答を入力することも、ターミナルを開く で生のセッションを見ることもできます。
エージェントが必要なものを得ると、プランをボードにファイルします — Plan 列に順序付けられた フェーズカード で、各々がおおよそレビュー可能な 1 プルリクエスト分の作業、相互に依存関係を持ち — そしてプラン概要を記録します。ウィンドウは次にフェーズ数とともに プランの準備完了 と 閉じる ボタンを表示し、プランニングセッションのタブは自らを閉じ、ブリーフは Backlog を離れます(そのフェーズが取って代わります。すべて削除すると戻ってきます)。
プランニングは監視されています:ワークスペースが再起動したり、エージェントが終了させられたり、フェーズがファイルされる前にセッションが死んだりすると、カードのスピナーは無限に回り続ける代わりに具体的な理由 — Plan をクリックして再試行 — で終わります。
Plan 列
フェーズカードはプラン順に番号付けされ、次を持ちます:
- フェーズが先に以前のフェーズの Done を必要とするときの 依存バッジ(フェーズ番号付きの錠前)。
- 依存関係が終わる前に開始したときの キュー済み バッジ — それらがすべて Done になった瞬間に自動的に開始します。
- 親ブリーフの名前。
チェックボックスで複数のフェーズを選択すると選択バーが現れます:選択した N 件を開始 は各々を One shot し(依存でゲートされたフェーズはキューに入ります)、クリア は選択を破棄し、削除 は 1 度の確認で選択全体を取り除きます。フェーズを編集するとその 依存先 リストが表示されます — 各兄弟フェーズにチェックボックスが付き、依存関係を手作業で作り直せます。
フェーズは 完全に自律的に 実行されます — 一度開始すると、インタラクティブな入力は期待されません。
In Progress
開始したタスクは、必要ならワークスペースを起動し、リポジトリの新しい worktree を作成し、ブリーフをプロンプトとしてエージェントを起動します。カードはライブのエージェント状態ドット、開始時刻、そしてエージェントが質問でブロックされている場合は赤で あなたの入力が必要 を表示します — カードをクリックするとライブセッションへ飛びます。サイドバーの TASKS バッジがこれらを数えるので、見逃すことはありません。
エージェントが完了を報告すると、タスクは Testing/Review へ移り、そのターミナルタブは自ら閉じます — 終わったセッションがタブストリップに居座ることはありません。代わりにエージェントがクラッシュした場合、カードは作業しているふりをせず赤くなります。
Testing/Review
Testing/Review カードは レビューウィンドウ を開きます:ブランチの親に対するフル diff を VM からライブで読み、ファイルごとの開閉、追加/削除数、そしてエージェントが記録した任意のプランを表示します。
プルリクエストのようにレビューします:
- 行コメント:追加行またはコンテキスト行にホバーしてマージンの吹き出しをクリックすると、そのちょうどその行にコメントを付けられます。固定されたコメントは各行の下にレンダリングされます。ファイルレベルおよび全般のコメントも機能します。
- In Progress に差し戻す は、下書きした各コメントをエージェントに届けます —
foo.jsの 196 行目:別のメソッドを使う のように整形され — タスクはもう一巡のため In Progress へ戻ります。エージェントは同じ worktree とブランチで再開します。 - マージ — 分割ボタンの既定は親ブランチへマージします。長押しで Squash & Merge、プルリクエストを作成…(ワークスペースに GitHub トークンがあるとき)、または任意の他ブランチへのマージ。クリーンなマージは自身のターミナルタブを閉じます。競合は代わりに解決セッションを開きます。
- マージせずに閉じる はその一巡を破棄しつつ、記録を Done に残します。
ヒント: 同じ行コメントのワークフローはボードの 外 にも存在します:アクティブなタブがコーディングエージェントを実行しているとき、ファイルエクスプローラの diff ペインに同じマージンの吹き出しが生え、エージェントに送信 はあなたのコメントをそのセッションへ直接まとめて送ります — タスクを一切作らずにコードレビューができます。
カードを取り除く
各カードはホバーで ✕ が生え(そして ボードから削除 のコンテキストメニュー項目も)、確認の背後にあります。実際の作業を伴うカードには、ダイアログが選択肢を提示します:エージェントを停止して worktree を削除(In Progress)または worktree とブランチを削除(Testing/Review)はすべてを取り壊し、カードのみ削除 はセッションとチェックアウトをワークスペース内でそのまま残します。
ストレージと API
タスクはワークスペースストアの隣の 1 ファイルに、アトミックな書き込みと ISO-8601 の日付で永続化されます:
~/Library/Application Support/BromureAC/tasks.json
ボード全体は、リッチクライアントやスクリプトのためにアプリの制御ソケット上でミラーリングされます:
| エンドポイント | 目的 |
|---|---|
GET /tasks | すべてのタスクを一覧表示。 |
POST /tasks | タスクドキュメントを作成または更新(upsert)。 |
POST /tasks/<id>/start | 開始する(worktree + エージェント)。 |
POST /tasks/<id>/plan | プランニングセッションを起動。 |
POST /tasks/<id>/comment | レビューコメントを追加(text、任意で file と line)。 |
POST /tasks/<id>/send-back | 未送信のコメントを届け、タスクを In Progress に戻す。 |
POST /tasks/<id>/merge | マージ(squash、任意で target)。 |
POST /tasks/<id>/open-pr | マージの代わりにプルリクエストを作成。 |
POST /tasks/<id>/to-testing, /to-in-progress | 手作業で移動。 |
POST /tasks/<id>/destroy | エージェントを停止し、worktree とブランチを削除し、カードを取り除く。 |
DELETE /tasks/<id> | カードのみを取り除く。 |
内部的には、プランニングエージェントとタスクエージェントは、セッションごとの ボード MCP サーバー(vsock、ホスト側)を通じてボードに応答します:board_get_task、board_set_plan、board_create_subtasks、board_ready_for_review が、フェーズがどうファイルされ、完了したタスクがどう自らを知らせるかの手段です — ポーリングもスクレイピングもなし。ツールは対応する各エージェントに自動的に配線されます:Claude Code はブランチごとの MCP 設定を読み込み、Codex は呼び出しごとの mcp_servers オーバーライドを受け取り、Grok はセッションのチェックアウトに書き込まれた(そしてその diff からは除外される)プロジェクトスコープの .grok/settings.json を読みます。