BiBrain ユーザーマニュアル
BiBrain はチームのコラボレーションを1本の主線に収束させます：チーム → 目標 → タスク。AI が手を出すのは3か所だけ——目標の分解、タスク1件の実行、チームボードの作成です。それ以外の画面は「見る」と「確認する」だけを担います。チームの資産はすべてチーム自身の git リポジトリに保存され、いつでも clone して中身を確認できます。
読む順番
マニュアルは浅いところから深く、4つの層で構成されています。第1層は5分、第2・3層は必要に応じて参照、第4層は障害対応とカスタマイズ向けです。
- 第1層 · まず動かす（このページ）：BiBrainとは、5分で始める、画面マップ
- 第2層 · 日常の使い方：チームホーム、目標とタスク、会話、共有スペース、ソース管理、チーム振り返り、チーム設定
- 第3層 · 慣れてきたら：レイアウト・パネル・コマンドパレット、ショートカットキー一覧、同期4モードとコンフリクト、分解ノブとリポジトリ反映、タスク状態マシンとガード、会話の上級操作、プロンプトテンプレートとプロファイル、サブリポジトリのマウント、チーム横断
- 第4層 · 内部モデル：真実はどこにあるか、リポジトリのディレクトリ規約、task-graph.json、データはどのマシンに置かれるか
- 付録：トラブルシューティング早見表、このバージョンでできないこと、用語集
BiBrainとは
3分でメンタルモデルを作ります。この節の4つの判断基準を押さえれば、以降の混乱の8割は省けます。
1本の主線
チーム → 目標を立てる → AI が目標をタスクに分解 → 人または AI がタスクを実行 → 成果物が共有スペースに入る → 振り返ってチーム振り返りを見る
各段階は、画面左のアクティビティバーのアイコン1つに対応します。機能が見つからないときは、まず「この主線のどの段階の話なのか」を自分に問いかけてください。
4つの判断基準
1 · チームのすべてが1つの git リポジトリにある
タスク構造、タスク状態、ドキュメント、成果物、会話アーカイブ、ボード——すべてこのリポジトリ内のファイルです。ブラックボックスのデータベースではありません。git clone して、どんなエディタでも開けます。クライアントはあなたのマシンに作業コピーを1つ保持します（デフォルトは ~/.sdw/shared-team/<チーム id>）。
2 · AI はファイルを書くだけ。反映するかどうかはあなたがクリックする
Agent が目標を分解し、タスクを実行し、ボードを生成した結果は、すべて作業コピー内の未コミットの変更です。あなたがレビューしたうえで自分でコミット・プッシュします。AI が代わりに commit することは絶対にありません——これは設定項目ではなく、ハードな制約です。
3 · BiBrain は独立したウィンドウ
AIKO メインウィンドウとは別に、2つのウィンドウ・2つのUIがあります。ログイン状態とモデル設定はメインウィンドウから引き継がれますが、チームコラボレーションの作業はすべて BiBrain ウィンドウで行います。メインウィンドウにある旧「チーム」画面とは無関係です。
4 · 画面は VS Code の形
一番左がアクティビティバー（どのビューにいるかを切り替える）、中央がサイドバー（そのビューのナビゲーションツリー）、右がエディター領域（ドラッグ・分割・クローズできるタブ）です。VS Code が使える人ならそのまま使えます。使えなくても大丈夫、下の「画面マップ」に完全なマップがあります。
入口
AIKO メインウィンドウのトップバーで B アイコンをクリックすると BiBrain ウィンドウが開きます。このアイコンが見えない場合は、設定 → ラボ で 「新版 BiBrain」 をオンにしてください。B アイコンの緑の点は、BiBrain ウィンドウが起動中であることを示します。
5分で始める
ゼロから「AI が最初のタスクを終わらせてくれた」まで。各ステップに、画面のどこにあるかを明記しました。
BiBrain に入る
AIKO メインウィンドウのトップバー → B アイコン。初回は新しいウィンドウが開き、2回目以降はクリックでそのウィンドウに切り替わります。
チームがあるか、チームを作るか
サイドバーの一番上がチーム切り替えです。すでにチームに招待されていればそのまま選びます。なければ道は2つ：
- AI と一緒に編成する（おすすめ）——やりたいことを一言伝えると、組織名簿を調べて役割と現在の負荷から候補を推薦し、右のフォームへリアルタイムに入力します。いつでも修正できます。
- 自分でフォームを埋める——チーム名、公開範囲、コラボレーションモード、メンバーと役割。
他の人から招待リンクをもらった場合は、チーム管理ページでリンクを貼り付けて参加します（リンクには「直接参加」と「承認が必要」の2種類があります）。
チームを作成すると、サーバー側が自動的に git リポジトリを1つ開き、AI が使う作業規程（skill）を中に入れます。
作業コピーの接続を待つ
チームに入ると、クライアントがチームリポジトリを自動的にローカルへ clone します。トップバー右の同期ボタンに進捗が表示されます。初回 clone は少し待つことがあります。接続できるまで共有スペースのファイルツリーは空ですが、これは正常です。
ディレクトリを変えるには：チーム設定 → ベースライン機能 → Git リポジトリ。
目標を立てる
アクティビティバーの 目標とタスク → 上部タブ「目標ブラウズ」→ 新規目標。何を達成したいのか、いつまでに必要なのかを明確に書きます。
AI に目標をタスクへ分解させる
目標の「分解」をクリックすると目標分解会話に入ります：左で AI と話し、右で分解されたタスク図（DAG / Raw JSON の2ビュー＋進化履歴）をリアルタイムに確認します。
- 細かすぎる・粗すぎる → 分解粒度スライダーを調整してもう1ラウンド
- タスク間の接続線が多すぎる・少なすぎる → 依存密度を調整
- あるタスクのタイトル・成果物・工数を変えたい → 右のフォームで直接修正すれば、AI は次のラウンドでそれを読み取ります
分解結果は、作業コピー内にある未コミットのファイルです。問題ないと確認して「反映を確認」をクリックすると、初めて commit + push されてチーム全体に共有されます。
割り当てとステータス遷移
「タスクブラウズ」タブに切り替えます：ボードはカードをドラッグして状態を変更、リストでまとめて確認、関係図で依存チェーンがどこまで進んだかを見ます。
自分のタスクのステータスを進められるのは担当者だけです。担当者が未指定のタスクは、まず割り当てが必要です。オフラインでもドラッグできます——変更はまずローカルに記録され、ネットワーク復帰後に自動同期されます。
AI にタスクを1件実行させる
タスクカードの「実行」をクリックするとタスク実行会話に入ります：左が対話、右には生成されたファイルと上流依存が何を出したかがリアルタイムで並びます。
Agent はチーム共有スペースの既存資料を自分で調べられるので、コンテキストを貼り直す必要はありません。完了を自己申告すると、タスクは**「レビュー中」**に進んで目標担当者へ引き継がれます——いきなり「完了」にはなりません。受け取り確認は常に人の作業です。
チームへコミットする
アクティビティバーの ソース管理：左に変更がすべて並ぶので、1件ずつ diff を見て、コミットするものにチェックを入れ、コミットメッセージを書いて ⌘/Ctrl+Enter でコミット＆プッシュ。
またはトップバーの同期ボタンで「変更を同期」（プレビュー → プル＆マージ → プッシュ）を一発実行。
チームの動きを見る
チームホーム：期間サマリー、目標進捗、ステータス分布、メンバー負荷、チームアクティビティ、履歴アーカイブ。
チーム振り返り：見たいものを AI に伝えると、自己完結型の HTML ボードを1枚生成してチームリポジトリに保存します。公開すればチーム全員が開けます。
画面マップ
1つの表ですべての入口を把握します。アクティビティバーが唯一の一次ナビゲーションです——アイコンを1つクリックすると、サイドバーのコンテンツの種類がまるごと入れ替わります。
ウィンドウの4ブロック
| 領域 | 何が入るか | 重要な挙動 |
|---|---|---|
| トップバー | 検索ボックス · 同期ボタン · ＋新規作成 · 通知 · アバター | 検索は Enter で目標センターへジャンプ。同期ボタンはスプリットボタン（左半分が実行、右半分▾でモード切替）。アバターメニューには「マイワークベンチ / マイプロファイル / チーム管理 / AIKOに戻る」 |
| アクティビティバー （最左の細い帯） | 7つのビューアイコン | すでにアクティブなアイコンをクリック＝サイドバーを折りたたむ。ドラッグで並び替え、右クリックで非表示にできる（チーム設定は一番下に固定、ドラッグも非表示も不可） |
| サイドバー | チーム切り替え → ＋新規会話 → 現在のビューのナビゲーションツリー → ユーザーカード | 幅をドラッグで変更可。各セクションは折りたため、折りたたみ状態は再起動後も記憶される |
| エディター領域 | ドラッグできるタブ（ファイル、diff、会話、ターミナル…） | ドラッグでドッキング、分割、クローズ。レイアウトは再起動後も保持 |
7つのビュー
| アイコン | ビュー | サイドバーに出るもの / メイン領域に出るもの |
|---|---|---|
| ⌂ | チームホーム dashboard | サイドバー：マイワーク（担当 / 作成 / 提出 / 全チーム）、クイックアクセス メイン領域：期間サマリー、目標リスト、ステータス分布、メンバー負荷、提供ペース、チームアクティビティ、履歴アーカイブ |
| ◎ | 目標とタスク work | サイドバー：目標ツリー（展開してタスクを表示） メイン領域の4タブ：目標ブラウズ / タスクブラウズ / マイタスク / メンバー分布 |
| 💬 | 会話 chat | サイドバー：会話履歴ツリー（種類 → 対象 → メンバー → 会話） メイン領域：会話タブ、複数同時オープン可 |
| 🗂 | 共有スペース space | サイドバー：ファイルツリー（⌘/Ctrl+P のクイック検索付き） メイン領域の9タブ：概要 / 要件 / ドキュメント / 目標とタスク / 会話記録 / 成果物 / AIアセット / 同期記録 / 変更 |
| ⑂ | ソース管理 git | サイドバーの3セクション：ソース管理（コミットボックス＋グループ化された変更リスト）、サブリポジトリ、コミットグラフ メイン領域：リポジトリ概要（ブランチ、ahead/behind、コンフリクト、最近のコミット、同期モード） |
| ▤ | チーム振り返り review | サイドバー：ボードライブラリ（マイ / メンバー別） メイン領域：ボードカードの壁＋内蔵「チーム運用概要」。右側はボードプレビューパネル |
| ⚙ | チーム設定 settings | サイドバー：設定セクションツリー メイン領域の5タブ：ベースライン機能 / シーンプラグイン / プロファイル / メンバープロファイル / プロンプト |
これを覚えておく
共有スペースは「ファイルを見る」場所、ソース管理は「変更とコミット」の場所です。2つのビューは同じ作業コピーを読みますが、変更リストの操作はソース管理だけで行います——わざと2か所に置いていません。