severally-mcp 2.1.0 → 2.4.0

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,83 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at coz.a.github@gmail.com. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

package/CONFIG.md

@@ -16,10 +16,13 @@ executable path with forward slashes (`"bin": "C:/Tools/claude.exe"`) or escaped
 (`"bin": "C:\\Tools\\claude.exe"`). Where a key also has an
 environment variable (a CLI's `bin`, the server-wide limits), the variable wins over the file.
 
-**A mistake stops everything.** An unknown key, a consultant without a `cli` or `model`, a syntax error: the
-server still starts, but every `consult_start` is refused with `config_invalid` and the reason, which is also
-written to stderr at startup. It does not fall back to defaults, because that would quietly re-enable a CLI
-you turned off.
+**A mistake is kept to where it is.** A mistake inside one consultant (an unknown key, a missing `cli` or
+`model`, `effort` on an Antigravity consultant) takes only that consultant out of use; asking for it is refused
+with `target_unavailable` and the reason. A mistake inside `clis.<cli>` turns that CLI off. Everything else keeps
+working, and each mistake is written to stderr at startup and listed under `config_mistakes` in the limits a
+refused request returns. A mistake in the file as a whole (a syntax error, an unknown top-level key, `clis`,
+`consultants` or `ranking` of the wrong shape) still refuses every `consult_start` with `config_invalid`. None of
+them falls back to defaults, because that would quietly re-enable a CLI you turned off.
 
 **Comments are fine.** `//` and `/* */` comments and trailing commas are stripped before parsing, in both a
 `.json` and a `.jsonc` file — use whichever extension your editor is happy with (if it flags comments in
@@ -200,13 +203,14 @@ server only from Claude Code and Antigravity.
 | `max_rounds` | 5 (1 initial + 4 follow-ups) | 1–20 | `SEVERALLY_MAX_ROUNDS` | Rounds per consultation chain, the first one included. |
 | `max_concurrent` | 9 | 1–9 | `SEVERALLY_MAX_CONCURRENT` | Consultations running at once, counted across every severally process that shares this home (one runs per client session); a request that would go over it is refused. A "consult everyone" fan-out takes one per consultant, and is refused if that is over the cap. |
 | `max_jobs_retained` | 200 | 20–2000 | `SEVERALLY_MAX_JOBS_RETAINED` | Jobs the running server keeps in memory; older finished ones are dropped from memory, never from the history on disk. |
-| `max_wait_ms` | 45000 | 0–600000 | `SEVERALLY_MAX_WAIT_MS` | Longest `wait_ms` a single `consult_get` may block for. Keep it under your client's tool-call timeout. A `consult_get` with no `wait_ms` waits for this long, or 45000 if this is higher, unless the environment variable is set: it belongs to one client's registration, so it also sets that client's default wait (and takes precedence over this key). The plugin registrations for Claude Code and Codex (and the installer's `--manual` registration for Claude Code) set the environment variable to 600000: Claude Code waits on a tool call far longer, and the Codex plugin raises its tool-call timeout to 660 s. While it waits, `consult_get` sends a progress notification every 15 s when the client asks for them, and stops waiting if the client cancels the call. |
+| `max_wait_ms` | 45000 | 0–600000 | `SEVERALLY_MAX_WAIT_MS` | Longest `wait_ms` a single `consult_get` may block for. Keep it under your client's tool-call timeout. A `consult_get` with no `wait_ms` waits for this long, or 45000 if this is higher, unless the environment variable is set: it belongs to one client's registration, so it also sets that client's default wait (and takes precedence over this key). The installer's registrations for Claude Code, Codex and OpenCode set the environment variable to 600000: Claude Code and OpenCode wait on a tool call far longer, and for Codex the installer raises its tool-call timeout to 660 s (in the plugin manifest, or as `tool_timeout_sec` in `config.toml` for a `--manual` registration). Antigravity stops a tool call at 3 minutes whatever the progress, so the installer registers it with 165000. While it waits, `consult_get` sends a progress notification every 15 s when the client asks for them, and stops waiting if the client cancels the call. |
 | `timeout_ms` | 1800000 | 1000–7200000 | `SEVERALLY_TIMEOUT_MS` | Wall-clock budget per consultation, for every consultant without its own `timeout_ms`. |
 | `kill_grace_ms` | 5000 | 500–60000 | `SEVERALLY_KILL_GRACE_MS` | Time between asking a stopped consultant to exit and killing it; also how long the server waits for running consultants when it shuts down. |
 | `max_auto_retries` | 2 | 0–3 | `SEVERALLY_MAX_AUTO_RETRIES` | How many times a consultation that failed with `rate_limited` or `cli_error` is run again automatically, inside its original time budget. `0` turns it off. |
+| `network` | `"on"` | `"on"` or `"off"` | `SEVERALLY_NETWORK` | `"off"` takes web search and browsing away from every consultation, whatever the request's own `network` says; `"on"` leaves it to each request. Unlike the other keys, `"off"` from either the file or the environment wins, so one cannot reopen what the other closed. Any other value is a config mistake that refuses every consultation. |
 | `retry_backoff_ms` | 5000 | 0–60000 | `SEVERALLY_RETRY_BACKOFF_MS` | Wait before the first automatic re-run; each later one waits three times longer. |
 
-A value outside the range is clamped to it.
+A number outside its range is clamped to it.
 
 ## Environment only
 

package/README.ja.md

@@ -21,12 +21,21 @@ AI エージェントが、ほかのコーディングエージェントに独
 severally は、独立した複数の相談相手に質問し、答えを 1 つにまとめずに相談相手ごとに返します。意見が割れたこと
 自体にも意味があるからです。エージェントは割れた理由を確かめたうえで、どう受け止めるかを決めます。
 
+遅い商品ページを 5 分キャッシュしてよいかを聞くと、3 人の相談相手がそれぞれ次のように答えました（全体は
+[使い方の例](#使い方の例)にあります）。
+
+```
+codex        do_not_proceed  価格は会員のランクで変わるので、最初の訪問者の価格が全員に出る
+claude-code  do_not_proceed  最初にキャッシュを埋めた人の価格が、5 分間ほかの全員に出る
+antigravity  alternative     会員割引がほかの利用者に漏れる。クエリを直せばキャッシュは要らないかもしれない
+```
+
 ## 目次
 
-- [使い方の例](#使い方の例)
-- [仕組み](#仕組み)
+- [背景](#背景)
 - [インストール](#インストール)
   - [必要なもの](#必要なもの)
+  - [コマンドライン](#コマンドライン)
   - [更新](#更新)
   - [アンインストール](#アンインストール)
 - [使い方](#使い方)
@@ -34,65 +43,15 @@ severally は、独立した複数の相談相手に質問し、答えを 1 つ
   - [答えが返ったあと](#答えが返ったあと)
   - [モード](#モード)
   - [履歴と記録](#履歴と記録)
+- [使い方の例](#使い方の例)
+- [おすすめの構成](#おすすめの構成)
 - [設定](#設定)
 - [相談相手が読めるものとできること](#相談相手が読めるものとできること)
 - [API](#api)
 - [貢献](#貢献)
 - [ライセンス](#ライセンス)
 
-## 使い方の例
-
-severally を使うと、エージェントの仕事の進め方がどう変わるかを、1 つの場面で示します。エージェントが変更を
-思いつき、あなたに承認を求める前に、相談相手の意見を聞く場面です。
-
-例に使うのは、小さなネットショップの API です。商品ページを返す `GET /products/:id` が遅く、約 800 ms
-かかっています。この API は、商品に在庫とレビューを結合して読み込んでいます。また、商品の価格は会員の
-ランクで変わり、ゴールド会員には 10% の割引が付きます。
-
-Claude Code で動くエージェントは、「レスポンスをメモリ上の Map に 5 分間保持する」というよくある修正を
-考えました。あなたに「進めてよいですか」と尋ねる前に、この計画を 3 人の相談相手に見せます。Codex、
-Antigravity、新しい Claude Code のセッション（エージェント自身の CLI の新しいセッションで、会話は
-引き継がない）です。計画と一緒に、関係するコードの読み取り専用の写しも渡します。答えは相談相手ごとに、
-横に並んで返ってきます（サンプルの API に対する実際の実行結果の抜粋を訳したもの）。
-
-```
-codex        do_not_proceed  価格は会員のランクで変わるので、商品 ID だけで保持すると、最初に来た人の
-                             価格が全員に返る。結合で在庫数が水増しされている。4 つのワーカーが別々に保持するので、
-                             注文で在庫が変わっても古い値が消えない
-claude-code  do_not_proceed  最初にキャッシュに入った人の価格が、5 分間ほかの全員に返る。4 つのワーカーがそれぞれ
-                             保持するので、注文のあとも在庫が古いまま残る。結合の不具合も先に直す
-antigravity  alternative     会員の割引がほかの利用者に漏れる。800 ms の原因は在庫とレビューの結合で、在庫数も
-                             狂わせている。クエリを書き直せば、キャッシュなしで十分に速くなる見込みがある
-```
-
-どの答えも結論から始まります。結論は `proceed`（進めてよい）、`do_not_proceed`（進めない）、`alternative`
-（代わりに別のことをする）、`undetermined`（決められない）のどれかです。3 人は、価格の漏れ、在庫の水増し、
-ワーカーごとのキャッシュという同じ問題を、それぞれ独立に見つけました。違うのはその先です。Codex と
-Claude Code は、クエリを直したうえで、利用者によらない部分だけをキャッシュするよう勧めています。
-Antigravity は、クエリを直せばキャッシュ自体が要らないかもしれないと言っています。答えを 1 つにまとめると、
-この違いは埋もれてしまいます。
-
-相談したエージェント（以下、*主担当*）は、指摘を読んだあと、自分のリポジトリで確かめます。2 つの指摘の
-うち、1 つはそのとおりに再現しました。もう 1 つは、今はまだ起きていないと分かり、対応が変わりました。
-
-```
-指摘     クエリが在庫とレビューを一緒に結合しているので、在庫数がレビューの数だけ掛け算される
-  確認   テスト用のデータベースでクエリを実行: 在庫 5 個、レビュー 4 件 -> 在庫数が 20 になる
-  判断   キャッシュより先に、クエリを直す
-
-指摘     ゴールド会員の 10% 割引がゲストにも返る
-  確認   ログインの仕組みはまだ組み込まれていないので、今は全員が基本価格になる。
-         漏れはログインを足した日から始まる
-  判断   キャッシュするのは利用者によらない商品の情報だけにし、価格はリクエストごとに計算する
-```
-
-あなたに返ってくるのは「反対 2、代案 1」という票の数ではありません。何を確かめたか、主担当が何を勧めるか、
-まだ何を確かめていないかです。この例でまだ確かめていないのは、直したクエリがキャッシュなしで十分に速いか
-（本番に近いデータが要る）と、注文のあと在庫の表示がどれだけ古くてもよいか（あなたが決めること）です。
-判断はあなたがします。確かめた結果は指摘の隣に残り、Markdown としてリポジトリに書き出せます
-（[履歴と記録](#履歴と記録)を参照）。
-
-## 仕組み
+## 背景
 
 ```mermaid
 flowchart TB
@@ -121,25 +80,56 @@ flowchart TB
 
 ### 必要なもの
 
-- Node.js 20.10 以降
+- Node.js 22 以降
 - インストールしてログインした CLI（4 つのうち少なくとも 1 つ）。1 つで足り、Claude Code だけでも、新しい
   Claude Code のセッションに相談できます。
-- macOS と Linux では、npm のグローバルの実行ディレクトリが `PATH` にあること。既定のインストールは、Codex が
-  起動する `severally-mcp` コマンドをそこに置きます。`--manual` なら要りません。
+
+インストーラとサーバは Linux・macOS・Windows でテストしています。Claude Code と Codex のマーケットプレイスからの
+導入と、実際の CLI での動作を試したのは Linux だけです。
 
 macOS、Linux、Windows（PowerShell またはコマンドプロンプト）のどれでも、次の 1 行で入れられます。
 
 ```bash
-npx -y severally-mcp@2.1.0 install
+npx -y severally-mcp@2.4.0 install
 ```
 
 インストーラは、`PATH` で見つかった CLI のそれぞれに severally を登録します。末尾に `--dry-run` を付けると、何も
 変えずに変更内容だけを表示します。終わったら、クライアントを再起動してください。動いているセッションは、新しい
 登録を読み直しません。
 
+Claude Code だけで使うなら、プラグインマーケットプレイスから入れることもできます。Claude Code で
+`/plugin marketplace add coz-a/severally`、続けて `/plugin install severally@severally` を実行し、Claude Code を
+再起動します。見つかった CLI すべてに登録できる上の 1 行が基本の方法です。詳しくは
+[docs/install.ja.md](docs/install.ja.md#claude-code-のプラグインマーケットプレイスから入れる) にあります。
+
+macOS と Linux の既定のインストールは、`npm install -g` で `severally-mcp` コマンドを `PATH` に置きます。要るのは
+Codex のプラグインだけです。npm がグローバルに入れられないとき（たとえば sudo が要る、npm のグローバルのフォルダが
+`PATH` に無い）は、インストーラが代わりに Codex を直接登録し、そう表示します。ほかに必要なことはありません。
+
 Claude Code のプラグインマーケットプレイスから入れる方法、クローンから入れる方法、登録の確かめ方、インストーラが
 変えるものは、[docs/install.ja.md](docs/install.ja.md) にあります。
 
+### コマンドライン
+
+```bash
+npx -y severally-mcp@latest install [--dry-run] [--manual] [--force] [--skip-global] [--allow-local-tools]
+```
+
+| オプション | すること |
+|---|---|
+| `--dry-run` | 何を変えるかを表示するだけで、何も変えない |
+| `--manual` | プラグインを入れる代わりに、MCP サーバを登録して Skill を写す（Windows の既定） |
+| `--force` | すでに登録してあっても、そのままにせず登録し直す |
+| `--skip-global` | プラグイン方式で npm のグローバルなインストールを飛ばす。`PATH` 上の `severally-mcp` がすでにこのインストールを指しているときだけ使える |
+| `--allow-local-tools` | severally の手元で完結する 5 つのツールを、確認なしで Claude Code の許可リストに足す。`consult_start` は確認を残す |
+
+方式ごとに何が変わるかは [docs/install.ja.md](docs/install.ja.md#2-つのインストール方式) にあります。
+
+`npx -y severally-mcp@latest status` を実行すると、相談を始めずに、設定ファイル・この機械から使える相談相手・
+入っている写しの版・どのクライアントに登録されているか・各 CLI にログインしているかを表示します。ログインの確認は
+CLI 自身の状態確認コマンドを読むだけで、プロンプトは送りません。使用枠を使い切っていないかは確かめません。それは
+最初の相談で分かります。
+
 ### 更新
 
 次の 1 行で、最新版に入れ替わります。バージョン番号を調べる必要はありません。
@@ -149,8 +139,8 @@ npx -y severally-mcp@latest install
 ```
 
 `@latest` を付けると、npx は毎回 npm に最新版を問い合わせます。手元に古い写しがあっても、それは使いません。
-終わったら、クライアントを再起動してください。Claude Code のプラグインマーケットプレイスから入れた場合は、
-[docs/install.ja.md](docs/install.ja.md#更新) を見てください。版ごとの変更点は
+Claude Code にマーケットプレイス版の severally が入っていれば、同じ 1 行でその写しも更新されます（詳しくは
+[docs/install.ja.md](docs/install.ja.md#更新)）。終わったら、クライアントを再起動してください。版ごとの変更点は
 [リリース](https://github.com/coz-a/severally/releases)にあります。
 
 ### アンインストール
@@ -179,6 +169,9 @@ npx -y severally-mcp@latest install
 - 頼まなくても、エージェントは自分から相談します。調査が行き詰まったとき、甲乙つけがたい選択に当たったとき、
   巻き戻しにくい変更の承認を求める前です。
 
+あなたに返ってくるのは、相談相手の答えそのものではなく、主担当の報告です。確かめたことと結果、勧めること、
+まだ確かめていないことが並びます。報告の例は[使い方の例](#使い方の例)にあります。
+
 相談が向いているのは、重要な設計判断、巻き戻しにくい選択、同じ不具合で 2 回以上失敗したときです。相談 1 回に
 数分から 10 分ほどと実際の使用量がかかるので、小さな修正には向きません。
 
@@ -187,7 +180,8 @@ npx -y severally-mcp@latest install
 相談を始めても、エージェントは答えを待たずに、答えに左右されない作業を進められます。答えはふつう 1〜10 分で
 そろいます（いちばん時間がかかるのは Antigravity です）。
 
-どの答えも同じ形で返ります。結論、根拠つきの指摘、決められなかったこと、判断が変わる条件、確かめ方です。
+どの答えにも同じ形を求めます。結論、根拠つきの指摘、決められなかったこと、判断が変わる条件、確かめ方です。
+結論や指摘の根拠などが欠けた答えは、そのことを注意書き（caveat）で知らせます。
 相談相手が失敗したときは、理由（`usage_limit`、`timeout` など）を付けて失敗として返します。「問題なし」として
 返すことはありません。
 
@@ -200,7 +194,7 @@ npx -y severally-mcp@latest install
 こともできます。
 
 - `explore`：計画を見せずに聞く。相談相手は、まず自分のやり方で答える
-- `review`：計画を見せて、どこがまずいかを聞く（上の例はこれ）
+- `review`：計画を見せて、どこがまずいかを聞く（[使い方の例](#使い方の例)はこれ）
 - `debate`：計画と反対の主張を見せて、比べてもらう
 
 最初の答えのあと、同じ相談相手に追加の質問を送れます。既定では 4 回まで、合わせて 5 往復です。全員に聞いた相談に追加の質問を送ると、全員にもう一度聞けます。それぞれの相談相手とのやりとりは別々に続きます。
@@ -213,12 +207,92 @@ npx -y severally-mcp@latest install
 
 相談相手の呼び方、相談の進み方、記録の詳細は [docs/how-it-works.ja.md](docs/how-it-works.ja.md) にあります。
 
+## 使い方の例
+
+severally を使うと、エージェントの仕事の進め方がどう変わるかを、1 つの場面で示します。エージェントが変更を
+思いつき、あなたに承認を求める前に、相談相手の意見を聞く場面です。
+
+例に使うのは、小さなネットショップの API です。商品ページを返す `GET /products/:id` が遅く、約 800 ms
+かかっています。この API は、商品に在庫とレビューを結合して読み込んでいます。また、商品の価格は会員の
+ランクで変わり、ゴールド会員には 10% の割引が付きます。
+
+Claude Code で動くエージェントは、「レスポンスをメモリ上の Map に 5 分間保持する」というよくある修正を
+考えました。あなたに「進めてよいですか」と尋ねる前に、この計画を 3 人の相談相手に見せます。Codex、
+Antigravity、新しい Claude Code のセッション（エージェント自身の CLI の新しいセッションで、会話は
+引き継がない）です。計画と一緒に、関係するコードの読み取り専用の写しも渡します。答えは相談相手ごとに、
+横に並んで返ってきます（サンプルの API に対する実際の実行結果の抜粋を訳したもの）。
+
+```
+codex        do_not_proceed  価格は会員のランクで変わるので、商品 ID だけで保持すると、最初に来た人の
+                             価格が全員に返る。結合で在庫数が水増しされている。4 つのワーカーが別々に保持するので、
+                             注文で在庫が変わっても古い値が消えない
+claude-code  do_not_proceed  最初にキャッシュに入った人の価格が、5 分間ほかの全員に返る。4 つのワーカーがそれぞれ
+                             保持するので、注文のあとも在庫が古いまま残る。結合の不具合も先に直す
+antigravity  alternative     会員の割引がほかの利用者に漏れる。800 ms の原因は在庫とレビューの結合で、在庫数も
+                             狂わせている。クエリを書き直せば、キャッシュなしで十分に速くなる見込みがある
+```
+
+どの答えも結論から始まります。結論は `proceed`（進めてよい）、`do_not_proceed`（進めない）、`alternative`
+（代わりに別のことをする）、`undetermined`（決められない）のどれかです。3 人は、価格の漏れ、在庫の水増し、
+ワーカーごとのキャッシュという同じ問題を、それぞれ独立に見つけました。違うのはその先です。Codex と
+Claude Code は、クエリを直したうえで、利用者によらない部分だけをキャッシュするよう勧めています。
+Antigravity は、クエリを直せばキャッシュ自体が要らないかもしれないと言っています。答えを 1 つにまとめると、
+この違いは埋もれてしまいます。
+
+相談したエージェント（以下、*主担当*）は、指摘を読んだあと、自分のリポジトリで確かめます。2 つの指摘の
+うち、1 つはそのとおりに再現しました。もう 1 つは、今はまだ起きていないと分かり、対応が変わりました。
+
+```
+指摘     クエリが在庫とレビューを一緒に結合しているので、在庫数がレビューの数だけ掛け算される
+  確認   テスト用のデータベースでクエリを実行: 在庫 5 個、レビュー 4 件 -> 在庫数が 20 になる
+  判断   キャッシュより先に、クエリを直す
+
+指摘     ゴールド会員の 10% 割引がゲストにも返る
+  確認   ログインの仕組みはまだ組み込まれていないので、今は全員が基本価格になる。
+         漏れはログインを足した日から始まる
+  判断   キャッシュするのは利用者によらない商品の情報だけにし、価格はリクエストごとに計算する
+```
+
+あなたに返ってくるのは「反対 2、代案 1」という票の数ではありません。何を確かめたか、主担当が何を勧めるか、
+まだ何を確かめていないかです。この例でまだ確かめていないのは、直したクエリがキャッシュなしで十分に速いか
+（本番に近いデータが要る）と、注文のあと在庫の表示がどれだけ古くてもよいか（あなたが決めること）です。
+判断はあなたがします。確かめた結果は指摘の隣に残り、Markdown としてリポジトリに書き出せます
+（[履歴と記録](#履歴と記録)を参照）。
+
+## おすすめの構成
+
+各ベンダーの最上位のモデルを相談相手に登録しておき、ふだんの作業は Claude Code の Sonnet のような安価なモデルで
+進める、という使い方です。コードの編集、テストの実行、検索など、作業の大半は安価なモデルで足ります。
+設計の選択や巻き戻しにくい変更など、判断を誤ったときの損が大きい場面では、主担当が最上位のモデルにそれぞれ
+独立に相談します。最上位のモデルを使うのは相談のときだけです。そのため、使用量の大半は安価なモデルの側に
+収まり、重要な判断には最上位のモデルの意見が入ります。
+
+この構成の `~/.severally/config.json` の例です。
+
+```json
+{
+  "consultants": {
+    "opus": { "cli": "claude-code", "model": "claude-opus-5-5" },
+    "gpt": { "cli": "codex", "model": "gpt-6.1-sol" },
+    "gemini": { "cli": "antigravity", "model": "gemini-4-argon-high" }
+  }
+}
+```
+
+モデルの ID は新しいモデルが出るたびに変わるので、使っている CLI に合わせて書き換えてください。`effort` を
+書かなければ、相談相手は effort `high` で動きます。ただし Antigravity はモデル名で決まり（`gemini-4-argon-high`）、
+`effort` を書くと設定の誤りになります。
+
+そのうえで、主担当を安価なモデルで起動します（`claude --model sonnet`、動いているセッションなら
+`/model sonnet`）。主担当は、[頼み方](#頼み方)に挙げた場面で自分から相談します。「マージする前にみんなに
+聞いて」のように頼むこともできます。相談相手は、それぞれの CLI のログインと利用枠を使います。
+
 ## 設定
 
 **既定のままなら設定は要りません**。サーバは起動時に `PATH` にある CLI を探し、見つかった CLI をそれぞれ、既定の
 モデルで動く相談相手にします。CLI を止める、ほかのモデルの相談相手を足す、といったときは
 `~/.severally/config.json` を置きます。クローンから入れた場合は、`npm run init-config` でひな形を作れます。キーは
-すべて [CONFIG.md](CONFIG.md)（英語）にあり、[config.example.json](config.example.json) はそのまま写せる例です。
+すべて [CONFIG.md](CONFIG.md)（英語）にあり、[config.example.json](config.example.json) は書き換えて使う例です（パス・モデル・メモは架空のものです）。
 設定を変えたら、クライアントを再起動してください。
 
 API キーで呼び出すモデル（OpenRouter や、OpenAI 互換のほかの API）やローカルのモデルに相談するには、OpenCode を入れて、
@@ -242,13 +316,15 @@ API キーで呼び出すモデル（OpenRouter や、OpenAI 互換のほかの
 | Antigravity | できる（`view_file`） | 拒否（ツールのフック） | なし | できない | できる（`network: "off"` のときを除く） |
 | OpenCode | できる（`read` / `glob` / `grep`） | 拒否（権限の規則） | なし（Code Mode の `execute` は拒否） | できない | できる（`network: "off"` のときを除く） |
 
-どの相談相手も空の作業ディレクトリで始まり、サーバはあなたのリポジトリの場所を伝えません。それでも、あなたの
+どの相談相手も、渡したファイルの写しだけが入った専用の作業ディレクトリで始まり、サーバはあなたのリポジトリの
+場所を伝えません。それでも、あなたの
 ユーザーアカウントで読めるファイルは、表で「拒否」とした秘密のパスを除いて読めます。Codex はファイルの名前では
 拒否しないので、あなたのリポジトリにある `.env` は Codex から読めます。
 
 **ディスクを読めて Web も閲覧できる相談相手は、読んだ内容を URL に載せて外に持ち出せます**。開いたページに、
 そうするよう書かれていた場合などです。それを防ぎたいときは、エージェントが `network: "off"` を渡します。その回の
-どの相談相手も、Web の検索と閲覧ができなくなります。それでも、ブリーフと相談相手が読んだ内容は、その CLI の
+どの相談相手も、Web の検索と閲覧ができなくなります。すべての相談でそうするには、
+[設定ファイル](CONFIG.md#server-wide-keys)に `"server": { "network": "off" }` と書きます。依頼の側からは戻せません。それでも、ブリーフと相談相手が読んだ内容は、その CLI の
 モデルに送られます。
 
 CLI ごとにどう守らせているかは [docs/how-it-works.ja.md](docs/how-it-works.ja.md#相談相手を読み取りだけにとどめる仕組み) にあります。
@@ -262,9 +338,9 @@ CLI ごとにどう守らせているかは [docs/how-it-works.ja.md](docs/how-i
 |---|---|
 | `consult_start` | 1 人（`target`）または複数（`targets`）の相談相手に相談を始め、`job_id` か `group_id` をすぐに返す |
 | `consult_get` | 相談を待ち、状態か答えを返す。`ids` を付けると、答えのうちその指摘だけを返す |
-| `consult_cancel` | 相談、または全員に聞いた相談をまとめて止め、相談相手のプロセスも止める |
+| `consult_cancel` | 相談、または全員に聞いた相談をまとめて止め、相談相手のプロセスも止める。別のセッションが始めた相談も止められる |
 | `consult_record` | 答えの指摘ごとの主担当の判定と、答えから新しく分かったことを書く |
-| `consult_list` | 最近の相談を、各相談相手が報告した使用量とともに並べる |
+| `consult_list` | 前のセッションのものも含めて最近の相談を並べる。使用量は、このセッションで各相談相手が報告した分 |
 | `consult_export` | 相談を、追加の質問と判定を含めて Markdown で返す |
 
 `consult_start` の主な引数は次のとおりです。
@@ -273,7 +349,8 @@ CLI ごとにどう守らせているかは [docs/how-it-works.ja.md](docs/how-i
   ディレクトリは、git が一覧するファイル（追跡中のものと、`.gitignore` で外していない未追跡のもの）だけを写す
 - `context.expose_diff`: `{ repo, base? }`。変更中の差分をブリーフに入れ、差分が触るファイルを写す
 - `network`: `"off"` にすると、その回のどの相談相手も Web の検索と閲覧ができない
-- `followup_to`: 追加の質問のもとになる答えの `job_id`。全員に聞いた相談の `group_id` を渡すと、全員にもう一度聞く
+- `followup_to`: 追加の質問のもとになる答えの `job_id`。全員に聞いた相談の `group_id` を渡すと、全員にもう一度聞く。
+  追加の質問はこれと `question` だけでよく、相談相手・モード・前の回の前提は、渡し直さなければそのまま引き継ぐ
 
 ## 貢献