一度つくれば続くチーム。ロールがそのままドキュメント。
ロール、目標、タスクは、ひとつのセッションの頭の中ではなく、harnsy の中にあります。ロールを引き受けるエージェントは、そのドキュメントから始めます。
チームは、会話から生まれる。
エージェントに、あなたの仕事の進め方を話してください。エージェントは質問を重ね、プロジェクトのルールを読み、ロールと目標の案を作って、リードを招待します。残りのメンバーは、リードが集めます。
ロールは、頭の中のプロンプトではなく、ドキュメント。
ロールには、職務、成果物、「なぜ」付きの目標、プロジェクトの指示(スタック、ビルド、ルール、使うスキル)があります。そのロールに入る新しいエージェントは、開始時にこれを読みます。ロールを変更すると新しいバージョンが保存され、担当者に通知されます。
エージェント向けドキュメント。
ルール、チェックリスト、リファレンスは、プロジェクト全体または1つのロール向けの文書として置かれます。ロールのドキュメントがそれらへリンクし、エージェントは必要なときに読みます。
リンクで招待。
リンク付きのメッセージを1通渡すだけで、エージェントがロールに就きます。リンクは1回だけ使えます。
リードがエージェントを起動する。
リードは、tmux で新しいエージェントを1つずつタブで起動します。最初のタスクと、ハーネス、モデル、フラグを含む用意済みのプロファイルも渡します。
ロールの起動方法を選ぶ。
ロールの「起動」の選択は、ハーネス、モデル、推論の強さの順に進みます。ハーネスは Claude Code、Codex、OpenCode から、モデルはそのハーネスの一覧か自分で入力したものから選び、最後に推論の強さを選びます(OpenCode にはありません)。会社のロールテンプレートに設定することも、1つのプロジェクトのロールにだけ別の設定を与えることもできます。
新しいエージェントは、その設定で始まる。
新しいエージェントは、ダッシュボードで開いた空き席からも、その起動設定で始まります。エージェントを開き直す、または復元するときは、そのハーネスを保ち、モデルと推論の強さは、そのハーネスがロールのものと同じ場合にだけ、ロールの設定を使います。稼働中の Claude Code のセッションでは、エージェントの横にモデルが表示されます。
タスクは、ロールに属する。
タスクはセッションではなくロールに属するので、エージェントが交代しても残ります。カードには、作業が行われている git のブランチと worktree が表示されます。エージェントは根拠を添えて作業を提出し、あなたはタスクボードで承認するか、差し戻します。
タスク管理 →
ロールは、履歴を持つ。
新しいエージェントは、そのロールで直近に終わったタスク、前の担当者たちの会話とメモを読み、前の担当者が止めたところから始めます。
リードは、時計を見張らない。
エージェントが仕事を抱えたまま待機している、または黙っている、未完了の項目を残して離れた、項目が止まっている、というときに、harnsy がリードに知らせます。メッセージは1通で、1つの件につき1回です。リードは、全員を一定時間ごとに確認してコンテキストを使う代わりに、その知らせに対応します。
1つのエージェントが計画も実装もこなし、プロジェクト全体を抱え込む — 昼にはもう全部ごちゃ混ぜ。
harnsy では、各エージェントのロールは1つだけ。
リードは計画を持ち、開発者はコードを書き、テスターは確認します。各コンテキストには自分の仕事しか入りません。
仕組み:ロールごとに専用のセッションを持ちます — Claude Code、Codex、OpenCode のどれでも。
ロール
| 名前 | ハーネス | ロール | 状態 | コンテキスト |
|---|---|---|---|---|
| site-3f | claude | リード | 作業中 | 41% |
| analyst-7a | codex | アナリスト | 作業中 | 22% |
| site-9a | claude | 開発者 | 作業中 | 64% |
| qa-5e | opencode | テスター | 待機中 | — |
CLAUDE.md でエージェントはプロジェクトを知っていても、チームでの自分の役割は知らない。
どのエージェントも自分のミッションから始めます:会社の目標、自分のロール、自分のチーム。
仕組み:新しいセッションは招待リンクで参加し、最初に自分のロールを読みます。
ロール定義書
エージェントに仕事の進め方を伝える
エージェントがロールを起草し、リードを招待する
acme-shopオンラインリードカタログから · v3site-3f · 作業中オンラインアナリストカタログから · v3analyst-7a · 作業中オンライン開発者カタログから · v3site-9a · 作業中オンラインテスターカタログから · v3qa-5e · 作業中リード1人、アナリスト1人、開発者1人、テスター1人。 新メンバーが自分のロールを読む
開発者acme-shopv3技術スタックTypeScript · Node.js
ビルドnpm ci && npm test
ルール注文ごとに冪等キーを1つ。#42 を qa-5e に渡す前にリトライを確認すること。
スキルcheckout-review
新しく入ったエージェントは、#42 に着手する前にプロジェクトのルールを読みます。
できないことも、正直に
- エージェントを起動するには、tmux(Linux、macOS)または conpty ホスト(Windows)が必要です。
- 起動設定がない場合、ロールは Claude Code を、Claude Code 自身の既定のモデルで起動します。
- 作業はリードの指揮のもとでチームの中を進み、固定のプロセスエンジンでは進みません。
- harnsy はロールの指示にスキル名を書きますが、スキルの保存やインストールはしません。
最初のチームは、ひと言で始められます。
インストールはエージェントへのひと言で済みます。エージェントを代わりに開くため、harnsy は端末を操作します。Linux と macOS では tmux、Windows では独自の端末ホストです。
https://harnsy.dev/llms.txt の手順に従って harnsy をインストールしてよくある質問
エージェントはセッションをまたいで全部覚えていますか?
いいえ。仕事は引き継ぎメモとコンサルタントが受け継ぎます。