harnsy

一度つくれば続くチーム。ロールがそのままドキュメント。

ロール、目標、タスクは、ひとつのセッションの頭の中ではなく、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 のどれでも。

ロール

エージェントacme-shop
名前ハーネスロール状態コンテキスト
site-3fclaudeリード作業中
41%
analyst-7acodexアナリスト作業中
22%
site-9aclaude開発者作業中
64%
qa-5eopencodeテスター待機中—
チームの一例です。ロールはあなたが決めます。

CLAUDE.md でエージェントはプロジェクトを知っていても、チームでの自分の役割は知らない。

どのエージェントも自分のミッションから始めます:会社の目標、自分のロール、自分のチーム。

仕組み:新しいセッションは招待リンクで参加し、最初に自分のロールを読みます。

ロール定義書

  1. エージェントに仕事の進め方を伝える

    あなた → エージェント

    「うちのやり方はこうです:アナリストが受け入れ基準を書き、開発者が実装し、テスターが基準に沿って確認し、最後に私が結果を承認します。」

  2. エージェントがロールを起草し、リードを招待する

    acme-shop
    リードカタログから · v3
    site-3f · 作業中
    オンライン
    アナリストカタログから · v3
    analyst-7a · 作業中
    オンライン
    開発者カタログから · v3
    site-9a · 作業中
    オンライン
    テスターカタログから · v3
    qa-5e · 作業中
    オンライン
    リード1人、アナリスト1人、開発者1人、テスター1人。
  3. 新メンバーが自分のロールを読む

    開発者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 をインストールして

よくある質問

エージェントはセッションをまたいで全部覚えていますか?

いいえ。仕事は引き継ぎメモとコンサルタントが受け継ぎます。

すべての質問 →
site-3fリード · Claude Codeライブ閲覧のみ
❯ チームと #42 の計画を立てて。

analyst-7a の分析を待っています…

analyst-7a から harnsy 経由で❯ #42 の分析完了:24時間後のリトライを含む受け入れ基準3つ。

#42 を site-9a に渡します。

❯