yunomi: Instructions file for Claude Code

yunomi プロジェクト固有ルール

開発・テスト時のサーバー起動

yunomiを起動する前に通知経路を実行時に取得・検証する。Herdrを先に試し、失敗した時だけ検証済みtmux adapterを評価する。

if PANE_ID="$(herdr pane current 2>/dev/null | jq -er '.result.pane.pane_id')" &&
   herdr pane get "$PANE_ID" >/dev/null 2>&1; then
  YUNOMI_ROUTE=herdr
elif [ -n "${TMUX:-}" ] && [ -n "${YUNOMI_NOTIFY_CMD:-}" ]; then
  TMUX_PANE_ID="$(tmux display-message -p '#{pane_id}')" || exit 1
  test "$(tmux display-message -p -t "$TMUX_PANE_ID" '#{pane_id}')" = "$TMUX_PANE_ID" || exit 1
  YUNOMI_ROUTE=tmux
else
  echo "no proven yunomi notification route" >&2
  exit 1
fi

• Herdr経路の書込み可能レビューは、自分で確認する場合もユーザーにレビューさせる場合も、必ず --loop --notify-pane "$PANE_ID" を付ける。
• 純tmux経路は、事前検証済みの YUNOMI_NOTIFY_CMD が設定されている場合だけ --loop で起動する。yunomi share はread-only例外。
• Claude CodeはBashツールの run_in_background: true で起動し、exitを検知する。
• Herdr経路で--notify-paneが無い起動、通知経路を実行時に証明できない起動、記憶やfocused paneから通知先を推測する起動は禁止。
• 通知先を証明できない場合は、yunomiを起動せずfail closedで報告する。
• --notify-pane はHerdr pane専用。tmuxの%paneを渡さず、その場でraw tmux send-keys fallbackを作らない。Herdrが使えない純tmux環境は、安全なキュー配送と到達性を事前検証済みの YUNOMI_NOTIFY_CMD がある場合だけ --loop で起動し、それ以外はfail closedにする。
• ユーザーが「開いて」と明示した場合は、最終ビルドを使うサーバーの healthz と対象UIを確認してから、macOSの open http://127.0.0.1:<port>/ で操作可能な画面を開き、ユーザーの確認が終わるまでサーバーを維持する。スクリーンショットだけを開いて代用してはいけない。明示依頼がない自動起動では、yunomi自身のブラウザ起動を使ってよい。

この環境のyunomi更新

yunomi本体・UI・生成Skillの確定変更は、ソース変更やMoonBit buildだけで完了扱いにしない。必ず現在のリポジトリから配布物を作り、このMacの標準CLIへ置き換えて実物を検証する。

npm run prepack
mise exec [email protected] -- npm install -g "$PWD"
shasum -a 256 dist/server/server.js \
  /Users/kazuph/.local/share/mise/installs/node/22.22.0/lib/node_modules/yunomi/dist/server/server.js
yunomi --version

• 2つのserver.jsのSHA-256が一致しない状態で完了報告しない。
• 生成Skillを変更した場合は、yunomi install <agent> --global でclaude / codex / cursor / opencode / cline / geminiへ再配布し、各ファイルの存在と通知経路契約を再確認する。
• 赤テスト用の途中状態はインストールしない。対象E2Eとrelease buildを通過した確定buildだけを標準CLIへ置き換える。

構文エラーの回避

テンプレートリテラル内でバッククォートを使う場合はエスケープする：

• 正: `\``
• 誤: `