@ripla/godd-mcp 1.0.7-canary.13 → 1.0.7-canary.15

package/README.md

@@ -12,7 +12,7 @@
 | Node.js 20 以上 | `node -v` で確認 |
 | Cursor IDE | 最新版推奨 |
 | ライセンスキー | 管理者から受領 |
-| Registry URL | 管理者から受領 |
+| プロジェクトURL（Registry API URL） | GoDD Admin Console と連携してプロンプトを取得する接続先。管理者から受領 |
 
 ---
 
@@ -48,11 +48,11 @@ godd init
 
 1. **ライセンスキー** — 管理者から受領したキーを入力（必須）
 2. **使用言語** — `ja` / `en` / `zh` / `ru` / `kz` / `tr` から選択（default: `ja`）
-3. **Registry API URL** — default は `https://dev.api.godd.ripla-inc.com`
+3. **プロジェクトURL（Registry API URL）** — GoDD Admin Console と連携してプロンプトを取得する接続先。何も入力せず Enter を押すと、表示されたデフォルト値（`https://dev.api.godd.ripla-inc.com`）を使用します。適用後は使用した URL が表示されます
 4. **リポジトリ登録** — `origin` の Git リモート URL を Registry API に登録（`origin` がない場合は中断）
 5. **技術スタック選択** — `1,3,5` で複数選択、`all` で全選択。Step 2 以降は Enter でスキップ可（Step 1 は不可）
 6. **`config.godd` の保存先** — default はプロジェクトルートの `config.godd`
-7. **`.cursor/mcp.json` 生成** — `[Y/n]`（`Y` のときのみ生成）
+7. **対応媒体の MCP 設定生成** — `[Y/n]`（`Y` のとき `.cursor/mcp.json` / `.mcp.json` / `.codex/config.toml` と `/godd-dev` コマンドファイルを生成します）
 8. **任意 MCP の追加登録** — 順番 7 で `Y` のときのみ、Headroom / agent-browser / TypeUI を個別に opt-in
 
 技術スタック選択は以下の 5 ステップで進みます。**Step 1（プログラミング言語）のみ Enter ではスキップできません**（1 言語以上必須。未選択だとエラーで終了）。Step 2 以降は Enter でスキップでき、選んだ言語に対応する技術だけが表示されます。設計パターン（`DDD / Clean Architecture`）は質問されず、自動設定されます。
@@ -65,7 +65,7 @@ godd init
 | 4 | データベース | `PostgreSQL` / `MySQL` / `MongoDB` / `Redis` |
 | 5 | インフラ | `Docker` / `Terraform` |
 
-順番 7 で `Y`（既定）を選んだ場合のみ、追加で以下を聞かれます（`n` だと `.cursor/mcp.json` は生成されません）:
+順番 7 で `Y`（既定）を選んだ場合のみ、追加で以下を聞かれます（`n` だと `.cursor/mcp.json` / `.mcp.json` は生成されません）:
 
 | 質問 | 既定 | 前提 |
 |------|------|------|
@@ -79,26 +79,35 @@ godd init
 | ファイル | 内容 |
 |---------|------|
 | `config.godd` | 技術スタックコンポーネントの設定（常に生成） |
-| `.env` | ライセンスキー・言語・Registry URL（GoDD 管理値。常に更新） |
+| `.env` | ライセンスキー・言語・プロジェクトURL（Registry API URL、GoDD 管理値。常に更新） |
 | `.cursor/mcp.json` | Cursor IDE への MCP サーバー登録（順番 7 で `Y` を選んだ場合のみ） |
+| `.mcp.json` | Claude Code への MCP サーバー登録（プロジェクトルート。順番 7 で `Y` を選んだ場合のみ、`.cursor/mcp.json` と同一構成。TypeUI 等の url エントリのみ `type: "http"` 付き） |
+| `.codex/config.toml` | Codex のプロジェクト MCP 設定（順番 7 で `Y` を選んだ場合のみ・Git 管理外） |
+| `.cursor/commands/godd-dev.md` / `.claude/commands/godd-dev.md` | Cursor / Claude Code 共通の直接コマンド `/godd-dev` |
+| `.agents/skills/godd-dev/SKILL.md` | Codex が自動検出する GoDD スキル（`$godd-dev`） |
 
-> **ライセンスキーは `config.godd`（手動設定・旧形式・互換読み込み）、`.env`、`.cursor/mcp.json` で扱われます。`.gitignore` への除外は必須です。**
-> `godd init` / `godd notes compose` による自動追記（#1159 / PR #1175）が利用可能になるまでは手動で追加し、実行後は `git status` で除外を確認してください（#1175 マージ後は自動追記。それまでは手動）。
+> **ライセンスキーは `config.godd`（手動設定・旧形式・互換読み込み）、`.env`、`.cursor/mcp.json`、`.mcp.json`、`.codex/config.toml` で扱われます。`.gitignore` への除外は必須です。**
+> `godd init` / `godd notes compose` が自動追記します（#1159 / #1216）。実行後は `git status` で除外を確認してください。
 >
 > ```gitignore
 > config.godd
 > .env
 > .cursor/mcp.json
 > .cursor/mcp.json.bak
+> .mcp.json
+> .mcp.json.bak
+> .codex/config.toml
 > ```
 
 ---
 
-### Step 3: Cursor IDE を再起動する
+### Step 3: IDE で MCP を有効化する
 
-設定後、Cursor IDE を再起動してください。
+- **Cursor**: Cursor IDE を再起動してください。`.cursor/mcp.json` が読み込まれ、godd MCP ツールが利用可能になります
+- **Claude Code**: 対象プロジェクトで `claude` を起動すると、プロジェクトスコープ MCP（`.mcp.json`）の**承認ダイアログ**が表示されるので godd を承認してください。**初回は承認するまで有効化されません**（ファイルを置いただけ・再起動しただけでは使えません）。承認状態は `claude mcp list` で確認できます（承認前は `⏸ Pending approval` と表示されます）
+- **Codex**: `.codex/config.toml` を読み込んで再起動し、`/mcp` で godd が接続済みになっていることを確認してください。開発入口は `$godd-dev` です。
 
-再起動後、Settings > MCP で `godd` サーバーのステータスが **Running** になっていれば完了です。
+Cursor では再起動後、Settings > MCP で `godd` サーバーのステータスが **Running** になっていれば完了です。Claude Code では承認後に `claude mcp list` で `godd` が接続済みと表示されれば完了です。
 
 ---
 
@@ -108,9 +117,9 @@ godd init
 
 ### 技術スタックを変更したい場合
 
-プロジェクトディレクトリで `godd init` を再実行してください。コンポーネントは `config.godd` を直接編集することもできます。ライセンスキー・言語・Registry URL は `.env` の `GODD_LICENSE_KEY` / `GODD_LANGUAGE` / `GODD_REGISTRY_URL` を編集してください。Cursor のチャットで `godd_config` ツールを使って更新することもできます。変更後は Cursor IDE を再起動してください。
+プロジェクトディレクトリで `godd init` を再実行してください。コンポーネントは `config.godd` を直接編集することもできます。ライセンスキー・言語・プロジェクトURL（Registry API URL）は `.env` の `GODD_LICENSE_KEY` / `GODD_LANGUAGE` / `GODD_REGISTRY_URL` を編集してください。Cursor のチャットで `godd-config` ツールを使って更新することもできます。変更後は Cursor IDE を再起動してください。
 
-> **再実行時**: 既存の `config.godd` があると検出メッセージが表示され、ライセンスキー・使用言語・Registry URL・保存先は Enter で既存値を保持できます。コンポーネントは「既存のコンポーネント設定を引き継ぎますか？ `[Y/n]`」で引き継ぎ（既定 `Y`）か、ウィザードで再選択（`n`）を選べます。再選択時も Step 1（プログラミング言語）は 1 つ以上必須です。
+> **再実行時**: 既存の `config.godd` があると検出メッセージが表示され、ライセンスキー・使用言語・プロジェクトURL（Registry API URL）・保存先は Enter で既存値を保持できます。コンポーネントは「既存のコンポーネント設定を引き継ぎますか？ `[Y/n]`」で引き継ぎ（既定 `Y`）か、ウィザードで再選択（`n`）を選べます。再選択時も Step 1（プログラミング言語）は 1 つ以上必須です。
 
 ### バイナリ（ZIP）でのインストール
 
@@ -143,7 +152,7 @@ chmod +x godd
 | コマンド | 短縮形 | 説明 |
 |---------|--------|------|
 | `godd install` | `godd i` | GoDD をシステムにインストール |
-| `godd init` | — | プロジェクトのセットアップ（config.godd + .cursor/mcp.json 生成） |
+| `godd init` | — | プロジェクトのセットアップ（config.godd + .cursor/mcp.json + .mcp.json 生成） |
 | `godd server` | `godd s` | MCP サーバーを起動（Cursor が自動実行） |
 | `godd notes compose` | `godd n compose` | GoDD Notes をローカル Docker Compose で起動（`--auto` で自動実行） |
 | `godd notes deploy` | `godd n deploy` | GoDD Notes をクラウドにデプロイ（infra の provider に従う、`-y` で確認スキップ） |
@@ -168,59 +177,59 @@ Cursor のチャットで以下のツールが使えます。ツール名を指
 
 | ツール | 説明 | 呼び出し例 |
 |--------|------|-----------|
-| `godd_dev` | 開発ワークフローのメインエントリ。**2モード制** — 受領資料を渡すと起票モード（親Issue → 資料保管 → タスク分解 → 子Issue → 質問投稿 → 子Issue を番号昇順に1件ずつ実装）、`#<Issue番号>` を渡すと実装モード（回答記録 → ATDD実装 → 品質ゲート → 責務別コミット、`feat/#<Issue>-...` ブランチを自動作成） | 「この議事録の内容で起票して」 / 「#1234 を実装して」 |
-| `godd_review` | CTO レベルのコードレビュー。アーキテクチャ一貫性・スケーラビリティ・技術的負債・ビジネスインパクトの観点でフィードバック。重大度分類（CRITICAL/MAJOR/MINOR/SUGGESTION）付き | 「この PR をレビューして」 |
-| `godd_check` | 品質チェック。Spec 整合・影響範囲・テスト計画・互換性・セキュリティの観点で提出前チェック | 「品質チェックして」 |
-| `godd_commit` | 責務単位コミット。1 コミット = 1 責務で分割し、Conventional Commits 準拠のメッセージで実行 | 「コミットして」 |
-| `godd_submit` | 提出一括実行。品質チェック → push → PR 作成を一括実行 | 「PR 出して」 |
-| `godd_notes_deploy` | GoDD Notes のデプロイ案内（compose / deploy / infra） | 「Notes をデプロイして」 |
+| `godd-dev` | 開発ワークフローのメインエントリ。**2モード制** — 受領資料や依頼を渡すと起票モード（仕様突合 → タスク分解 → 起票〔単一ユニットは実装Issue 1件のみ / 複数なら親Issue + 子Issue〕→ 質問投稿 → 実ファイル受領時のみ資料保管 → Issue を番号昇順に1件ずつ実装）、`#<Issue番号>` を渡すと実装モード（回答記録 → ATDD実装 → 品質ゲート → 責務別コミット、`feat/#<Issue>-...` ブランチを自動作成） | 「この議事録の内容で起票して」 / 「#1234 を実装して」 |
+| `godd-review` | CTO レベルのコードレビュー。アーキテクチャ一貫性・スケーラビリティ・技術的負債・ビジネスインパクトの観点でフィードバック。重大度分類（CRITICAL/MAJOR/MINOR/SUGGESTION）付き | 「この PR をレビューして」 |
+| `godd-check` | 品質チェック。Spec 整合・影響範囲・テスト計画・互換性・セキュリティの観点で提出前チェック | 「品質チェックして」 |
+| `godd-commit` | 責務単位コミット。1 コミット = 1 責務で分割し、Conventional Commits 準拠のメッセージで実行 | 「コミットして」 |
+| `godd-submit` | 提出一括実行。品質チェック → push → PR 作成を一括実行 | 「PR 出して」 |
+| `godd-notes-deploy` | GoDD Notes のデプロイ案内（compose / deploy / infra） | 「Notes をデプロイして」 |
 
 ### サブコマンド — Git 系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_sync` | main ブランチの最新を取り込み。コンフリクトは SSOT 準拠側を優先 |
-| `godd_new_branch` | 変更を退避し、最新 main からブランチ作成して復元 |
-| `godd_git_workflow` | sync → new-branch → commit を一括実行 |
-| `godd_push` | 提出前チェック。品質ゲート・Spec 整合・機密情報チェック |
-| `godd_push_execute` | 提出前チェック後に git push 実行 |
-| `godd_pr_create` | 変更分析と PR テンプレート準拠の本文生成、GitHub 上で PR 作成 |
+| `godd-sync` | main ブランチの最新を取り込み。コンフリクトは SSOT 準拠側を優先 |
+| `godd-new-branch` | 変更を退避し、最新 main からブランチ作成して復元 |
+| `godd-git-workflow` | sync → new-branch → commit を一括実行 |
+| `godd-push` | 提出前チェック。品質ゲート・Spec 整合・機密情報チェック |
+| `godd-push-execute` | 提出前チェック後に git push 実行 |
+| `godd-pr-create` | 変更分析と PR テンプレート準拠の本文生成、GitHub 上で PR 作成 |
 
 ### サブコマンド — 設計・仕様系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_spec` | 要求を仕様に変換。API/UI/DB/Feature/Usecase の粒度で Spec 化 |
-| `godd_impact` | 影響分析。変更の影響範囲を洗い出し |
-| `godd_test_plan` | テスト計画。unit/integration/e2e の必要性とテスト項目を策定 |
-| `godd_adr` | ADR 作成。設計判断をトレードオフ・ロールバック含めて記録 |
+| `godd-spec` | 要求を仕様に変換。API/UI/DB/Feature/Usecase の粒度で Spec 化 |
+| `godd-impact` | 影響分析。変更の影響範囲を洗い出し |
+| `godd-test-plan` | テスト計画。unit/integration/e2e の必要性とテスト項目を策定 |
+| `godd-adr` | ADR 作成。設計判断をトレードオフ・ロールバック含めて記録 |
 
 ### サブコマンド — ドキュメント系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_docs_init` | docs/ フォルダ構造をテンプレートから生成 |
-| `godd_docs` | コード変更に合わせて docs/・README・設定・技術スタック・運用ドキュメントを同期・更新。`docs/` 未作成時は `godd_docs_init` を案内 |
-| `godd_release_notes` | リリースノート作成。変更点・互換性・既知の問題を整理 |
+| `godd-docs-init` | docs/ フォルダ構造をテンプレートから生成。既存 docs/ が旧構成の場合は最新構成へ再配置 |
+| `godd-docs` | コード変更に合わせて docs/・README・設定・技術スタック・運用ドキュメントを同期・更新。`docs/` 未作成時は `godd-docs-init` を案内 |
+| `godd-release-notes` | リリースノート作成。変更点・互換性・既知の問題を整理 |
 
 ### サブコマンド — 分析・変換系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_pr_analyze` | PR 分析。差分からレビュー観点・リスク・追加情報を整理 |
-| `godd_report` | 完了報告。変更概要・影響範囲・検証結果・残リスクを整理 |
-| `godd_req_to_flow` | 要求 → ビジネスフロー変換 |
-| `godd_req_to_tickets` | 要求 → チケット分解 |
-| `godd_spec_to_tickets` | 仕様 → チケット変換 |
+| `godd-pr-analyze` | PR 分析。差分からレビュー観点・リスク・追加情報を整理 |
+| `godd-report` | 完了報告。変更概要・影響範囲・検証結果・残リスクを整理 |
+| `godd-req-to-flow` | 要求 → ビジネスフロー変換 |
+| `godd-req-to-tickets` | 要求 → チケット分解 |
+| `godd-spec-to-tickets` | 仕様 → チケット変換 |
 
 ### サブコマンド — 環境・セットアップ系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_setup` | 環境構築。config.godd / .env / .cursor/mcp.json 生成、依存導入 |
-| `godd_config` | 設定の表示・更新（components は config.godd、license_key 等は .env） |
-| `godd_install` | ツール/MCP サーバーインストール案内 |
-| `godd_dev_workflow` | 開発ワークフロー全体。環境構築→実装→テスト→コミット→PR |
+| `godd-setup` | 環境構築。config.godd / .env / .cursor/mcp.json 生成、依存導入 |
+| `godd-config` | 設定の表示・更新（components は config.godd、license_key 等は .env） |
+| `godd-install` | ツール/MCP サーバーインストール案内 |
+| `godd-dev-workflow` | 開発ワークフロー全体。環境構築→実装→テスト→コミット→PR |
 
 ---
 
@@ -232,14 +241,16 @@ Cursor のチャットで `/` を入力すると、GoDD の MCP ツールをス
 
 チャット入力欄で `/` を入力するとコマンド候補が表示されます。キーワードを続けて入力すると候補が絞り込まれます。
 
-**コマンド形式**: `/{サーバー名}/{ツール名}`
+**コマンド形式**: `/{サーバー名}/{ツール名}`（クライアントによってはツール名だけを表示）
 
-`godd init` で生成される `.cursor/mcp.json` のサーバーキー名（デフォルト: `godd`）がプレフィックスになります。例えばサーバー名が `godd` なら `/godd/dev`、`godd-a` なら `/godd-a/dev` のように表示されます。
+開発入口の正式なツール名は `godd-dev` です。`godd init` は Cursor / Claude Code 用のプロジェクトコマンド `.cursor/commands/godd-dev.md` / `.claude/commands/godd-dev.md` を生成するため、両媒体ではサーバー名に依存せず `/godd-dev` で呼び出せます。MCPツールを直接表示するクライアントでは、サーバーキーを付けた `/godd/godd-dev` や `/godd-a/godd-dev` になる場合があります。
+
+Codex はリポジトリ内の `.agents/skills/godd-dev/SKILL.md` を自動検出し、`$godd-dev` で同じ開発フローを起動できます。Codex の公式なプロジェクト共有スキル経路は `$` メンションであり、MCP由来の `/godd-dev` を全クライアントで強制する仕組みではありません。
 
 ```
 例 1: ツールを明示して依頼
 
-  /godd/dev ユーザー登録 API を実装して
+  /godd-dev ユーザー登録 API を実装して
 
 例 2: 複数ツールの組み合わせ
 
@@ -248,7 +259,7 @@ Cursor のチャットで `/` を入力すると、GoDD の MCP ツールをス
 例 3: ツールを指定しなくても AI が自動選択
 
   コミットメッセージを作って
-  → AI が自動的に godd_commit を選択
+  → AI が自動的に godd-commit を選択
 ```
 
 > **ヒント**: ツールを明示しなくても AI が自動的に最適なツールを選びます。特定のツールを確実に使いたい場合にスラッシュコマンドを活用してください。
@@ -257,7 +268,7 @@ Cursor のチャットで `/` を入力すると、GoDD の MCP ツールをス
 
 | コマンド（サーバー名 `godd` の場合） | 用途 |
 |--------------------------------------|------|
-| `/godd/dev` | 開発ワークフロー（ブランチ自動管理・分割コミット付き） |
+| `/godd-dev` | 開発ワークフロー（ブランチ自動管理・分割コミット付き） |
 | `/godd/review` | CTO レベルコードレビュー |
 | `/godd/check` | 品質チェック |
 | `/godd/commit` | 責務分割コミット |
@@ -417,14 +428,14 @@ godd init
 
 1. Cursor IDE を再起動する
 2. Settings > MCP で `godd` サーバーが **Running** であることを確認する（これが主確認）
-3. 任意で、チャットから `godd_check` を呼ぶか、MCP ツール一覧に GoDD ツールが並ぶことを確認する
+3. 任意で、チャットから `godd-check` を呼ぶか、MCP ツール一覧に GoDD ツールが並ぶことを確認する
 
 ### 4. docs/ 構造を初期化
 
-GoDD Notes は GitHub リポジトリの `docs/` を表示・編集対象にします。まだ `docs/` がないプロジェクトでは、Cursor のチャットから `godd_docs_init`（または `/godd/docs_init`）を実行して、標準のドキュメント構造を作成します。
+GoDD Notes は GitHub リポジトリの `docs/` を表示・編集対象にします。まだ `docs/` がないプロジェクトでは、Cursor のチャットから `godd-docs-init`（または `/godd/docs_init`）を実行して、標準のドキュメント構造を作成します。
 
 ```text
-Cursor IDE で: godd_docs_init を使って docs/ を初期化して
+Cursor IDE で: godd-docs-init を使って docs/ を初期化して
 ```
 
 ### 5. ローカルで Notes を起動