チームで karasu を試す：試用セッションの台本

English · 日本語（このファイル）

開発チームと 60 分で karasu を試すための台本です。確かめたいのは、同じモデルを見るとチームの理解の食い違いが見つかり、話し合いが変わるかです。 karasu の説明会ではないので、使い方は教えず、うまくいかなかったこともそのまま記録します。

人

進行役（1 人）：時間を見て問いを出す。操作の質問には、参加者が止まって進めないときだけ答える。
記録役（1 人）：気づいたことをメモする。名前ではなく「リード」「加わって 3 か月」のように役割で書く。
参加者（3〜6 人）：同じシステムに関わる人。詳しい人と加わって日の浅い人が混ざると、食い違いが見つかりやすい。

準備

話題を 1 つ決める。 チームが近いうちに判断する設計の問いを選びます（例：このサービスを分けるか、この DB はどのチームが持つか）。
自分たちのシステムのモデルを用意する。 話題に関わる範囲だけでかまいません。AI エージェントでリバースするかサービスとチームの境界を設計するを手がかりに書きます。用意できなければ手順 3 は飛ばし、当日の 2 では予想を書いたあと、モデルの代わりにホワイトボードで答えを並べて話します。
共有リンクを作る。 モデルを開いて Share を押し、プライベートリンクをコピーします。
- リンクにはモデルそのもの（スタイルも含む）が埋め込まれていて、karasu にモデルが保存されるわけではありません。プライベートリンクのモデルは URL の # より後に入り、ブラウザはこの部分をサーバーに送らないので、karasu のサーバーにも届きません。
- リンクを知っている人は誰でもモデルを見られます。社外秘のモデルなら、チームの中のチャットにだけ貼ります。

当日の流れ（60 分）

目安	段
15 分	1. 導入と初回体験
25 分	2. 自分たちのシステムで
10 分	3. ふりかえり
10 分	予備

押したときは、2 の「話す」を短くします。

1. 導入と初回体験（15 分）

今日確かめたいのはツールの出来ではなく、同じ図を見ながら話すとチームの話し合いが変わるかどうかです。正解はありません。つまずいたところがいちばん知りたいことなので、そのまま声に出してください。

Chrome か Edge のプライベートウィンドウで karasu.kompiro.dev を開き、「サービス分割を設計する」を選んで、パネルに沿って最後まで一人で進めてください。

プライベートウィンドウにするのは、Welcome が初めて開いたときにしか出ないためです。Welcome が出なければ、コマンドパレット（Ctrl/Cmd+Shift+P）の Show Welcome… で開けます。進行役と記録役は口を出さず、どこで止まったか、何を声に出したかをメモします。

2. 自分たちのシステムで（25 分）

予想を書く。 モデルを見せる前に、話題に関わる問いを 1〜2 個出し、各自がメモに答えを書きます（例：〇〇サービスが止まると、どこが困るか）。
モデルを見る。 進行役が画面を共有してモデルを開き、各自の答えと並べます。違いがあったら記録します。どちらが正しいかは決めません。
話す。 プライベートリンクをチャットに貼って各自で開いてもらい、準備で決めた話題を話してもらいます。進行役は口を挟まず、記録役は図のどこを指して話したかと、理解が変わった発言をメモします。

3. ふりかえり（10 分）

記録役が見つかった食い違いを読み上げたあと、一人ずつ答えてもらいます。

今日のセッションで、自分たちのシステムやチームについて分かったことを 1 つ挙げてください。

最後に、モデルを続けて使うかを決めます。続けるなら、モデルのファイルをチームのリポジトリに置くよう勧めます。共有リンクは見るためのもので、開いた人が直しても元のモデルには戻らないためです。

終わったあと

当日中に短いアンケートを送ります。

つまずいたところはありましたか？
これまで気づかなかったシステムの関係に気づきましたか？
チームで使いたいと思いましたか？思ったなら、どの場面でですか？
使い続けるとしたら、何が止めそうですか？

2 週間後に聞きます。

あれからモデルを開きましたか？直しましたか？直すのに何分かかりましたか？
使わなかったなら、その理由は何でしたか？

感想や不満は GitHub Discussions の Feedback カテゴリでも受け付けています。共有リンクにはモデルそのものが埋め込まれているので、社外秘のモデルの共有リンクは貼らないでください。