Skip to content

Commit bf83971

Browse files
authored
Simplify downstream AI setup guidance (#4818)
1 parent 4fdac3e commit bf83971

3 files changed

Lines changed: 77 additions & 399 deletions

File tree

‎CLOUD_BOOTSTRAP_PROMPT.md‎

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -247,9 +247,9 @@ endpoint.
247247

248248
The repo-tracked `.claude/settings.json` denies `Bash(cdidx:*)`,
249249
`Bash(~/.local/bin/cdidx:*)`, and `Bash($HOME/.local/bin/cdidx:*)` as a
250-
**best-effort tripwire** (see `CLAUDE.md`) against local sessions that
251-
would silently fall back to a stale global binary. Claude Code
252-
permission matching is textual, so invoking the installed binary via
250+
**best-effort tripwire** (see `AGENT_GUIDE.md` under Tool-Specific Notes)
251+
against local sessions that would silently fall back to a stale global binary.
252+
Claude Code permission matching is textual, so invoking the installed binary via
253253
its fully expanded absolute path is not matched by any of those three
254254
entries and is therefore allowed without any permission edit. In Codex, print
255255
the path once and paste the printed literal path into every command below:
@@ -359,11 +359,12 @@ You can fully validate changes in these areas without a .NET SDK:
359359

360360
- `install.sh`, `.github/workflows/*.yml`, the contents and layout of the
361361
release tarball (inspect with `tar tzf`).
362-
- `README.md`, `CHANGELOG.md`, `CLAUDE.md`, `SELF_IMPROVEMENT.md`,
363-
`TESTING_GUIDE.md`, `DEVELOPER_GUIDE.md` — both the English and the
364-
Japanese sections of each.
365-
- The `# Code Search Rules` / `# コードベース検索ルール` template in
366-
`README.md`.
362+
- `README.md`, `USER_GUIDE.md`, `AGENT_GUIDE.md`, `SELF_IMPROVEMENT.md`,
363+
`TESTING_GUIDE.md`, `DEVELOPER_GUIDE.md`, and bilingual fragments under
364+
`changelog.d/unreleased/` — both language sections where the file has them.
365+
- The AI Integration / MCP Server guidance in `USER_GUIDE.md`; keep it aligned
366+
with in-band MCP instructions and discovery metadata instead of restoring a
367+
downstream agent-rules template.
367368
- MCP `instructions`, tool descriptions, help / usage strings, and
368369
user-visible error messages. Locate those strings with the literal expanded
369370
installed path, for example `/root/.local/bin/cdidx search "initialize"`,
@@ -378,7 +379,7 @@ You can fully validate changes in these areas without a .NET SDK:
378379
- Do **not** claim "verified locally" or "dotnet test passes" — you
379380
cannot prove either here.
380381

381-
### Everything else follows `CLAUDE.md` and `SELF_IMPROVEMENT.md`
382+
### Everything else follows `AGENT_GUIDE.md` and `SELF_IMPROVEMENT.md`
382383

383384
Per-commit checklist, bilingual English / Japanese documentation,
384385
ordinary implementation PRs add bilingual fragments under
@@ -622,7 +623,8 @@ mirror/proxy endpoint が必要です。
622623
古いグローバルバイナリに黙ってフォールバックしないよう
623624
`Bash(cdidx:*)`、`Bash(~/.local/bin/cdidx:*)`、
624625
`Bash($HOME/.local/bin/cdidx:*)` を **best-effort tripwire** として
625-
deny しています(詳細は `CLAUDE.md`)。Claude Code の permission
626+
deny しています(詳細は `AGENT_GUIDE.md` の Tool-Specific Notes)。
627+
Claude Code の permission
626628
matching はテキスト一致なので、インストール済みバイナリを**完全展開した
627629
絶対パス**で起動すればこの 3 エントリとは一致せず、パーミッション編集
628630
なしに通ります。Codex では以下のように 1 回だけパスを表示し、出力された
@@ -735,11 +737,12 @@ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | /root/.local
735737

736738
- `install.sh`、`.github/workflows/*.yml`、リリース tarball の内容と
737739
レイアウト(`tar tzf` で検査)。
738-
- `README.md`、`CHANGELOG.md`、`CLAUDE.md`、`SELF_IMPROVEMENT.md`、
739-
`TESTING_GUIDE.md`、`DEVELOPER_GUIDE.md` — それぞれの英語セクションと
740-
日本語セクションの両方。
741-
- `README.md` の `# Code Search Rules` / `# コードベース検索ルール`
742-
テンプレート。
740+
- `README.md`、`USER_GUIDE.md`、`AGENT_GUIDE.md`、`SELF_IMPROVEMENT.md`、
741+
`TESTING_GUIDE.md`、`DEVELOPER_GUIDE.md`、`changelog.d/unreleased/`
742+
配下の英日併記 fragment — 各ファイルに両言語セクションがある場合はその両方。
743+
- `USER_GUIDE.md` の AI Integration / MCP Server ガイダンス。下流向け
744+
agent-rules テンプレートを復活させず、MCP が protocol 上で返す instructions
745+
と discovery metadata に同期させます。
743746
- MCP の `instructions`、ツール説明、help / usage 文字列、ユーザーが目に
744747
するエラーメッセージ。これらの文字列は literal な完全展開済み path で、
745748
例えば `/root/.local/bin/cdidx search "initialize"`、または
@@ -753,7 +756,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | /root/.local
753756
- 「ローカルで検証済み」「dotnet test 通過」とは**書かない** — ここでは
754757
どちらも証明できません。
755758

756-
### その他は `CLAUDE.md` と `SELF_IMPROVEMENT.md` に従う
759+
### その他は `AGENT_GUIDE.md` と `SELF_IMPROVEMENT.md` に従う
757760

758761
コミット毎チェックリスト、英日併記ドキュメント、通常の実装 PR では
759762
`CHANGELOG.md` を直接編集せず `changelog.d/unreleased/` に英日併記

0 commit comments

Comments
 (0)