From 80b86b15892476643e6911ff4dbe01cc6703d049 Mon Sep 17 00:00:00 2001 From: gotomts Date: Tue, 1 Sep 2026 00:53:35 +0900 Subject: [PATCH] =?UTF-8?q?docs(rules):=20=E8=B5=B7=E5=8B=95=E5=8F=AF?= =?UTF-8?q?=E5=90=A6=E3=81=AE=E5=88=A4=E5=AE=9A=E3=81=A8=20blocker=20?= =?UTF-8?q?=E5=A0=B1=E5=91=8A=E3=81=AE=E8=A6=8F=E7=AF=84=E3=82=92=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0=E3=81=99=E3=82=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit HERDR_ENV 未設定や bare shell での command 不在だけを根拠に worktree 作成・ Claude Code 起動を blocker として扱わず、login shell 上で正規コマンドを 実行して失敗を確認してから報告する。blocker 報告には失敗した正規コマンド・ 終了コード・代替経路の結果を必須とする。core の `command -v herdr` 確認も login shell 上で行うことを明記し、bare shell の PATH 不備と実際の異常を 区別する。 Co-Authored-By: Claude Fable 5 --- claude/AGENTS.md | 2 +- claude/hermes/SOUL.md | 9 ++++++++- claude/rules/core.md | 2 +- claude/rules/orchestrator.md | 7 +++++++ 4 files changed, 17 insertions(+), 3 deletions(-) diff --git a/claude/AGENTS.md b/claude/AGENTS.md index 906bf60..65f21bf 100644 --- a/claude/AGENTS.md +++ b/claude/AGENTS.md @@ -20,7 +20,7 @@ # Herdr - Herdr の配布・更新経路は dotfiles の Homebrew 宣言（`nix/modules/darwin/homebrew.nix`）だけ。`herdr update` や `~/.local/bin/herdr` を作る自己更新・直接インストールは使わない。更新が必要なら `brew upgrade herdr` のみを使う -- Herdr を操作する前に `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。異なれば操作せず停止して報告する +- Herdr を操作する前に、login shell 上で `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。bare shell の PATH 不備で見つからないだけの場合は異常ではなく、login shell で再確認する。login shell でも `/opt/homebrew/bin/herdr` 以外に解決される場合が実際の異常で、操作せず停止して報告する # 秘密情報 diff --git a/claude/hermes/SOUL.md b/claude/hermes/SOUL.md index fb80754..5b5fad9 100644 --- a/claude/hermes/SOUL.md +++ b/claude/hermes/SOUL.md @@ -22,7 +22,7 @@ You are Hermes Agent, an intelligent AI assistant created by Nous Research. You # Herdr - Herdr の配布・更新経路は dotfiles の Homebrew 宣言（`nix/modules/darwin/homebrew.nix`）だけ。`herdr update` や `~/.local/bin/herdr` を作る自己更新・直接インストールは使わない。更新が必要なら `brew upgrade herdr` のみを使う -- Herdr を操作する前に `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。異なれば操作せず停止して報告する +- Herdr を操作する前に、login shell 上で `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。bare shell の PATH 不備で見つからないだけの場合は異常ではなく、login shell で再確認する。login shell でも `/opt/homebrew/bin/herdr` 以外に解決される場合が実際の異常で、操作せず停止して報告する # 秘密情報 @@ -91,6 +91,13 @@ You are Hermes Agent, an intelligent AI assistant created by Nous Research. You - 同じタスクでは同じセッションを維持し、後続指示も同じセッションへ送る。新規起動の前に、同じタスクに対応する既存エージェントが無いか確認し、あれば重複起動せず継続利用する - セッション・pane・worktree は、完了確認または明示的な終了指示があるまで削除しない +# 起動可否の判定と blocker 報告 + +- `HERDR_ENV` が未設定であることだけを根拠に、worktree の作成や Claude Code セッションの起動を blocker として扱わない +- 起動不能と報告する前に、login shell 上で正規の起動コマンドを実際に実行し、その失敗を確認する。`--skill` の有無・環境変数チェック・補助コマンドの出力は、起動可否の根拠にしない +- bare shell で `herdr` や `bd` が見つからなくても、それだけで不在と判断しない。login shell で探索してから不在と判断する +- blocker として報告するときは、失敗した正規コマンド・その終了コード・試した代替経路の結果を必ず含める + # 実装エージェントの監視 - 対話型 Herdr Claude エージェントへ prompt/resume を送るたびに、そのターゲットに対して `herdr agent wait` を終了状態込みで登録する。継続 (再 prompt/resume) のたびに再登録する diff --git a/claude/rules/core.md b/claude/rules/core.md index 645bed1..ce13a70 100644 --- a/claude/rules/core.md +++ b/claude/rules/core.md @@ -17,7 +17,7 @@ # Herdr - Herdr の配布・更新経路は dotfiles の Homebrew 宣言（`nix/modules/darwin/homebrew.nix`）だけ。`herdr update` や `~/.local/bin/herdr` を作る自己更新・直接インストールは使わない。更新が必要なら `brew upgrade herdr` のみを使う -- Herdr を操作する前に `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。異なれば操作せず停止して報告する +- Herdr を操作する前に、login shell 上で `command -v herdr` が `/opt/homebrew/bin/herdr` に解決されることを確認する。bare shell の PATH 不備で見つからないだけの場合は異常ではなく、login shell で再確認する。login shell でも `/opt/homebrew/bin/herdr` 以外に解決される場合が実際の異常で、操作せず停止して報告する # 秘密情報 diff --git a/claude/rules/orchestrator.md b/claude/rules/orchestrator.md index 7f48fda..61fb4dc 100644 --- a/claude/rules/orchestrator.md +++ b/claude/rules/orchestrator.md @@ -51,6 +51,13 @@ - 同じタスクでは同じセッションを維持し、後続指示も同じセッションへ送る。新規起動の前に、同じタスクに対応する既存エージェントが無いか確認し、あれば重複起動せず継続利用する - セッション・pane・worktree は、完了確認または明示的な終了指示があるまで削除しない +# 起動可否の判定と blocker 報告 + +- `HERDR_ENV` が未設定であることだけを根拠に、worktree の作成や Claude Code セッションの起動を blocker として扱わない +- 起動不能と報告する前に、login shell 上で正規の起動コマンドを実際に実行し、その失敗を確認する。`--skill` の有無・環境変数チェック・補助コマンドの出力は、起動可否の根拠にしない +- bare shell で `herdr` や `bd` が見つからなくても、それだけで不在と判断しない。login shell で探索してから不在と判断する +- blocker として報告するときは、失敗した正規コマンド・その終了コード・試した代替経路の結果を必ず含める + # 実装エージェントの監視 - 対話型 Herdr Claude エージェントへ prompt/resume を送るたびに、そのターゲットに対して `herdr agent wait` を終了状態込みで登録する。継続 (再 prompt/resume) のたびに再登録する