harnsy のしくみ

すでに Claude Code、Codex、OpenCode のどれかを使っているはずです。どれも単体ならうまく動きます。困るのは、複数を同時に動かすときです。あるエージェントが終えた作業が次のエージェントに必要で、あなたが手でコピーして渡します。自分のエージェントのあいだの郵便局になってしまい、時間が判断ではなく受け渡しに消えます。

harnsy はこれらのツールをつなぎます。あなたのマシンで動き、動いているセッションに直接メッセージを届けます。エージェントは、いま進行中のターンの中でそれを読みます。

harnsy では、あなたは責任者であり確認する人で、チームの一員ではありません。やりたいことを伝えると、リードのエージェントがそれを他のエージェントの仕事に分けます。ほかのエージェントが作業し、互いに確認し合います。あなたが関わるのは、何かがあなたを待っているときだけです：回答、許可、受け入れるか戻すかを決める結果。

話す相手はリードで、全員ではありません。大事なのは、結果が頼んだとおりになっていることです。

harnsy は、人がいなくても仕事が進むとは約束しません。難しいタスクでは、エージェントはまだ道を外れます。harnsy が提供するのは、あなたの時間をリードと、あなたが必要な場面に使えるようにする進め方です。

ハーネスとは、エージェントが動くツールのことです：Claude Code、Codex、OpenCode。harnsy は、すでにあるツールをつなぎます。置き換えはしません。各ツールがメッセージを受け取るために用意している方法だけを使います。権限はツール自身のものです。

各カードは、その言葉を使うモジュールと同じことを言っています。わからない言葉があれば、ここに戻ってください。

会社は全体像です。ロールのテンプレートを持っています。プロジェクトは、あなたが作業するフォルダです。チームは1つのプロジェクトフォルダに属します。ロールはチームの中の役割で、任務、目標、成果物を持ちます。

ロールは残ります。エージェントがロールに就きます。エージェントが交代しても、ロールは残ります。

つまり、仕事を運ぶのは、1つのセッションの記憶ではなく、指示、そのバージョン、書かれた引き継ぎメモです。これが「会社は残り、エージェントは変わる」という考え方です。

どのチームにも、いちばん上にリードのロールがあります。リードは仕事を割り振り、手が止まっている人や詰まっている人を見ています。あなたに聞くのは、自分で決められないことだけです。

エージェントはその下のロールに就きます。ロールには、しばらくのあいだ担当者が複数いることがあります：引き継ぎが終わるまで、後任が前任者の隣に座ります。

リードに知らせが届くのは、次のときです：

• エージェントが、未完了の仕事を抱えたまま止まっているとき；
• タスクが停滞しているとき；
• 担当者のコンテキストが上限に近づいているとき；
• 担当者が、未完了の仕事を残していなくなったとき。

リードはタイマーで見回ることはしません。

仕事はタスクで管理します。タスクはロールに属し、セッションには属しません。後任は、前任者が置いた場所でそれを見つけます。

タスクは New（新規）→ Taken（担当決定）→ In progress（進行中）→ In review（確認待ち）→ Done（完了）と進みます。待っているあいだは Blocked（保留）になることもあり（あなたを待つか、外部の何かを日付まで待つ）、Dropped（取り下げ）になることもあります。ひとりでに動くことはありません。だれかが動かします。

エージェントはタスクを提出するとき、要約と根拠を書きます。結果を判断するのは、頼んだ人です：受け入れるか、メモを付けて戻します。

ダッシュボードを一日中見ている必要はありません。呼ばれたときに開きます：トレイの通知、ベル、待ち、または失敗。対応したら、仕事に戻ります。

ダッシュボードはあなたのマシンの 127.0.0.1:7788 で動き、あなたのマシンからしか応答しません。

色はどこでも同じ意味です。琥珀色：人を待っている。緑：動いている。赤：失敗、または担当者がいない。青：操作。どの色にも、言葉か形が添えられています。

メッセージは、1人のエージェントへの短い一言で、動いているセッションに届きます。タスクは、担当者、状態、結果を持つ仕事です。引き継ぎは、書かれたメモです。前任者のコンテキストがいっぱいになったとき、新しいエージェントがロールを引き継げるようにします。

メッセージは何かを伝えます。タスクは何かを終わらせます。引き継ぎは、仕事を1つのセッションから次のセッションへ続けます。

エージェントは、名前を指定して別のエージェントにメッセージを送ります。harnsy は、受け取る側が動いているハーネスに、そのハーネス自身の方法で渡します。受け取る側は、最初のメッセージに結びついた返信で答えるので、1つの会話は1つの会話のままです。

バス上のものはすべて記録されます。だれがだれと話したかは、Messages タブと Links のグラフで見られます。

それぞれの経路を、それを表す説明に合わせてください。

だれかが判断すべき結果が必要なら、タスクにします。質問や事実なら、メッセージを送ります。知識を持つエージェントがもうすぐいなくなるなら、引き継ぎを書きます。

エージェントが一歩進むたびに、コンテキスト全体がもう一度送られます。そして、コンテキストには終わりがあります。ロールごとに引き継ぎのしきい値があります。担当者がそこに達すると、リードに知らせが届きます。

仕事が続くのは、次のエージェントがメモに従うからです。無限の記憶ではありません。harnsy には、いまのところ記憶の機能はありません。

6つのステップで、harnsy のインストールからリードへの最初の一言までを進めます。イニシエーターのエージェントが、あなたと一緒にチームを組み立てます。あなたが「はい」と言うまで何も保存しません。

キーなしの harnsy：1プロジェクト、同時に動くエージェント10、ほかのマシンなし。10を超える復元は何も開きません。

ロールのドキュメントは、エージェントが起動時に読むものです。任務、目標、成果物、最初に読むもの、リードがだれか、引き継ぎのしきい値、そして、その役割がこれまでに行ったことが書かれています。

会社のテンプレートが土台になり、プロジェクトがその上に自分の文章を足します。変更は新しいバージョンとして保存され、担当者に「任務が変わった」と知らされます。

harnsy は、ハーネスの権限を上書きしません。エージェントが何かの実行の許可を求めたり、あなたに質問したりすると、ベルがボタン付きで表示します。エージェントのターミナルを開かずに、そこで答えられます。琥珀色は、あなたを待っているという意味です。

タスクが In review（確認待ち）に届くと、頼んだ人が判断します。あなた自身の依頼なら、それはあなたで、タスクのカード上で行います。

質問は1つです。ダッシュボードを読み取れるかを確かめます。