Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

docs(astra-review): add usage guide in English and Japanese

kenima-arcf81a375de9b3
diff --git a/README.md b/README.md
index 8fbaddf2d..bd6847ab3 100644
--- a/README.md
+++ b/README.md
@@ -575,6 +575,12 @@ That runtime provides the external dependencies these commands expect, including
Without `ccg-workflow`, these `multi-*` commands will not run correctly.
</details>
+<details>
+<summary><strong>Astra review requires the Codex CLI</strong></summary>
+
+`/astra-review` sends Claude-written code to GPT-6-Astra for an independent cross-provider review. It runs the locally installed [Codex CLI](https://github.com/openai/codex) with your ChatGPT login (`codex login`); no OpenAI API key is needed, and API keys in your environment are not forwarded. Invoking the command is your consent to send that diff to OpenAI. Setup, scopes, push gating, and troubleshooting are in the [Astra Review Guide](docs/ASTRA-REVIEW-GUIDE.md).
+</details>
+
<details>
<summary><strong>Reset, repair, or uninstall</strong></summary>
@@ -1147,7 +1153,7 @@ This repo is the raw code. The guides explain everything.
| Parallelization | Git worktrees, cascade method, when to scale instances |
| Subagent Orchestration | The context problem, iterative retrieval pattern |
-[Commands Quick Reference](./COMMANDS-QUICK-REF.md) | [Manual Adaptation Guide](docs/MANUAL-ADAPTATION-GUIDE.md) | [Troubleshooting FAQ](./TROUBLESHOOTING.md) | [Roadmap](docs/ROADMAP.md)
+[Commands Quick Reference](./COMMANDS-QUICK-REF.md) | [Manual Adaptation Guide](docs/MANUAL-ADAPTATION-GUIDE.md) | [Astra Review Guide](docs/ASTRA-REVIEW-GUIDE.md) | [Troubleshooting FAQ](./TROUBLESHOOTING.md) | [Roadmap](docs/ROADMAP.md)
## Why Choose ECC?
diff --git a/commands/astra-review.md b/commands/astra-review.md
index 3aa21c82d..fe763f9fc 100644
--- a/commands/astra-review.md
+++ b/commands/astra-review.md
@@ -101,3 +101,4 @@ Remaining: [unresolved CRITICAL/HIGH, if any]
- Web search is disabled for the reviewer, the user-level Codex config is not loaded, and every MCP server Codex reports via `codex mcp list` is disabled by name (an empty `mcp_servers` table would not clear them). Only PATH/HOME-style variables reach the Codex process. API keys in your environment are not forwarded.
- To gate a push on this review, run it before `git push` and refuse to push on exit code 1. Pair with `/santa-loop` when you want two independent reviewers.
- If Codex is missing, fall back to `/code-review` and say clearly that no cross-provider review happened.
+- Full manual (setup, scopes, push gating, troubleshooting): `docs/ASTRA-REVIEW-GUIDE.md` in the ECC repository.
diff --git a/docs/ASTRA-REVIEW-GUIDE.md b/docs/ASTRA-REVIEW-GUIDE.md
new file mode 100644
index 000000000..f663938cf
--- /dev/null
+++ b/docs/ASTRA-REVIEW-GUIDE.md
@@ -0,0 +1,165 @@
+# Astra Review Guide
+
+`/astra-review` sends code written in Claude Code to **GPT-6-Astra** (OpenAI) for an independent, cross-provider review. Claude stays the only writer; Astra returns a structured verdict, never a patch. This guide covers setup, day-to-day use, gating, and troubleshooting. The command reference lives in [`commands/astra-review.md`](../commands/astra-review.md).
+
+## How it works
+
+```text
+Claude Code Codex CLI (read-only sandbox) OpenAI
+----------- ----------------------------- ------
+git diff / file contents -----> codex exec -m gpt-6-astra ---------> GPT-6-Astra
+rubric + JSON schema web search off, MCP off,
+ user config skipped <--------- JSON verdict
+markdown report + exit code <-- --output-schema enforced
+Claude fixes CRITICAL/HIGH, re-runs (max 3 rounds), escalates to you
+```
+
+The reviewer sees the diff, the rubric, and the repository through Codex's read-only tools. It never sees Claude's conversation, so it does not share the author's assumptions.
+
+## Prerequisites
+
+| Requirement | How to check |
+|-------------|--------------|
+| Codex CLI installed | `codex --version` (install: `npm i -g @openai/codex`) |
+| Logged in with ChatGPT | `codex login` once; `~/.codex/auth.json` shows `"auth_mode": "chatgpt"` |
+| `gpt-6-astra` on the account | open `codex` and check the model picker; otherwise set `ECC_ASTRA_MODEL` |
+| ECC installed with `commands-core` | `/ecc:astra-review` appears in the command list |
+
+No OpenAI API key is needed. If one is in your environment it is **not** forwarded to the reviewer process.
+
+### Plugin freshness
+
+The Claude Code plugin cache is keyed by ECC's version number, so editing the ECC checkout does not refresh an installed copy. If `/ecc:astra-review` is reported as unknown after updating ECC, uninstall and reinstall the plugin (or bump the version in `.claude-plugin/plugin.json`), then restart the session:
+
+```bash
+claude plugin uninstall ecc@ecc && claude plugin install ecc@ecc
+```
+
+## Quick start
+
+```text
+/ecc:astra-review # uncommitted changes (staged + unstaged + untracked)
+/ecc:astra-review --base main # everything on this branch vs main
+/ecc:astra-review --commit HEAD # one commit
+/ecc:astra-review Focus on the SQL layer # free text becomes extra reviewer instructions
+```
+
+Plugin commands carry the `ecc:` prefix. With a manual (non-plugin) install the command is `/astra-review`.
+
+Every invocation is your consent to send that diff to OpenAI. Do not run it on code you are not allowed to share. To see exactly what would leave the machine, run the script with `--dry-run` (see below).
+
+## Scopes
+
+| Flag | Reviews | Use it for |
+|------|---------|------------|
+| (none) | index vs HEAD, working tree vs index, untracked files | the default while coding |
+| `--base <branch>` | merge-base of `<branch>` and HEAD → working tree, plus untracked | a whole branch before a PR |
+| `--commit <rev>` | one commit against its first parent (`HEAD~1`, `abc123`, merge and root commits work) | auditing history |
+| `--files <paths…>` | current contents of explicit files | targeted questions |
+| `--files-from-commit <rev>` | current contents of every path `<rev>` touched; paths still deleted are shown as deletions | repair rounds after a `--commit` review |
+
+Diffs over 200 KB are truncated. The reviewer is then given exact git commands to recover the omitted sections for that revision, so a truncated review still judges the right code.
+
+## Running the script directly
+
+The command is a thin workflow around `scripts/astra-review.js` (under the plugin root, or `./scripts/` in the ECC repo). Run it from the reviewed project's directory so git sees that project.
+
+```bash
+node "$ECC/scripts/astra-review.js" --dry-run # print the prompt, send nothing
+node "$ECC/scripts/astra-review.js" --consent-to-openai --base main # review, markdown report on stdout
+node "$ECC/scripts/astra-review.js" --consent-to-openai --json \
+ --output "$(mktemp -d)/astra.json" # JSON for tooling, saved 0600
+```
+
+| Option | Meaning |
+|--------|---------|
+| `--consent-to-openai` | required to send anything (or `ECC_ASTRA_CONSENT=1`) |
+| `--dry-run` | print the prompt and exit 0 without calling Codex |
+| `--model <slug>` | reviewer model, default `gpt-6-astra` (or `ECC_ASTRA_MODEL`) |
+| `--timeout-seconds <30-900>` | Codex timeout, default 300 |
+| `--instructions "<text>"` | extra reviewer instructions appended to the rubric |
+| `--output <file>` | also write the JSON verdict to `<file>` (atomic, owner-only) |
+| `--json` | print JSON instead of the markdown report |
+
+Exit codes: `0` PASS or nothing to review, `1` FAIL (any CRITICAL or HIGH finding), `2` usage or runtime error.
+
+## Reading the verdict
+
+The markdown report has a verdict line with severity counts, a summary, the findings (severity, `file:line`, title, detail, suggestion), and the rubric table. The JSON payload has the same data:
+
+```json
+{
+ "model": "gpt-6-astra",
+ "scope": "uncommitted changes",
+ "files": ["src/a.js"],
+ "verdict": "FAIL",
+ "review": {
+ "verdict": "FAIL",
+ "summary": "…",
+ "checks": [{ "criterion": "Security", "result": "FAIL", "detail": "…" }],
+ "findings": [{ "severity": "HIGH", "file": "src/a.js", "line": 12, "title": "…", "detail": "…", "suggestion": "…" }]
+ }
+}
+```
+
+The eight rubric criteria are Correctness, Security, Error handling, Input validation, Completeness, No regressions, Tests, and Maintainability. A response that skips a criterion or is otherwise malformed is rejected, never treated as a PASS. The gate is `FAIL` whenever a CRITICAL or HIGH finding exists, even if the reviewer wrote `PASS`.
+
+## The fix loop
+
+1. Claude shows every CRITICAL and HIGH finding and verifies each against the code. Astra can be wrong; false positives are skipped with a one-line reason.
+2. Confirmed findings are fixed, nothing else. Tests run.
+3. The review runs again with a fresh reviewer. Default and `--base` scopes already include the repairs. After a `--commit` review the repair round uses `--files-from-commit <rev>`.
+4. After three rounds with CRITICAL/HIGH findings left, the loop stops and hands you the list. Nothing is pushed.
+
+Astra tends to keep finding real but narrower edge cases on each round. Treat the third-round list as input for your own judgement rather than a reason to loop forever.
+
+## Gating a push
+
+Run the review before pushing and refuse on exit code 1:
+
+```bash
+node "$ECC/scripts/astra-review.js" --consent-to-openai --base main && git push
+```
+
+Or as a `pre-push` hook (opt-in, since it sends code to OpenAI and takes a few minutes):
+
+```bash
+#!/usr/bin/env sh
+ECC="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+exec node "$ECC/scripts/astra-review.js" --consent-to-openai --base "$(git rev-parse --abbrev-ref origin/HEAD | sed 's#origin/##')"
+```
+
+For two independent reviewers (Claude Opus plus Astra) use `/santa-loop`.
+
+## What leaves the machine, and what does not
+
+Sent to OpenAI: the diff or file contents in scope, the file list, the rubric, and your extra instructions. Codex may additionally read files in the repository through its read-only tools.
+
+Kept out:
+
+- Environment variables other than PATH/HOME-style ones (`OPENAI_API_KEY`, tokens, and similar are never passed).
+- MCP servers: every server reported by `codex mcp list` is disabled by name with an inert transport, and the user-level Codex config is not loaded. An empty `mcp_servers` table would not clear inherited servers, which is why each one is named.
+- Web search (disabled for the reviewer).
+- Files outside the repository: symlinks are serialized as `(symlink -> target)` instead of followed, and paths whose resolved parent directory leaves the repository are refused.
+- Writes: the sandbox is read-only and approvals are never requested.
+
+Patches are collected with `--no-ext-diff --no-textconv`, so a configured external diff tool cannot blank them.
+
+## Troubleshooting
+
+| Symptom | Cause and fix |
+|---------|---------------|
+| `Unknown command: /astra-review` | Plugin commands are namespaced: use `/ecc:astra-review`. If that is unknown too, the installed plugin predates the command; reinstall it (see Plugin freshness). |
+| `Codex CLI is not installed` | Install `@openai/codex` and make sure `codex` is on PATH. On Windows the npm shim is resolved to its JavaScript entry point automatically. |
+| `Codex review failed: … model …` | `gpt-6-astra` is not available on the account. Pick another model with `ECC_ASTRA_MODEL` or `--model`. |
+| `cannot isolate MCP server name "a.b"` | Codex cannot disable a server whose name contains a dot; rename it in the Codex config or disable it there first. |
+| `Codex review timed out` | Raise `--timeout-seconds` (max 900) or narrow the scope. |
+| `Nothing to review` | The scope is empty. Stage or save changes, or pick another scope. |
+| `MCP servers could not be listed` | `codex mcp list` failed, so isolation cannot be guaranteed and the review refuses to run. Fix the Codex config, then retry. |
+| Review says the diff is complete but a file is missing | Untracked nested repositories (`dir/`) are listed but not diffed; review them from inside that repository. |
+
+## Limits
+
+- One reviewer model per run. Model diversity beyond Claude plus Astra is out of scope; use `/santa-loop` or `/council` for more.
+- Reviews take a few minutes and consume ChatGPT usage on the Codex side.
+- Windows support is implemented (npm shim, `Path`, native paths) but is verified only by tests, not on hardware.
diff --git a/docs/ja-JP/ASTRA-REVIEW-GUIDE.md b/docs/ja-JP/ASTRA-REVIEW-GUIDE.md
new file mode 100644
index 000000000..5aaa46245
--- /dev/null
+++ b/docs/ja-JP/ASTRA-REVIEW-GUIDE.md
@@ -0,0 +1,165 @@
+# Astra Review ガイド
+
+`/astra-review` は、Claude Code で書いたコードを **GPT-6-Astra**(OpenAI)に渡して、プロバイダーをまたいだ独立レビューを受けるコマンドです。書き込みは常に Claude が行い、Astra は構造化された判定だけを返します(パッチは返しません)。このガイドではセットアップ、日常の使い方、プッシュのゲート化、トラブルシューティングを扱います。コマンドの仕様は [`commands/astra-review.md`](./commands/astra-review.md) を参照してください。
+
+## 仕組み
+
+```text
+Claude Code Codex CLI(読み取り専用サンドボックス) OpenAI
+----------- ------------------------------------ ------
+git diff / ファイル内容 ------> codex exec -m gpt-6-astra -------------> GPT-6-Astra
+ルーブリック + JSON スキーマ Web 検索オフ、MCP オフ、
+ ユーザー設定は読み込まない <------------- JSON 判定
+Markdown レポート + 終了コード <-- --output-schema で形式を強制
+Claude が CRITICAL/HIGH を修正して再実行(最大 3 ラウンド)、残りはユーザーへ
+```
+
+レビュアーが見るのは差分、ルーブリック、そして Codex の読み取り専用ツール越しのリポジトリだけです。Claude との会話は見えないので、書いた側の思い込みを共有しません。
+
+## 前提条件
+
+| 要件 | 確認方法 |
+|------|----------|
+| Codex CLI がインストール済み | `codex --version`(導入: `npm i -g @openai/codex`) |
+| ChatGPT でログイン済み | 一度 `codex login`。`~/.codex/auth.json` に `"auth_mode": "chatgpt"` がある |
+| アカウントで `gpt-6-astra` が使える | `codex` を開いてモデル選択に出るか確認。出なければ `ECC_ASTRA_MODEL` で別モデルを指定 |
+| ECC の `commands-core` が入っている | コマンド一覧に `/ecc:astra-review` が出る |
+
+OpenAI の API キーは不要です。環境変数に入っていてもレビュアーのプロセスには**渡しません**。
+
+### プラグインの鮮度
+
+Claude Code のプラグインキャッシュは ECC のバージョン番号で管理されるため、ECC のチェックアウトを編集してもインストール済みのコピーは更新されません。ECC を更新したあと `/ecc:astra-review` が unknown と言われる場合は、プラグインを入れ直して(または `.claude-plugin/plugin.json` のバージョンを上げて)セッションを再起動してください。
+
+```bash
+claude plugin uninstall ecc@ecc && claude plugin install ecc@ecc
+```
+
+## クイックスタート
+
+```text
+/ecc:astra-review # コミットされていない変更(staged + unstaged + 未追跡)
+/ecc:astra-review --base main # このブランチの main との差分すべて
+/ecc:astra-review --commit HEAD # 1 コミット
+/ecc:astra-review SQL 層を重点的に見て # 自由記述はレビュアーへの追加指示になる
+```
+
+プラグイン経由のコマンドには `ecc:` の接頭辞が付きます。手動インストールの場合は `/astra-review` です。
+
+コマンドを実行することが、その差分を OpenAI に送ることへの同意になります。共有が許されないコードには使わないでください。何が外に出るかを事前に見たいときは、後述のスクリプトを `--dry-run` で実行します。
+
+## スコープ
+
+| フラグ | レビュー対象 | 用途 |
+|--------|--------------|------|
+| (なし) | index と HEAD の差分、作業ツリーと index の差分、未追跡ファイル | コーディング中のデフォルト |
+| `--base <branch>` | `<branch>` と HEAD のマージベース → 作業ツリー、加えて未追跡ファイル | PR 前にブランチ全体を見る |
+| `--commit <rev>` | 1 コミットを第一親と比較(`HEAD~1`、`abc123`、マージ/ルートコミットも可) | 履歴の監査 |
+| `--files <paths…>` | 指定ファイルの現在の内容 | 的を絞った質問 |
+| `--files-from-commit <rev>` | `<rev>` が触った全パスの現在の内容。削除されたままのパスは削除として提示 | `--commit` レビュー後の修正ラウンド |
+
+200 KB を超える差分は切り詰められます。その場合レビュアーには、そのリビジョンの省略部分を復元する git コマンドを渡すので、切り詰められても正しいコードを判定します。
+
+## スクリプトを直接使う
+
+コマンドは `scripts/astra-review.js`(プラグインルート配下、ECC リポジトリ内なら `./scripts/`)を包んだ薄いワークフローです。git がレビュー対象を見られるよう、対象プロジェクトのディレクトリで実行してください。
+
+```bash
+node "$ECC/scripts/astra-review.js" --dry-run # プロンプトを表示するだけ。送信しない
+node "$ECC/scripts/astra-review.js" --consent-to-openai --base main # レビュー実行。Markdown を標準出力へ
+node "$ECC/scripts/astra-review.js" --consent-to-openai --json \
+ --output "$(mktemp -d)/astra.json" # ツール向け JSON。0600 で保存
+```
+
+| オプション | 意味 |
+|------------|------|
+| `--consent-to-openai` | 送信に必須(または `ECC_ASTRA_CONSENT=1`) |
+| `--dry-run` | プロンプトを表示して Codex を呼ばずに終了(終了コード 0) |
+| `--model <slug>` | レビュアーのモデル。既定は `gpt-6-astra`(または `ECC_ASTRA_MODEL`) |
+| `--timeout-seconds <30-900>` | Codex のタイムアウト。既定 300 |
+| `--instructions "<text>"` | ルーブリックに追加するレビュアーへの指示 |
+| `--output <file>` | JSON 判定を `<file>` にも書く(アトミック、所有者のみ読める) |
+| `--json` | Markdown の代わりに JSON を出力 |
+
+終了コード: `0` は PASS またはレビュー対象なし、`1` は FAIL(CRITICAL か HIGH がある)、`2` は使い方またはランタイムのエラー。
+
+## 判定の読み方
+
+Markdown レポートには、重大度別の件数付き判定行、要約、指摘(重大度、`file:line`、タイトル、詳細、提案)、ルーブリック表が含まれます。JSON も同じ内容です。
+
+```json
+{
+ "model": "gpt-6-astra",
+ "scope": "uncommitted changes",
+ "files": ["src/a.js"],
+ "verdict": "FAIL",
+ "review": {
+ "verdict": "FAIL",
+ "summary": "…",
+ "checks": [{ "criterion": "Security", "result": "FAIL", "detail": "…" }],
+ "findings": [{ "severity": "HIGH", "file": "src/a.js", "line": 12, "title": "…", "detail": "…", "suggestion": "…" }]
+ }
+}
+```
+
+ルーブリックは Correctness、Security、Error handling、Input validation、Completeness、No regressions、Tests、Maintainability の 8 項目です。項目が欠けた応答や形式不正の応答は拒否され、PASS 扱いにはなりません。レビュアーが `PASS` と書いていても、CRITICAL か HIGH の指摘があればゲートは `FAIL` です。
+
+## 修正ループ
+
+1. Claude が CRITICAL と HIGH の指摘をすべて表示し、コードと照合します。Astra が間違うこともあるので、誤検知は理由を一行添えてスキップします。
+2. 確認できた指摘だけを修正し、テストを実行します。
+3. 新しいレビュアーで再実行します。デフォルトと `--base` のスコープは修正を自動的に含みます。`--commit` レビューの後は `--files-from-commit <rev>` で修正ラウンドを回します。
+4. 3 ラウンド経っても CRITICAL/HIGH が残る場合はループを止め、一覧をユーザーに渡します。プッシュはしません。
+
+Astra はラウンドを重ねるほど、実在するがより狭いエッジケースを見つけ続ける傾向があります。3 ラウンド目の一覧は、延々と回し続ける理由ではなく、自分で判断するための材料として扱ってください。
+
+## プッシュをゲートする
+
+プッシュ前にレビューを実行し、終了コード 1 なら止めます。
+
+```bash
+node "$ECC/scripts/astra-review.js" --consent-to-openai --base main && git push
+```
+
+`pre-push` フックにする場合(コードを OpenAI に送り数分かかるので、必ず明示的に有効化してください):
+
+```bash
+#!/usr/bin/env sh
+ECC="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude}"
+exec node "$ECC/scripts/astra-review.js" --consent-to-openai --base "$(git rev-parse --abbrev-ref origin/HEAD | sed 's#origin/##')"
+```
+
+独立したレビュアーを 2 つ(Claude Opus と Astra)使いたい場合は `/santa-loop` を使います。
+
+## 外に出るもの、出ないもの
+
+OpenAI に送られるもの: スコープ内の差分またはファイル内容、ファイル一覧、ルーブリック、追加指示。加えて Codex は読み取り専用ツールでリポジトリ内のファイルを読むことがあります。
+
+出ないもの:
+
+- PATH/HOME 系以外の環境変数(`OPENAI_API_KEY` やトークン類は渡しません)。
+- MCP サーバー: `codex mcp list` が報告するサーバーをすべて名前指定で無効化(無害なトランスポートを添えて)し、ユーザーレベルの Codex 設定は読み込みません。空の `mcp_servers` テーブルでは継承したサーバーを消せないため、個別に名前を挙げています。
+- Web 検索(レビュアー側で無効)。
+- リポジトリ外のファイル: シンボリックリンクは追わずに `(symlink -> target)` として表現し、解決後の親ディレクトリがリポジトリ外に出るパスは拒否します。
+- 書き込み: サンドボックスは読み取り専用で、承認要求も発生しません。
+
+差分は `--no-ext-diff --no-textconv` 付きで取得するので、外部 diff ツールの設定で中身が空になることはありません。
+
+## トラブルシューティング
+
+| 症状 | 原因と対処 |
+|------|------------|
+| `Unknown command: /astra-review` | プラグインのコマンドには名前空間が付きます。`/ecc:astra-review` を使ってください。それも unknown なら、インストール済みプラグインがこのコマンドより古いので入れ直します(「プラグインの鮮度」参照)。 |
+| `Codex CLI is not installed` | `@openai/codex` を入れて `codex` を PATH に通します。Windows では npm のシムから JavaScript のエントリポイントを自動で解決します。 |
+| `Codex review failed: … model …` | アカウントで `gpt-6-astra` が使えません。`ECC_ASTRA_MODEL` か `--model` で別モデルを指定してください。 |
+| `cannot isolate MCP server name "a.b"` | 名前にドットを含むサーバーは Codex 側で無効化できません。Codex の設定で名前を変えるか、そこで無効化してください。 |
+| `Codex review timed out` | `--timeout-seconds` を上げる(最大 900)か、スコープを狭めてください。 |
+| `Nothing to review` | スコープが空です。変更をステージまたは保存するか、別のスコープを選んでください。 |
+| `MCP servers could not be listed` | `codex mcp list` が失敗したため隔離を保証できず、レビューを拒否しています。Codex の設定を直してから再実行してください。 |
+| 差分は完全と言われるのにファイルが足りない | 未追跡のネストしたリポジトリ(`dir/`)は一覧に載りますが差分は取りません。そのリポジトリの中からレビューしてください。 |
+
+## 制限
+
+- 1 回の実行で使えるレビュアーモデルは 1 つです。Claude と Astra 以外のモデル多様性が必要なら `/santa-loop` や `/council` を使ってください。
+- レビューには数分かかり、Codex 側で ChatGPT の利用枠を消費します。
+- Windows 対応(npm シム、`Path`、ネイティブパス)は実装済みですが、テストでの検証のみで実機では未確認です。
diff --git a/docs/ja-JP/COMMANDS-QUICK-REF.md b/docs/ja-JP/COMMANDS-QUICK-REF.md
index 3312e98b8..985aee168 100644
--- a/docs/ja-JP/COMMANDS-QUICK-REF.md
+++ b/docs/ja-JP/COMMANDS-QUICK-REF.md
@@ -11,6 +11,7 @@
| `/plan` | 要件の再確認、リスク評価、ステップバイステップの実装計画を作成 — **コードに触れる前に確認を待ちます** |
| `/tdd` | テスト駆動開発を強制:インターフェースのスキャフォールド → 失敗するテストの作成 → 実装 → 80%以上のカバレッジを検証 |
| `/code-review` | 変更されたファイルの完全なコード品質、セキュリティ、保守性レビュー |
+| `/astra-review` | Claude が書いたコードを GPT-6-Astra(ChatGPT、Codex CLI 経由)に送って独立レビューを受け、指摘を修正する |
| `/build-fix` | ビルドエラーを検出して修正 — 適切なビルドリゾルバーエージェントに自動的に委任 |
| `/verify` | 完全な検証ループを実行:ビルド → リント → テスト → 型チェック |
| `/quality-gate` | プロジェクト標準に対する品質ゲートチェック |
@@ -36,6 +37,7 @@
| コマンド | 機能 |
|---------|------|
| `/code-review` | ユニバーサルコードレビュー |
+| `/astra-review` | クロスプロバイダーのセカンドオピニオン(GPT-6-Astra) |
| `/python-review` | Python — PEP 8、型ヒント、セキュリティ、慣用的パターン |
| `/go-review` | Go — 慣用的パターン、並行性の安全性、エラーハンドリング |
| `/kotlin-review` | Kotlin — null安全、コルーチン安全、クリーンアーキテクチャ |
diff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.md
index e01e9c11b..0144267e5 100644
--- a/docs/ja-JP/README.md
+++ b/docs/ja-JP/README.md
@@ -64,6 +64,8 @@
| 並列化 | Git ワークツリー、カスケード方法、スケーリング時期 |
| サブエージェント オーケストレーション | コンテキスト問題、反復検索パターン |
+[コマンド クイックリファレンス](./COMMANDS-QUICK-REF.md) | [Astra Review ガイド](./ASTRA-REVIEW-GUIDE.md)(Claude が書いたコードを GPT-6-Astra にレビューさせる)
+
---
## 新機能
diff --git a/docs/ja-JP/commands/astra-review.md b/docs/ja-JP/commands/astra-review.md
index dbf148594..01fe14125 100644
--- a/docs/ja-JP/commands/astra-review.md
+++ b/docs/ja-JP/commands/astra-review.md
@@ -101,3 +101,4 @@ Remaining: [未解決の CRITICAL/HIGH があれば]
- レビュアー側では Web 検索を無効化し、ユーザーレベルの Codex 設定を読み込まず、`codex mcp list` が報告するすべての MCP サーバーを名前指定で無効化します(空の `mcp_servers` テーブルでは無効化されません)。Codex プロセスには PATH / HOME 系の環境変数だけを渡します。環境変数の API キーは転送されません。
- プッシュのゲートにするには `git push` の前に実行し、終了コード 1 ならプッシュしないでください。独立したレビュアーを 2 つ使いたい場合は `/santa-loop` と組み合わせます。
- Codex がない場合は `/code-review` にフォールバックし、クロスプロバイダーレビューが行われなかったことを明示します。
+- 詳しいマニュアル(セットアップ、スコープ、プッシュのゲート化、トラブルシューティング): ECC リポジトリの `docs/ja-JP/ASTRA-REVIEW-GUIDE.md`。