npm - @autodevjapan/godd-mcp-alpha - Versions diffs - 2.6.0 → 2.6.2 - Mend

@autodevjapan/godd-mcp-alpha 2.6.0 → 2.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md +135 -750
package/assets/native/godd-native-aarch64-apple-darwin +0 -0
package/assets/native/godd-native-aarch64-apple-darwin.sha256 +1 -1
package/assets/native/godd-native-x86_64-apple-darwin +0 -0
package/assets/native/godd-native-x86_64-apple-darwin.sha256 +1 -1
package/assets/native/godd-native-x86_64-pc-windows-msvc.exe +0 -0
package/assets/native/godd-native-x86_64-pc-windows-msvc.exe.sha256 +1 -1
package/assets/native/godd-native-x86_64-unknown-linux-musl +0 -0
package/assets/native/godd-native-x86_64-unknown-linux-musl.sha256 +1 -1
package/dist/godd.cjs +107 -107
package/native-assets.json +12 -12
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -10,188 +10,60 @@
 ## English
-AI prompt delivery system for MCP-compatible clients (Cursor IDE, Claude Code CLI, Codex, Kimi CLI, and Google Antigravity IDE). Delivers project-optimized prompts, mindsets, and agent definitions via MCP (Model Context Protocol). The server is client-agnostic — the same `serve` command works with any MCP host. Cursor, Claude Code, Codex, Kimi CLI, and Antigravity are officially supported.
-The npm package remains the primary distribution entry point. `godd-a serve` runs the Rust-native MCP runtime; Node.js is retained for npm lifecycle tasks, native binary installation, and compatibility CLI commands.
-The `config`, `questions`, and `scratchpad` tools invoke the existing Node.js handler only for the duration of that call to preserve diagnostic and storage compatibility; the MCP server itself remains Rust-native.
-For a self-hosted provider gateway, set `GODD_PROVIDER_GATEWAY_URL` and run
-`godd-a gateway doctor`. The Rust runtime validates the URL, probes
-`/health/readiness` with a three-second timeout, and reports the
-`direct-registry` fallback without printing provider credentials. Use
-`--no-probe` to validate configuration without network access.
-Plan interruptions, resumptions, and deviations can be recorded by the Rust runtime with
-`godd-a plan audit record` and verified before resume with
-`godd-a plan audit verify`. Set `GODD_PLAN_AUDIT_KEY` to at least 32 bytes.
-Free-form notes are not accepted, and the key is never written.
-An experimental Rust domain contract can validate explicit `provider:model` routes for
-OpenAI-compatible providers. It does not start an HTTP proxy, read secret values, issue
-virtual keys, or change the MCP runtime. See
-`documents/spec/multi-provider-gateway.md` in the source repository.
-A second experimental Rust domain contract resolves per-model image/PDF capability
-(operator override, then trusted provider metadata, then a safe unknown default) and
-decides whether to pass a content block through, derive text from it under a configured
-policy, or reject it before any provider call — never a silent drop. It performs no OCR,
-vision side-call, or byte persistence itself. See
-`documents/spec/multimodal-capability-normalization.md` in the source repository.
+**GoDD delivers battle-tested development prompts, mindsets, and agent workflows straight into your AI coding client** — Cursor IDE, Claude Code CLI, Codex, Kimi CLI, and Google Antigravity IDE — over the Model Context Protocol (MCP).
-### Installation
-```bash
-npm install -g @autodevjapan/godd-mcp-alpha
-```
-### Setup (Recommended)
-```bash
-# Auto-detect installed MCP clients and register the server with each of them
-godd-a install --license-key=YOUR_LICENSE_KEY
-# Or target a specific client: cursor / claude-code / codex / kimi / antigravity / all
-godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-# Auto-generate project config.godd (interactive)
-godd-a init
-# Or fully automatic mode (for CI/CD)
-godd-a init --auto
-```
-> **Use `godd-a install`.** Manual editing of mcp.json is not recommended.
-> `godd-a install` correctly configures the startup command, PATH, and license key.
-### Manual mcp.json Configuration
-If `godd-a install` is unavailable, you can edit the client's config file directly — `~/.cursor/mcp.json` for Cursor, `~/.gemini/antigravity/mcp_config.json` for Antigravity (both use the well-known `{"mcpServers": {...}}` format). When no known client is detected, `godd-a install` prints this same snippet for manual setup.
-**The `serve` argument is required.** Without it, the installer mode starts and MCP communication breaks.
-```json
-{
-  "mcpServers": {
-    "godd-a": {
-      "command": "npx",
-      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
-      "env": {
-        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
-      }
-    }
-  }
-}
-```
+### Why use GoDD
-### Claude Code CLI Setup
+- **Ship higher-quality code faster.** Every prompt is built on seven proven xDD methodologies (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), so the AI plans, tests, and documents like a senior engineer instead of guessing.
+- **One command per task.** Call `/dev`, `/review`, `/ship`, and more — the AI runs the full plan → implement → test → quality → docs cycle for you.
+- **Fewer tokens, lower cost.** Prompts are delivered **on demand** — only the one you invoke enters the AI's context. That is typically ~2,000–5,000 tokens per call versus ~80,000+ for always-on rule files.
+- **Works with the clients you already use.** The same server registers with every supported client; project settings are auto-detected.
+- **Stays in sync with your stack.** `godd-a init` generates a project profile so delivered prompts match your language, framework, and tooling.
-Register the server into Claude Code CLI with the `--client=claude-code` flag:
-```bash
-godd-a install --client=claude-code --license-key=YOUR_LICENSE_KEY
-```
-This delegates registration to `claude mcp add-json` at **user scope** (`~/.claude.json`), so it merges safely alongside your other MCP servers and is re-runnable (an existing entry is refreshed). When the `claude` CLI is not on your PATH, the installer prints the exact command to run by hand instead.
-Without `--client`, `godd-a install` auto-detects locally installed clients and registers with all of them (if none is detected, it prints a generic `mcpServers` snippet for manual setup). The startup command, args, and env are identical across clients, and the license device binding is per-device.
+### Requirements
-<details>
-<summary>Manual registration (if you prefer not to use <code>godd-a install</code>)</summary>
+- **A GoDD license key** (required — see [Getting a license key](#getting-a-license-key))
+- Node.js 22+
+- An MCP-compatible client: Cursor IDE, Claude Code CLI, Codex, Kimi CLI, or Antigravity IDE
-```bash
-claude mcp add godd-a \
-  --env GODD_LICENSE_KEY=GODD-XXXX-XXXX \
-  -- npx -y @autodevjapan/godd-mcp-alpha@latest serve
-```
+### Getting a license key
-Or add a project-root `.mcp.json` with the same `mcpServers` structure shown above (the `serve` argument is required).
-</details>
+A valid license key is required to use GoDD MCP.
-### Codex Setup
+1. Review plans on the [GoDD official site](https://www.getgodd.dev/pricing)
+2. [Create an account](https://www.getgodd.dev/godd-admin/register) and choose a subscription
+3. Issue a license key from your [dashboard](https://www.getgodd.dev/godd-admin/dashboard)
-Register through Codex's official MCP CLI. Codex CLI, the IDE extension, and the app share this MCP configuration:
+### Installation
 ```bash
-godd-a install --client=codex --license-key=YOUR_LICENSE_KEY
+npm install -g @autodevjapan/godd-mcp-alpha
 ```
-Verify with `codex mcp list` or `/mcp`. Remove it with `godd-a uninstall --client=codex`.
-### Kimi CLI Setup
-Register through Kimi CLI's official MCP command:
+### Setup
 ```bash
-godd-a install --client=kimi --license-key=YOUR_LICENSE_KEY
-```
-This delegates registration to `kimi mcp add --transport stdio` (environment variables are passed with `-e KEY=VALUE`). When the `kimi` CLI is not on your PATH, the installer prints the exact command to run by hand. Verify with `/mcp` inside a Kimi CLI session. Remove it with `godd-a uninstall --client=kimi`.
-### Antigravity Setup
+# Auto-detect installed MCP clients and register with each of them
+godd-a install --license-key=YOUR_LICENSE_KEY
-Register into Google Antigravity IDE's MCP config file:
+# Or target one client: cursor / claude-code / codex / kimi / antigravity / all
+godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-```bash
-godd-a install --client=antigravity --license-key=YOUR_LICENSE_KEY
+# Generate a project config (interactive; add --auto for CI/CD)
+godd-a init
 ```
-This merges the well-known `{"mcpServers": {...}}` entry into `~/.gemini/antigravity/mcp_config.json` without touching other server entries. Remove it with `godd-a uninstall --client=antigravity`.
+> Use `godd-a install` — it configures the startup command, PATH, and license key for you. Restart your client afterward and the GoDD tools appear automatically.
 ### Usage
-After installation, restart your MCP client (Cursor IDE, Claude Code CLI, Codex, Kimi CLI, or Antigravity) and the GoDD MCP α server will start automatically. There are three ways to invoke GoDD tools:
-**Option 1 — Your client's native UI:** Use whatever your client surfaces for MCP prompts/tools — for example, in Cursor type `/` in the chat input and pick a GoDD prompt from the dropdown (`/dev`, `/review`), or in Agent mode ask in plain language ("run dev", "do a review") and the AI calls the matching tool.
-**Option 2 — Native slash commands (generated at install):** `godd-a install` writes `godd-a-<tool>.md` command files into clients that support user-defined commands — Cursor (`~/.cursor/commands/`), Claude Code (`~/.claude/commands/`), Codex (`$CODEX_HOME/prompts` or `~/.codex/prompts/`, loaded at session start), and Antigravity (`~/.gemini/antigravity/workflows/` — community-sourced location, not yet officially confirmed). Invoke them as `/godd-a-dev`, `/godd-a-review`, etc. — client command names cannot contain `/` or `:`, hence the dash form. Kimi CLI has no custom slash-command support, so no files are generated for it.
-**Option 3 — Text dispatch via the `run` tool:** Type `/godd-a/dev <args>` as plain text in the chat. The always-loaded dispatch rules (the AGENTS.md GoDD block and `.cursor/rules/godd-stack.mdc`, regenerated by the `config` tool (via chat) or `godd-a init`) instruct the AI to pass the full text to the GoDD MCP `run` tool, which parses every notation — `/godd-a/<tool>`, `godd-a/<tool>`, `/godd-a:<tool>`, `/godd-a_<tool>`, `mcp__godd-a__<tool>`, or a bare `/<tool>` — and runs the matching tool.
-### Token Efficiency
+Invoke GoDD in whichever way your client supports:
-GoDD MCP delivers prompts **on demand** — only the prompt you call is sent to the AI's context. This is fundamentally different from Cursor Rules, which loads all rules into every conversation from the start.
+- **Native UI** — type `/` in the chat and pick a GoDD prompt (e.g. `/dev`, `/review`), or in Agent mode just ask ("run dev", "do a review").
+- **Slash commands** — `godd-a install` writes `/godd-a-<tool>` command files for clients that support them (Cursor, Claude Code, Codex, Antigravity).
+- **Text dispatch** — type `/godd-a/dev <args>` as plain text; the AI routes it to the matching tool.
-| Approach | How it works | Token cost per call |
-|---|---|---|
-| **Plain Cursor (no GoDD)** | No structured prompts; agent uses more iterations | ~80,000+ tokens per task |
-| **GoDD MCP** | Optimized prompts delivered on demand | ~2,000–5,000 tokens per call |
-Use `/metrics` at any time during a session to see your actual token usage and estimated savings. Savings are measured empirically via benchmarks comparing GoDD-guided vs. unguided Cursor sessions.
-The optional `quality_evidence` JSON argument also produces a reproducible
-assessment of excessive output, execution completion, and design integrity.
-Missing evidence is reported as `INCONCLUSIVE`, not guessed as a failure.
-The optional `learning_evidence` accepts numeric and boolean aggregates only,
-and deterministically assesses learning outcomes and claim grounding. Empty or
-incomplete evidence is `INCONCLUSIVE`; do not include raw text or secrets.
-### GoDD Token Killer (godd-tk)
-**Bundled CLI proxy for additional token savings on command output — measured 88.1% weighted-average est. reduction on the bundled benchmark (0–94% by command shape).**
-godd-tk intercepts shell commands executed by AI agents and compresses their output before it reaches the LLM. It is automatically installed alongside GoDD MCP via `npm postinstall`.
-```
-AI Agent → Shell("git status") → godd-tk → compressed output → AI Agent
-```
-| Feature | Description |
-|---|---|
-| Output filtering | Strips ANSI codes, noise lines, and verbose formatting |
-| Statistical compression | Typed compressors (log / json / diff / test-report / generic-text) fold repetitive output while keeping errors and failure details intact |
-| Reversible compression (CCR) | Raw output is stored locally in full before compression — recover it anytime with `godd-tk show <id>` |
-| Usage analytics | Tracks tokens saved per command with built-in SQLite |
-| Auto-install | Downloaded automatically on `npm install` |
-Run `godd-tk gain` to see cumulative token savings.
-Automatic compression hooks are currently configured only for Cursor. Other MCP
-clients remain usable without compression and can opt in with
-`godd-tk exec -- <command>`. Run `godd-a compatibility` for the implementation-backed
-matrix; real-client OS checks are shown as `unverified` until smoke-test evidence exists.
-### GoDD Prompts
-Available GoDD prompts (MCP tools):
+### GoDD prompts
 | Prompt | Description |
 |---|---|
@@ -212,141 +84,61 @@ Available GoDD prompts (MCP tools):
 | `release` | Generate release notes (SemVer-compliant) |
 | `github` | GitHub configuration (repository/branch protection etc.) |
 | `config` | Generate/repair config.godd (auto-detect stack + validation) |
-| `questions` | Manage question list (質問リスト.md) interactively |
+| `questions` | Manage the question list interactively |
 | `e2e` | Browser-based E2E testing (execute & verify critical user flows) |
 | `map` | Project knowledge graph (visualize architecture & dependencies with Mermaid) |
 | `learn` | Save/recall project-specific patterns, conventions, and pitfalls |
-| `scratchpad` | Persistent conversation memory — save/recall/search/list/forget with BM25 vector search |
-| `diagram` | Auto-update architecture diagrams (maintain living Mermaid docs in sync with code) |
-| `slide` | Generate presentation slides from project docs (Marp Markdown format) |
-| `design` | Generate/update visual designs from codebase (Pencil.dev sync) |
-| `metrics` | Token efficiency report — show prompt tokens delivered this session vs. unguided Cursor baseline (benchmark-based) |
+| `scratchpad` | Persistent conversation memory (save/recall/search/list/forget) |
+| `diagram` | Auto-update architecture diagrams (living Mermaid docs in sync with code) |
+| `slide` | Generate presentation slides from project docs (Marp Markdown) |
+| `design` | Generate/update visual designs from the codebase |
+| `metrics` | Token efficiency report for the current session |
-### CLI Commands
+### CLI commands
 | Command | Description |
 |---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | Register with MCP clients (`cursor` / `claude-code` / `codex` / `kimi` / `antigravity` / `all`; auto-detects installed clients when omitted) |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | Generate project config.godd |
-| `godd-a uninstall [--client=...]` | Remove from MCP clients (same `--client` resolution as install) |
-| `godd-a compatibility` | Print the implementation-backed godd-tk client compatibility matrix |
-| `godd-a codec-capability verify [...]` | Verify codec manifest, artifact, runtime probe, and known answers in packaged Rust |
-| `godd-a plan audit <record\|verify> [...]` | Record or verify tamper-evident plan interruption/resume/deviation evidence |
-| `godd-a research <action> [options]` | Persist/resume an anonymized research checkpoint in Rust (no search or LLM calls) |
-| `godd-a serve` | Start MCP stdio server (auto-invoked by the client) |
-| `godd-a --version` / `godd-a -v` | Show installed version |
-### Scratchpad (Persistent Memory)
-GoDD includes a scratchpad system for storing and retrieving conversation memories across sessions.
-Docker Desktop is auto-started when GoDD MCP launches (if installed). For manual setup:
-```bash
-# Start Qdrant for vector search (optional — works without it via local JSON fallback)
-cd godd-mcp-alpha && docker compose up -d
-```
-| Action | Example | Description |
-|---|---|---|
-| `save` | `scratchpad save Auth flow uses JWT + refresh tokens` | Store a memory, returns a `mem::` address |
-| `recall` | `scratchpad recall mem::godd::abc123` | Retrieve full content by address |
-| `search` | `scratchpad search authentication` | BM25 search, returns top 5 matches |
-| `list` | `scratchpad list` | Show all saved memories |
-| `forget` | `scratchpad forget mem::godd::abc123` | Delete a memory |
-Without Docker/Qdrant, the scratchpad falls back to `.godd/scratchpad.json` with keyword-based search.
-### Getting a License Key
-A license key is required to use GoDD MCP. Follow these steps:
-1. Check plans at the [GoDD official site](https://www.getgodd.dev/pricing)
-2. [Register an account](https://www.getgodd.dev/godd-admin/register) and purchase a subscription
-3. Issue a license key from your [dashboard](https://www.getgodd.dev/godd-admin/dashboard)
-Set the issued license key with `godd-a install --license-key=YOUR_KEY`.
-### Requirements
-- Node.js 22+
-- An MCP-compatible client — Cursor IDE, Claude Code CLI, Codex, Kimi CLI, or Antigravity IDE
-- GoDD license key (get one at [official site](https://www.getgodd.dev/pricing))
+| `godd-a install [--license-key=KEY] [--client=...]` | Register with MCP clients (auto-detects installed clients when `--client` is omitted) |
+| `godd-a init [--force] [--lang=LANG] [--auto]` | Generate the project config |
+| `godd-a uninstall [--client=...]` | Remove from MCP clients |
+| `godd-a version` (or `--version` / `-v`) | Show the installed version and check for updates |
+| `godd-a serve` | Start the MCP stdio server (auto-invoked by the client) |
 ### Troubleshooting
-#### "0 tools available" is shown
-If Cursor's MCP log shows errors like:
-```
-Unexpected end of JSON input
-Unexpected token 'G', "GoDD MCP α"... is not valid JSON
-```
-**Cause**: `mcp.json` `args` does not include `"serve"`. Without it, the installer mode starts (human-readable text output) and breaks the JSON-RPC communication Cursor expects.
-**Fix**:
-```bash
-# Reinstall to regenerate mcp.json correctly
-npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY
-```
-Then restart Cursor.
-#### License key is bound to another device
-GoDD license keys are bound to a device. To use on a different device, issue a new license key.
-```bash
-godd-a install --license-key=NEW_LICENSE_KEY
-```
+**"0 tools available" in your client** — this means the server was started without the required `serve` argument. Re-run `godd-a install` to regenerate the client config correctly, then restart the client.
 ### License
-Proprietary — A GoDD license key is required. Purchase at the [official site](https://www.getgodd.dev/pricing).
+Proprietary. Use requires a valid GoDD license key. See the [official site](https://www.getgodd.dev/) for terms and support.
 ---
-### Version 2 migration and rollback
+## 日本語
-Version 2 keeps the package name, `npx`/global installation, `godd-a` binary, MCP key,
-stdio transport, tools, config, and persisted-state formats. The Rust runtime is now executed
-directly from the npm package. All four supported native assets are integrity-checked against a
-committed digest/size manifest; installation never requires GitHub authentication, `gh`, or an
-additional runtime download. Missing, tampered, unsupported, or version-mismatched assets fail
-closed without a Node MCP fallback. Linux x64 uses a static musl binary with no glibc runtime
-dependency; MCP smoke is verified on Debian Bookworm and Alpine.
+**GoDD は、実戦で磨かれた開発プロンプト・マインドセット・エージェントワークフローを、お使いの AI コーディングクライアントに直接届けます** — Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Google Antigravity IDE に、MCP（Model Context Protocol）経由で配信します。
-Upgrade with `npm install -g @autodevjapan/godd-mcp-alpha@2.0.0`. Existing MCP configuration
-does not change. Roll back explicitly with
-`npm install -g @autodevjapan/godd-mcp-alpha@1.46.3`. `godd-tk` is a separate optional
-capability; opt in with `GODD_INSTALL_GODD_TK=1`.
+### GoDD を使うメリット
-## 日本語
+- **より高品質なコードを、より速く。** すべてのプロンプトは実証済みの 7 つの xDD 手法（Spec / 受入テスト / テスト / ドメイン / Neo-Model / ドキュメント / Issue 駆動開発）に基づいており、AI が推測ではなくシニアエンジニアのように計画・テスト・文書化します。
+- **1 タスク = 1 コマンド。** `/dev` `/review` `/ship` などを呼ぶだけで、計画 → 実装 → テスト → 品質 → ドキュメントの一連のサイクルを AI が実行します。
+- **トークン削減でコストも低減。** プロンプトは**オンデマンド配信** — 呼び出したものだけが AI のコンテキストに入ります。常時読み込み型のルールファイルが 1 タスク ~80,000 トークン以上かかるのに対し、GoDD は 1 呼び出しあたり ~2,000〜5,000 トークン程度です。
+- **今お使いのクライアントでそのまま。** 同じサーバーが対応クライアントすべてに登録でき、プロジェクト設定は自動検出されます。
+- **スタックに追従。** `godd-a init` がプロジェクトプロファイルを生成し、配信されるプロンプトが言語・フレームワーク・ツールに合わせて最適化されます。
-MCP 対応クライアント（Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Antigravity IDE）向けの AI プロンプト配信システム。MCP (Model Context Protocol) を通じて、プロジェクトの技術スタックに最適化されたプロンプト・マインドセット・エージェント定義を提供します。サーバー本体はクライアント非依存で、Cursor、Claude Code、Codex、Kimi CLI、Antigravity を正式サポートします。
+### 動作要件
-npmパッケージを主要配布入口として維持し、`godd-a serve`はRustネイティブMCP実行本体を起動します。Node.jsはnpmライフサイクル、ネイティブバイナリ導入、互換CLIに限定して使用します。
-`config`、`questions`、`scratchpad`は診断・保存形式の互換性を保つため、呼び出し中だけ既存Node.jsハンドラを実行します。MCPサーバー本体はRustのままです。
+- **GoDD ライセンスキー**（必須 — [ライセンスキーの取得](#ライセンスキーの取得)を参照）
+- Node.js 22 以上
+- MCP 対応クライアント: Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Antigravity IDE のいずれか
-計画の中断・再開・逸脱は Rust 実装の `godd-a plan audit record` で記録し、
-再開前に `godd-a plan audit verify` で検証できます。32 bytes 以上の
-`GODD_PLAN_AUDIT_KEY` が必要です。自由記述は受け付けず、鍵は監査ログへ
-出力されません。
+### ライセンスキーの取得
-実験的なRust domain contractとして、OpenAI互換providerの明示的な
-`provider:model` routeを検証できます。HTTP proxyの起動、秘密値の読取、仮想キー発行、
-既存MCP runtimeの変更は行いません。詳細はソースリポジトリの
-`documents/spec/multi-provider-gateway.md` を参照してください。
+GoDD MCP の利用には有効なライセンスキーが必要です。
-もう一つの実験的なRust domain contractは、model単位のimage/PDF capability
-（operator override → trusted provider metadata → 安全な既定値の順）を解決し、
-content blockをpassthrough・設定済みpolicyによるtext derive・provider呼出し前の
-型付きrejectのいずれかへ決定します（silent dropはしません）。OCR・vision
-side-call・byte永続化は行いません。詳細はソースリポジトリの
-`documents/spec/multimodal-capability-normalization.md` を参照してください。
+1. [GoDD 公式サイト](https://www.getgodd.dev/pricing)でプランを確認
+2. [アカウント登録](https://www.getgodd.dev/godd-admin/register)してサブスクリプションを選択
+3. [ダッシュボード](https://www.getgodd.dev/godd-admin/dashboard)からライセンスキーを発行
 ### インストール
@@ -354,155 +146,35 @@ side-call・byte永続化は行いません。詳細はソースリポジトリ
 npm install -g @autodevjapan/godd-mcp-alpha
 ```
-### セットアップ（推奨）
+### セットアップ
 ```bash
-# インストール済みの MCP クライアントを自動検出し、検出された全てに登録
+# インストール済みの MCP クライアントを自動検出し、全てに登録
 godd-a install --license-key=YOUR_LICENSE_KEY
-# 特定のクライアントを指定する場合: cursor / claude-code / codex / kimi / antigravity / all
+# 特定のクライアントを指定: cursor / claude-code / codex / kimi / antigravity / all
 godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-# プロジェクトの config.godd を自動生成（インタラクティブ）
+# プロジェクト設定を生成（インタラクティブ。CI/CD 用は --auto）
 godd-a init
-# または完全自動モード（CI/CD 環境向け）
-godd-a init --auto
-```
-> **`godd-a install` を使ってください。** mcp.json の手動編集は非推奨です。
-> `godd-a install` は起動コマンド・PATH・ライセンスキーを正しく設定します。
-### mcp.json を手動で設定する場合
-`godd-a install` が使えない環境では、クライアントの設定ファイルを直接編集できます（Cursor は `~/.cursor/mcp.json`、Antigravity は `~/.gemini/antigravity/mcp_config.json`。いずれも well-known な `{"mcpServers": {...}}` 形式）。既知のクライアントが1つも検出されない場合、`godd-a install` は手動設定用にこのスニペットを表示します。
-**`serve` 引数は必須です。** 省略するとインストーラーモードで起動し、MCP 通信が破綻します。
-```json
-{
-  "mcpServers": {
-    "godd-a": {
-      "command": "npx",
-      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
-      "env": {
-        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
-      }
-    }
-  }
-}
 ```
-### Claude Code CLI でのセットアップ
-次のコマンドで Claude Code CLI の user scope に登録します。既存設定とのマージは `claude` CLI に委譲されます。
-```bash
-godd-a install --client=claude-code --license-key=YOUR_LICENSE_KEY
-```
-`--client` を省略すると、インストール済みの既知クライアントが自動検出され、見つかった全てに登録されます（1つも検出されない場合は手動設定用の `mcpServers` スニペットを表示）。起動コマンド・引数・環境変数は全クライアントで同一です。
-手動登録する場合:
-```bash
-claude mcp add godd-a \
-  --env GODD_LICENSE_KEY=GODD-XXXX-XXXX \
-  -- npx -y @autodevjapan/godd-mcp-alpha@latest serve
-```
-削除は `godd-a uninstall --client=claude-code` を使用します。
-### Codex でのセットアップ
-Codex 公式 CLI を通して登録します。Codex CLI、IDE extension、app はこの MCP 設定を共有します。
-```bash
-godd-a install --client=codex --license-key=YOUR_LICENSE_KEY
-```
-`codex mcp list` または `/mcp` で確認し、削除は `godd-a uninstall --client=codex` を使用します。
-### Kimi CLI でのセットアップ
-Kimi CLI 公式の MCP コマンドを通して登録します。
-```bash
-godd-a install --client=kimi --license-key=YOUR_LICENSE_KEY
-```
-登録は `kimi mcp add --transport stdio` に委譲されます（環境変数は `-e KEY=VALUE` で付与）。`kimi` CLI が PATH にない場合は、手動実行用のコマンドを表示します。Kimi CLI セッション内の `/mcp` で接続を確認し、削除は `godd-a uninstall --client=kimi` を使用します。
-### Antigravity でのセットアップ
-Google Antigravity IDE の MCP 設定ファイルに登録します。
-```bash
-godd-a install --client=antigravity --license-key=YOUR_LICENSE_KEY
-```
-`~/.gemini/antigravity/mcp_config.json` に well-known な `{"mcpServers": {...}}` エントリをマージします（他のサーバー設定は保持）。削除は `godd-a uninstall --client=antigravity` を使用します。
+> `godd-a install` を使ってください — 起動コマンド・PATH・ライセンスキーを自動で設定します。実行後にクライアントを再起動すると、GoDD ツールが自動的に表示されます。
 ### 使い方
-インストール後、MCP クライアント（Cursor IDE、Claude Code CLI、Codex、Kimi CLI、Antigravity）を再起動すると GoDD MCP α サーバーが自動で起動します。GoDD ツールの呼び出し方法は 3 つあります。
-**方法 1 — クライアントネイティブの UI:** 各クライアントが提供する MCP プロンプト/ツールの UI を使います。例: Cursor ではチャット入力欄で `/` を入力してドロップダウンから GoDD プロンプト（`/dev`、`/review` 等）を選択します。Agent モードで自然言語（「dev して」「レビューして」）で指示しても、AI が該当ツールを自動的に検出して呼び出します。
-**方法 2 — ネイティブスラッシュコマンド（install 時に生成）:** `godd-a install` はカスタムコマンド対応クライアントに `godd-a-<tool>.md` コマンドファイルを生成します — Cursor（`~/.cursor/commands/`）、Claude Code（`~/.claude/commands/`）、Codex（`$CODEX_HOME/prompts` または `~/.codex/prompts/`、セッション開始時にロード）、Antigravity（`~/.gemini/antigravity/workflows/` — コミュニティ情報ベース・公式未確認）。`/godd-a-dev`、`/godd-a-review` のように呼び出します（クライアントのコマンド名には `/` や `:` を使えないためハイフン形式）。Kimi CLI はカスタムスラッシュコマンド非対応のため生成されません。
-**方法 3 — `run` ツールへのテキストディスパッチ:** チャットに `/godd-a/dev <args>` とテキスト入力します。常時ロードされるディスパッチ規則（AGENTS.md の GoDD ブロックと `.cursor/rules/godd-stack.mdc`。`config` ツール（チャット経由）または `godd-a init` で再生成）により、AI が全文を GoDD MCP の `run` ツールに渡し、`run` が `/godd-a/<tool>`、`godd-a/<tool>`、`/godd-a:<tool>`、`/godd-a_<tool>`、`mcp__godd-a__<tool>`、ベア `/<tool>` の各形式をパースして対応ツールを実行します。
-### トークン効率
-GoDD MCP はプロンプトを**オンデマンドで配信**します。呼び出したプロンプトだけが AI のコンテキストに送られます。全ルールを毎会話の開始から常時コンテキストに含める Cursor Rules とは根本的に異なります。
-| 方式 | 仕組み | 1回あたりのトークンコスト |
-|---|---|---|
-| **素の Cursor（GoDD なし）** | 構造化プロンプトなし、エージェントの試行回数が増加 | ~80,000+ tokens / タスク |
-| **GoDD MCP** | 最適化されたプロンプトをオンデマンド配信 | ~2,000〜5,000 tokens / 呼び出し |
-セッション中いつでも `/metrics` を実行すると、実際のトークン使用量と節約推定値を確認できます。節約効果は GoDD 使用時と未使用時の実測ベンチマークで計測されます。
+クライアントが対応している方法で GoDD を呼び出せます。
-任意の `quality_evidence` JSON を渡すと、過剰出力・実行完遂・設計健全性を
-再現可能な計算式で評価できます。証拠不足は失敗と推測せず
-`INCONCLUSIVE` として報告します。
-任意の `learning_evidence` には数値・真偽値の集計値だけを渡し、学習成果と
-主張の根拠性を決定論的に評価できます。空または未完了の証拠は
-`INCONCLUSIVE` です。原文や秘密情報は渡さないでください。
+- **ネイティブ UI** — チャットで `/` を入力して GoDD プロンプト（`/dev`, `/review` など）を選択、または Agent モードで自然文で依頼（「dev を実行」「レビューして」）。
+- **スラッシュコマンド** — `godd-a install` が対応クライアント（Cursor / Claude Code / Codex / Antigravity）に `/godd-a-<tool>` コマンドファイルを生成します。
+- **テキストディスパッチ** — チャットに `/godd-a/dev <args>` と入力すると、AI が対応ツールに振り分けます。
-### GoDD Token Killer (godd-tk)
-**コマンド出力を圧縮し、トークンをさらに削減するバンドル CLI プロキシ。同梱ベンチマークで実測加重平均 88.1%（est.、コマンド種別レンジ 0〜94%）。**
-godd-tk は AI エージェントが実行するシェルコマンドの出力をインターセプトし、LLM に渡す前に圧縮します。`npm install` 時に自動でインストールされます。
-```
-AI エージェント → Shell("git status") → godd-tk → 圧縮済み出力 → AI エージェント
-```
-| 機能 | 説明 |
-|---|---|
-| 出力フィルタリング | ANSI コード、ノイズ行、冗長な書式を除去 |
-| 統計的圧縮 | 型別コンプレッサ（log / json / diff / test-report / generic-text）が反復出力を畳み込み、エラーや失敗詳細は全文保持 |
-| 可逆圧縮（CCR） | 圧縮前の生出力をローカルに全文保存。`godd-tk show <id>` でいつでも原文を参照可能 |
-| 使用量分析 | コマンドごとの節約トークン数を SQLite で追跡 |
-| 自動インストール | `npm install` 時に自動ダウンロード |
-`godd-tk gain` で累計トークン節約量を確認できます。
-圧縮フックを自動設定するのは現時点では Cursor のみです。他の MCP
-クライアントは圧縮なしで利用を継続でき、`godd-tk exec -- <command>` で明示的に
-圧縮できます。実装SSOT由来の表は `godd-a compatibility` で確認でき、実クライアントの
-OS別smoke testは証跡が追加されるまで `unverified` と表示されます。
-### GoDD プロンプト一覧
-各クライアントで利用できる GoDD プロンプト（MCP ツール）の一覧です。
+### GoDD プロンプト
 | プロンプト | 説明 |
 |---|---|
-| `run` | 統一エントリポイント — "/godd-a/<tool> <args>" 形式のテキストコマンドをパースして対応ツールを実行 |
-| `dev` | 開発（段階的に計画→実装→テスト→品質→ドキュメントを実行） |
+| `run` | 統一エントリポイント — "/godd-a/<tool> <args>" 形式のテキストをパースして対応ツールを実行 |
+| `dev` | 開発（段階的に計画→実装→テスト→品質→ドキュメント） |
 | `check` | 品質ゲート（Spec整合・テスト・型・Lint・セキュリティを検証） |
 | `docs` | ドキュメント生成/更新 |
 | `ship` | 提出（適切な粒度でコミット → 品質チェック → プッシュ → PR 作成） |
@@ -517,139 +189,62 @@ OS別smoke testは証跡が追加されるまで `unverified` と表示されま
 | `adr` | ADR（Architecture Decision Record）作成 |
 | `release` | リリースノート生成（SemVer 準拠） |
 | `github` | GitHub 設定（リポジトリ/ブランチ保護等） |
-| `config` | config.godd を正確に生成・修正する（スタック自動検出 + バリデーション） |
-| `questions` | 質問リスト（質問リスト.md）からインタラクティブに質問を管理 |
+| `config` | config.godd を生成・修正（スタック自動検出 + バリデーション） |
+| `questions` | 質問リストをインタラクティブに管理 |
 | `e2e` | ブラウザベース E2E テスト（重要ユーザーフローの実行・検証） |
 | `map` | プロジェクトナレッジグラフ（Mermaid でアーキテクチャ・依存関係を可視化） |
 | `learn` | プロジェクト固有のパターン・慣例・落とし穴を保存/参照 |
-| `scratchpad` | 会話記憶の永続化 — BM25 ベクター検索で save/recall/search/list/forget |
-| `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） |
-| `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） |
-| `design` | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） |
-| `metrics` | トークン効率レポート — このセッションの配信トークン数と素の Cursor との比較（実測ベンチマークベース） |
+| `scratchpad` | 会話記憶の永続化（save/recall/search/list/forget） |
+| `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメント） |
+| `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown） |
+| `design` | コードベースからビジュアルデザインを生成/更新 |
+| `metrics` | このセッションのトークン効率レポート |
 ### CLI コマンド
 | コマンド | 説明 |
 |---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | MCP クライアントに登録（`cursor` / `claude-code` / `codex` / `kimi` / `antigravity` / `all`。省略時はインストール済みクライアントを自動検出） |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | プロジェクトの config.godd を生成 |
-| `godd-a uninstall [--client=...]` | MCP クライアントから削除（`--client` の解決は install と同様） |
-| `godd-a compatibility` | 実装SSOT由来の godd-tk クライアント互換マトリクスを表示 |
-| `godd-a codec-capability verify [...]` | codec manifest・artifact・runtime probe・known-answerを同梱Rustで検証 |
-| `godd-a plan audit <record\|verify> [...]` | 改ざん検出可能な計画中断・再開・逸脱の証跡を記録・検証 |
-| `godd-a research <action> [options]` | Rust実行本体で匿名化済み調査チェックポイントを保存・再開（検索・LLM呼出なし） |
+| `godd-a install [--license-key=KEY] [--client=...]` | MCP クライアントに登録（`--client` 省略時はインストール済みを自動検出） |
+| `godd-a init [--force] [--lang=LANG] [--auto]` | プロジェクト設定を生成 |
+| `godd-a uninstall [--client=...]` | MCP クライアントから削除 |
+| `godd-a version`（または `--version` / `-v`） | インストール済みバージョンの表示と更新確認 |
 | `godd-a serve` | MCP stdio サーバーを起動（クライアントが自動呼び出し） |
-| `godd-a --version` / `godd-a -v` | インストール済みバージョンを表示 |
-### スクラッチパッド（永続メモリ）
-GoDD にはセッションをまたいで会話記憶を保存・検索できるスクラッチパッドシステムが組み込まれています。
-GoDD MCP 起動時に Docker Desktop は自動的に起動されます（インストール済みの場合）。手動セットアップ:
-```bash
-# ベクター検索用に Qdrant を起動（任意 — なくてもローカル JSON フォールバックで動作）
-cd godd-mcp-alpha && docker compose up -d
-```
-| アクション | 例 | 説明 |
-|---|---|---|
-| `save` | `scratchpad save 認証フローは JWT + リフレッシュトークンを使用` | 記憶を保存し、`mem::` アドレスを返す |
-| `recall` | `scratchpad recall mem::godd::abc123` | アドレスで記憶の全文を取得 |
-| `search` | `scratchpad search 認証` | BM25 検索、上位 5 件を返す |
-| `list` | `scratchpad list` | 保存された記憶の一覧を表示 |
-| `forget` | `scratchpad forget mem::godd::abc123` | 記憶を削除 |
-Docker/Qdrant なしの場合は `.godd/scratchpad.json` にフォールバックし、キーワードベースの検索で動作します。
-### ライセンスキーの取得
-GoDD MCP を利用するにはライセンスキーが必要です。以下の手順で取得できます。
-1. [GoDD 公式サイト](https://www.getgodd.dev/pricing) でプランを確認
-2. [アカウント登録](https://www.getgodd.dev/godd-admin/register) してサブスクリプションを購入
-3. [ダッシュボード](https://www.getgodd.dev/godd-admin/dashboard) からライセンスキーを発行
-発行されたライセンスキーを `godd-a install --license-key=YOUR_KEY` で設定してください。
-### 動作要件
-- Node.js 22 以上
-- MCP 対応クライアント — Cursor IDE / Claude Code CLI / Codex / Kimi CLI / Antigravity IDE のいずれか
-- GoDD ライセンスキー（[公式サイト](https://www.getgodd.dev/pricing)で取得）
 ### トラブルシューティング
-#### 「利用可能なツールが 0 個」と表示される
-Cursor の MCP ログに以下のようなエラーが出ている場合:
-```
-Unexpected end of JSON input
-Unexpected token 'G', "GoDD MCP α"... is not valid JSON
-```
-**原因**: `mcp.json` の `args` に `"serve"` が含まれていません。`serve` なしで起動するとインストーラーモード（人間向けテキスト出力）になり、Cursor が期待する JSON-RPC 通信に失敗します。
-**対処法**:
-```bash
-# 再インストールで mcp.json を正しく再生成
-npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY
-```
-その後 Cursor を再起動してください。
-#### ライセンスキーが別の端末に紐づいていると表示される
-GoDD のライセンスキーは端末（デバイス）に紐づきます。別端末で使用する場合は新しいライセンスキーを発行してください。
-```bash
-godd-a install --license-key=NEW_LICENSE_KEY
-```
+**クライアントに「0 tools available」と表示される** — サーバーが必須の `serve` 引数なしで起動されています。`godd-a install` を再実行してクライアント設定を正しく再生成し、クライアントを再起動してください。
 ### ライセンス
-Proprietary — GoDD ライセンスキーが必要です。[公式サイト](https://www.getgodd.dev/pricing)からご購入いただけます。
+商用（プロプライエタリ）。利用には有効な GoDD ライセンスキーが必要です。利用条件・サポートは[公式サイト](https://www.getgodd.dev/)をご覧ください。
 ---
-### Version 2への移行とロールバック
+## Русский
-Version 2でもpackage名、`npx`/global install、`godd-a` bin、MCP key、stdio transport、
-tool、config、永続state形式を維持します。Rust runtimeはnpm package内から直接実行し、
-4対応targetをcommit済みdigest/size manifestで検証します。GitHub認証、`gh`、install中の
-追加downloadは不要です。欠損・改竄・非対応・version不一致時はNode MCPへ縮退せず
-fail-closedで停止します。Linux x64はglibcに依存しないstatic musl binaryを使用し、
-Debian BookwormとAlpineでMCP smoke検証済みです。
+**GoDD доставляет проверенные промпты для разработки, майндсеты и рабочие процессы агентов прямо в ваш AI-клиент для кодинга** — Cursor IDE, Claude Code CLI, Codex, Kimi CLI и Google Antigravity IDE — через протокол MCP (Model Context Protocol).
-`npm install -g @autodevjapan/godd-mcp-alpha@2.0.0`で移行でき、既存MCP設定の変更は
-不要です。rollbackは
-`npm install -g @autodevjapan/godd-mcp-alpha@1.46.3`を明示実行してください。
-`godd-tk`は別の任意機能で、`GODD_INSTALL_GODD_TK=1`の場合だけ導入を試行します。
+### Зачем использовать GoDD
-## Русский
+- **Более качественный код быстрее.** Каждый промпт построен на семи проверенных методологиях xDD (Spec / Acceptance-Test / Test / Domain / Neo-Model / Docs / Issue-Driven Development), поэтому AI планирует, тестирует и документирует как senior-инженер, а не гадает.
+- **Одна команда на задачу.** Вызовите `/dev`, `/review`, `/ship` и другие — AI выполнит полный цикл: план → реализация → тесты → качество → документация.
+- **Меньше токенов, ниже стоимость.** Промпты доставляются **по требованию** — в контекст AI попадает только вызванный. Обычно это ~2 000–5 000 токенов на вызов против ~80 000+ у постоянно загружаемых файлов правил.
+- **Работает с вашими клиентами.** Один и тот же сервер регистрируется во всех поддерживаемых клиентах; настройки проекта определяются автоматически.
+- **Синхронизирован с вашим стеком.** `godd-a init` создаёт профиль проекта, чтобы доставляемые промпты соответствовали вашему языку, фреймворку и инструментам.
-Система доставки AI-промптов для MCP-совместимых клиентов (Cursor IDE, Claude Code CLI, Codex, Kimi CLI, Google Antigravity IDE). Предоставляет оптимизированные под технологический стек проекта промпты, мировоззрения и определения агентов через MCP (Model Context Protocol). Сервер не зависит от клиента — одна и та же команда `serve` работает с любым MCP-хостом. Cursor, Claude Code, Codex, Kimi CLI и Antigravity официально поддерживаются.
+### Требования
-Пакет npm остаётся основным способом распространения. `godd-a serve` запускает MCP-среду на Rust; Node.js используется для жизненного цикла npm, установки нативного бинарного файла и совместимых CLI-команд.
-Инструменты `config`, `questions` и `scratchpad` запускают существующий обработчик Node.js только на время вызова для совместимости диагностики и формата хранения; сам MCP-сервер остаётся нативным для Rust.
+- **Лицензионный ключ GoDD** (обязателен — см. [Получение лицензионного ключа](#получение-лицензионного-ключа))
+- Node.js 22+
+- MCP-совместимый клиент: Cursor IDE, Claude Code CLI, Codex, Kimi CLI или Antigravity IDE
-Команды `godd-a plan audit record` и `godd-a plan audit verify` записывают и
-проверяют защищённую HMAC-цепочкой историю остановок, возобновлений и отклонений
-плана. `GODD_PLAN_AUDIT_KEY` должен содержать не менее 32 байт.
+### Получение лицензионного ключа
-Экспериментальный доменный контракт Rust проверяет явные маршруты
-`provider:model` для OpenAI-совместимых провайдеров. Он не запускает HTTP-прокси,
-не читает секреты, не выпускает виртуальные ключи и не меняет MCP-среду.
+Для использования GoDD MCP требуется действующий лицензионный ключ.
-Второй экспериментальный доменный контракт Rust определяет поддержку
-изображений/PDF для конкретной модели (override оператора → доверенные метаданные
-провайдера → безопасное значение по умолчанию) и решает, передать ли content block
-как есть, преобразовать его в текст по настроенной политике или отклонить запрос
-до вызова провайдера — без тихого отбрасывания. Он не выполняет OCR, vision
-side-call или сохранение байтов.
+1. Ознакомьтесь с тарифами на [официальном сайте GoDD](https://www.getgodd.dev/pricing)
+2. [Создайте аккаунт](https://www.getgodd.dev/godd-admin/register) и выберите подписку
+3. Выпустите лицензионный ключ в [панели управления](https://www.getgodd.dev/godd-admin/dashboard)
 ### Установка
@@ -657,164 +252,39 @@ side-call или сохранение байтов.
 npm install -g @autodevjapan/godd-mcp-alpha
 ```
-### Настройка (рекомендуется)
+### Настройка
 ```bash
-# Автоматически обнаружить установленные MCP-клиенты и зарегистрировать сервер в каждом
+# Автообнаружение установленных MCP-клиентов и регистрация в каждом
 godd-a install --license-key=YOUR_LICENSE_KEY
-# Или указать конкретный клиент: cursor / claude-code / codex / kimi / antigravity / all
+# Или конкретный клиент: cursor / claude-code / codex / kimi / antigravity / all
 godd-a install --client=cursor --license-key=YOUR_LICENSE_KEY
-# Автоматическая генерация config.godd для проекта (интерактивный режим)
+# Сгенерировать конфигурацию проекта (интерактивно; для CI/CD добавьте --auto)
 godd-a init
-# Или полностью автоматический режим (для CI/CD)
-godd-a init --auto
-```
-> **Используйте `godd-a install`.** Ручное редактирование mcp.json не рекомендуется.
-> `godd-a install` корректно настраивает команду запуска, PATH и лицензионный ключ.
-### Ручная настройка mcp.json
-Если `godd-a install` недоступен, можно напрямую отредактировать конфигурационный файл клиента — `~/.cursor/mcp.json` для Cursor, `~/.gemini/antigravity/mcp_config.json` для Antigravity (оба используют общеизвестный формат `{"mcpServers": {...}}`). Если ни один известный клиент не обнаружен, `godd-a install` выводит этот же сниппет для ручной настройки.
-**Аргумент `serve` обязателен.** Без него запускается режим установщика, и MCP-коммуникация нарушается.
-```json
-{
-  "mcpServers": {
-    "godd-a": {
-      "command": "npx",
-      "args": ["-y", "@autodevjapan/godd-mcp-alpha@latest", "serve"],
-      "env": {
-        "GODD_LICENSE_KEY": "GODD-XXXX-XXXX"
-      }
-    }
-  }
-}
 ```
-### Настройка в Claude Code CLI
-Зарегистрируйте сервер в Claude Code CLI с флагом `--client=claude-code`:
-```bash
-godd-a install --client=claude-code --license-key=YOUR_LICENSE_KEY
-```
-Регистрация делегируется `claude mcp add-json` в **user scope** (`~/.claude.json`) — безопасное слияние с другими MCP-серверами, повторный запуск обновляет существующую запись. Если `claude` CLI нет в PATH, установщик выведет точную команду для ручного выполнения.
-Без `--client` `godd-a install` автоматически обнаруживает локально установленные клиенты и регистрируется во всех найденных (если ни один не найден — выводит универсальный сниппет `mcpServers` для ручной настройки). Команда запуска, аргументы и переменные окружения идентичны для всех клиентов, а привязка лицензии выполняется по устройству.
-<details>
-<summary>Ручная регистрация (если не хотите использовать <code>godd-a install</code>)</summary>
-```bash
-claude mcp add godd-a \
-  --env GODD_LICENSE_KEY=GODD-XXXX-XXXX \
-  -- npx -y @autodevjapan/godd-mcp-alpha@latest serve
-```
-Либо добавьте файл `.mcp.json` в корне проекта с той же структурой `mcpServers` (аргумент `serve` обязателен).
-</details>
-### Настройка в Codex
-Регистрация через официальный MCP CLI Codex. Codex CLI, расширение IDE и приложение используют общую MCP-конфигурацию:
-```bash
-godd-a install --client=codex --license-key=YOUR_LICENSE_KEY
-```
-Проверка: `codex mcp list` или `/mcp`. Удаление: `godd-a uninstall --client=codex`.
-### Настройка в Kimi CLI
-Регистрация через официальную MCP-команду Kimi CLI:
-```bash
-godd-a install --client=kimi --license-key=YOUR_LICENSE_KEY
-```
-Регистрация делегируется `kimi mcp add --transport stdio` (переменные окружения передаются через `-e KEY=VALUE`). Если `kimi` CLI нет в PATH, установщик выведет команду для ручного выполнения. Проверка: `/mcp` в сессии Kimi CLI. Удаление: `godd-a uninstall --client=kimi`.
-### Настройка в Antigravity
-Регистрация в MCP-конфигурации Google Antigravity IDE:
-```bash
-godd-a install --client=antigravity --license-key=YOUR_LICENSE_KEY
-```
-Общеизвестная запись `{"mcpServers": {...}}` объединяется в `~/.gemini/antigravity/mcp_config.json` без изменения других серверов. Удаление: `godd-a uninstall --client=antigravity`.
+> Используйте `godd-a install` — он настроит команду запуска, PATH и лицензионный ключ. После этого перезапустите клиент, и инструменты GoDD появятся автоматически.
 ### Использование
-После установки перезапустите MCP-клиент (Cursor IDE, Claude Code CLI, Codex, Kimi CLI или Antigravity) — сервер GoDD MCP α запустится автоматически. Есть три способа вызвать инструменты GoDD:
-**Способ 1 — Нативный UI клиента:** Используйте интерфейс MCP-промптов/инструментов вашего клиента — например, в Cursor введите `/` в поле чата и выберите промпт GoDD из выпадающего списка (`/dev`, `/review`). В режиме Agent можно просто попросить AI естественным языком («запусти dev», «сделай review») — AI автоматически обнаружит и вызовет соответствующий инструмент.
-**Способ 2 — Нативные slash-команды (генерируются при установке):** `godd-a install` записывает файлы команд `godd-a-<tool>.md` в клиенты с поддержкой пользовательских команд — Cursor (`~/.cursor/commands/`), Claude Code (`~/.claude/commands/`), Codex (`$CODEX_HOME/prompts` или `~/.codex/prompts/`, загружаются при старте сессии), Antigravity (`~/.gemini/antigravity/workflows/` — путь из данных сообщества, официально не подтверждён). Вызывайте их как `/godd-a-dev`, `/godd-a-review` и т.д. — имена команд клиента не могут содержать `/` или `:`, поэтому используется форма с дефисом. Kimi CLI не поддерживает пользовательские slash-команды, поэтому файлы для него не генерируются.
-**Способ 3 — Текстовая диспетчеризация через инструмент `run`:** Введите `/godd-a/dev <args>` обычным текстом в чат. Постоянно загружаемые правила диспетчеризации (GoDD-блок в AGENTS.md и `.cursor/rules/godd-stack.mdc`, перегенерируются инструментом `config` (через чат) или командой `godd-a init`) указывают AI передать полный текст инструменту `run` GoDD MCP, который разбирает все обозначения — `/godd-a/<tool>`, `godd-a/<tool>`, `/godd-a:<tool>`, `/godd-a_<tool>`, `mcp__godd-a__<tool>`, голый `/<tool>` — и запускает соответствующий инструмент.
-### Эффективность токенов
+Вызывайте GoDD тем способом, который поддерживает ваш клиент:
-GoDD MCP доставляет промпты **по требованию** — в контекст AI отправляется только вызванный промпт. Это принципиально отличается от Cursor Rules, где все правила загружаются в контекст с самого начала каждого чата.
+- **Нативный UI** — введите `/` в чате и выберите промпт GoDD (`/dev`, `/review`), либо в режиме Agent просто попросите («запусти dev», «сделай ревью»).
+- **Slash-команды** — `godd-a install` создаёт файлы команд `/godd-a-<tool>` для клиентов, которые их поддерживают (Cursor, Claude Code, Codex, Antigravity).
+- **Текстовый диспетчер** — введите `/godd-a/dev <args>` как обычный текст; AI направит запрос нужному инструменту.
-| Подход | Принцип работы | Стоимость токенов за вызов |
-|---|---|---|
-| **Cursor без GoDD** | Нет структурированных промптов; агент тратит больше итераций | ~80 000+ токенов на задачу |
-| **GoDD MCP** | Оптимизированные промпты по требованию | ~2 000–5 000 токенов за вызов |
-В любой момент сессии введите `/metrics`, чтобы увидеть фактическое использование токенов и расчётную экономию. Экономия измеряется эмпирически через бенчмарки, сравнивающие сессии с GoDD и без него.
-Необязательный аргумент JSON `quality_evidence` добавляет воспроизводимую
-оценку избыточного вывода, завершённости выполнения и целостности дизайна.
-Недостаточные доказательства дают `INCONCLUSIVE`, а не предполагаемый сбой.
-Необязательный `learning_evidence` принимает только числовые и логические
-агрегаты и детерминированно оценивает обучение и обоснованность. Пустые или
-неполные доказательства дают `INCONCLUSIVE`; исходный текст и секреты запрещены.
-### GoDD Token Killer (godd-tk)
-**Встроенный CLI-прокси для дополнительной экономии токенов на вывод команд — измеренная средневзвешенная экономия 88.1% (est.) на встроенном бенчмарке (0–94% по типам команд).**
-godd-tk перехватывает команды оболочки, выполняемые AI-агентами, и сжимает их вывод перед отправкой в LLM. Автоматически устанавливается вместе с GoDD MCP через `npm postinstall`.
-```
-AI-агент → Shell("git status") → godd-tk → сжатый вывод → AI-агент
-```
-| Функция | Описание |
-|---|---|
-| Фильтрация вывода | Удаление ANSI-кодов, шумовых строк и избыточного форматирования |
-| Статистическое сжатие | Типизированные компрессоры (log / json / diff / test-report / generic-text) сворачивают повторяющийся вывод, сохраняя ошибки и детали сбоев полностью |
-| Обратимое сжатие (CCR) | Исходный вывод целиком сохраняется локально до сжатия — восстановление в любой момент через `godd-tk show <id>` |
-| Аналитика использования | Отслеживание сэкономленных токенов по командам через SQLite |
-| Автоустановка | Скачивается автоматически при `npm install` |
-Запустите `godd-tk gain` для просмотра накопленной экономии токенов.
-Автоматический хук сжатия сейчас настраивается только для Cursor. Остальные
-MCP-клиенты продолжают работать без сжатия; ручной режим:
-`godd-tk exec -- <command>`. Команда `godd-a compatibility` выводит матрицу из
-реестра реализации, а проверки реальных клиентов по ОС остаются `unverified`
-до появления результатов smoke-тестов.
-### Список промптов GoDD
-Доступные промпты GoDD (MCP-инструменты):
+### Промпты GoDD
 | Промпт | Описание |
 |---|---|
-| `run` | Единая точка входа — разбирает текстовую команду "/godd-a/<tool> <args>" и запускает соответствующий инструмент |
+| `run` | Единая точка входа — разбирает текстовую команду "/godd-a/<tool> <args>" и запускает нужный инструмент |
 | `dev` | Разработка (поэтапно: план → реализация → тесты → качество → документация) |
-| `check` | Контроль качества (проверка соответствия спецификации, тесты, типы, линтер, безопасность) |
+| `check` | Контроль качества (соответствие спецификации, тесты, типы, линтер, безопасность) |
 | `docs` | Генерация/обновление документации |
-| `ship` | Отправка (коммит с правильной гранулярностью → проверка качества → push → создание PR) |
-| `setup` | Настройка среды (с рекомендуемыми пресетами стека, уточнение недостающей информации) |
+| `ship` | Отправка (коммит нужной гранулярности → проверка качества → push → создание PR) |
+| `setup` | Настройка среды (с рекомендуемыми пресетами стека) |
 | `review` | Ревью (уровень CTO + контроль качества) |
 | `test` | Запуск/создание тестов |
 | `impact` | Анализ влияния |
@@ -823,118 +293,33 @@ MCP-клиенты продолжают работать без сжатия; р
 | `pr` | Создание PR (по шаблону) |
 | `deploy` | Деплой (с верификацией и планом отката) |
 | `adr` | Создание ADR (Architecture Decision Record) |
-| `release` | Генерация заметок к релизу (SemVer-совместимые) |
+| `release` | Генерация заметок к релизу (SemVer) |
 | `github` | Настройка GitHub (защита репозитория/веток и т.д.) |
 | `config` | Генерация/исправление config.godd (автодетект стека + валидация) |
-| `questions` | Управление списком вопросов (質問リスト.md) в интерактивном режиме |
-| `e2e` | E2E-тестирование в браузере (выполнение и проверка критических пользовательских потоков) |
-| `map` | Граф знаний проекта (визуализация архитектуры и зависимостей через Mermaid) |
-| `learn` | Сохранение/вызов специфичных для проекта паттернов, соглашений и подводных камней |
-| `scratchpad` | Постоянная память диалога — save/recall/search/list/forget с BM25 векторным поиском |
-| `diagram` | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) |
-| `slide` | Генерация презентационных слайдов из документации проекта (формат Marp Markdown) |
-| `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация с Pencil.dev) |
-| `metrics` | Отчёт об эффективности токенов — токены этой сессии vs. базовый уровень Cursor без GoDD (на основе бенчмарков) |
+| `questions` | Интерактивное управление списком вопросов |
+| `e2e` | E2E-тестирование в браузере (критические пользовательские потоки) |
+| `map` | Граф знаний проекта (архитектура и зависимости через Mermaid) |
+| `learn` | Сохранение/вызов паттернов, соглашений и подводных камней проекта |
+| `scratchpad` | Постоянная память диалога (save/recall/search/list/forget) |
+| `diagram` | Автообновление архитектурных диаграмм (Mermaid в синхронизации с кодом) |
+| `slide` | Генерация слайдов из документации проекта (Marp Markdown) |
+| `design` | Генерация/обновление визуального дизайна из кодовой базы |
+| `metrics` | Отчёт об эффективности токенов текущей сессии |
 ### Команды CLI
 | Команда | Описание |
 |---|---|
-| `godd-a install [--license-key=KEY] [--client=...]` | Зарегистрировать MCP-сервер в клиентах (`cursor` / `claude-code` / `codex` / `kimi` / `antigravity` / `all`; без `--client` — автообнаружение установленных) |
-| `godd-a init [--force] [--lang=LANG] [--auto]` | Сгенерировать config.godd для проекта |
-| `godd-a uninstall [--client=...]` | Удалить MCP-сервер из клиентов (разрешение `--client` как у install) |
-| `godd-a compatibility` | Показать матрицу совместимости godd-tk из реестра реализации |
-| `godd-a codec-capability verify [...]` | Проверить manifest, artifact, runtime probe и known-answer кодека во встроенной Rust-среде |
-| `godd-a plan audit <record\|verify> [...]` | Записать или проверить историю остановок, возобновлений и отклонений плана |
-| `godd-a research <action> [options]` | Сохранить или продолжить обезличенную контрольную точку в Rust (без поиска и LLM) |
-| `godd-a serve` | Запустить MCP stdio-сервер (автоматически вызывается клиентом) |
-| `godd-a --version` / `godd-a -v` | Показать установленную версию |
-### Скрэтчпад (постоянная память)
-GoDD включает систему скрэтчпада для сохранения и поиска воспоминаний между сессиями.
-Docker Desktop автоматически запускается при старте GoDD MCP (если установлен). Для ручной настройки:
-```bash
-# Запустить Qdrant для векторного поиска (опционально — работает и без него через локальный JSON)
-cd godd-mcp-alpha && docker compose up -d
-```
-| Действие | Пример | Описание |
-|---|---|---|
-| `save` | `scratchpad save Авторизация использует JWT + refresh-токены` | Сохранить запись, возвращает адрес `mem::` |
-| `recall` | `scratchpad recall mem::godd::abc123` | Получить полное содержимое по адресу |
-| `search` | `scratchpad search авторизация` | BM25-поиск, возвращает топ-5 результатов |
-| `list` | `scratchpad list` | Показать все сохранённые записи |
-| `forget` | `scratchpad forget mem::godd::abc123` | Удалить запись |
-Без Docker/Qdrant скрэтчпад использует `.godd/scratchpad.json` с поиском по ключевым словам.
-### Получение лицензионного ключа
-Для использования GoDD MCP необходим лицензионный ключ. Получите его следующим образом:
-1. Ознакомьтесь с тарифными планами на [официальном сайте GoDD](https://www.getgodd.dev/pricing)
-2. [Зарегистрируйте аккаунт](https://www.getgodd.dev/godd-admin/register) и приобретите подписку
-3. Выпустите лицензионный ключ в [личном кабинете](https://www.getgodd.dev/godd-admin/dashboard)
-Установите полученный ключ командой `godd-a install --license-key=YOUR_KEY`.
-### Системные требования
-- Node.js 22+
-- MCP-совместимый клиент — Cursor IDE, Claude Code CLI, Codex, Kimi CLI или Antigravity IDE
-- Лицензионный ключ GoDD (получите на [официальном сайте](https://www.getgodd.dev/pricing))
+| `godd-a install [--license-key=KEY] [--client=...]` | Регистрация в MCP-клиентах (без `--client` — автообнаружение установленных) |
+| `godd-a init [--force] [--lang=LANG] [--auto]` | Генерация конфигурации проекта |
+| `godd-a uninstall [--client=...]` | Удаление из MCP-клиентов |
+| `godd-a version` (или `--version` / `-v`) | Показать установленную версию и проверить обновления |
+| `godd-a serve` | Запустить MCP stdio-сервер (вызывается клиентом автоматически) |
 ### Устранение неполадок
-#### Отображается «0 доступных инструментов»
-Если в логах MCP Cursor отображаются ошибки вида:
-```
-Unexpected end of JSON input
-Unexpected token 'G', "GoDD MCP α"... is not valid JSON
-```
-**Причина**: В `args` файла `mcp.json` отсутствует `"serve"`. Без него запускается режим установщика (текстовый вывод для человека), что нарушает JSON-RPC коммуникацию, ожидаемую Cursor.
-**Решение**:
-```bash
-# Переустановите для правильной регенерации mcp.json
-npx -y @autodevjapan/godd-mcp-alpha install --license-key=YOUR_KEY
-```
-Затем перезапустите Cursor.
-#### Лицензионный ключ привязан к другому устройству
-Лицензионные ключи GoDD привязываются к устройству. Для использования на другом устройстве выпустите новый ключ.
-```bash
-godd-a install --license-key=NEW_LICENSE_KEY
-```
-### Переход на Version 2 и откат
-Version 2 сохраняет имя пакета, установку через `npx`/global, бинарный файл `godd-a`,
-MCP key, stdio transport, инструменты, config и формат постоянного состояния. Среда Rust
-запускается непосредственно из npm package. Четыре поддерживаемых target проверяются по
-зафиксированному manifest с digest и size; GitHub authentication, `gh` и дополнительная
-загрузка при установке не требуются. При отсутствии, подмене, неподдерживаемой платформе или
-несовпадении версии установка завершается с ошибкой без Node MCP fallback.
-Для Linux x64 используется статический бинарный файл musl без зависимости от glibc;
-MCP smoke-тест подтверждён на Debian Bookworm и Alpine.
-Для обновления выполните
-`npm install -g @autodevjapan/godd-mcp-alpha@2.0.0`; существующая MCP-конфигурация не
-меняется. Для явного отката используйте
-`npm install -g @autodevjapan/godd-mcp-alpha@1.46.3`.
-`godd-tk` является отдельной необязательной возможностью и устанавливается только при
-`GODD_INSTALL_GODD_TK=1`.
+**«0 tools available» в клиенте** — сервер запущен без обязательного аргумента `serve`. Повторно выполните `godd-a install`, чтобы корректно пересоздать конфигурацию клиента, затем перезапустите клиент.
 ### Лицензия
-Проприетарная — требуется лицензионный ключ GoDD. Приобретите на [официальном сайте](https://www.getgodd.dev/pricing).
+Проприетарное ПО. Для использования требуется действующий лицензионный ключ GoDD. Условия и поддержка — на [официальном сайте](https://www.getgodd.dev/).