@ripla/godd-mcp 1.0.7-canary.9 → 1.0.7

package/README.md

@@ -3,20 +3,349 @@
 **GoDD（Governance-orchestrated Driven Development / 統治駆動開発）** の方法論を、Cursor IDE のチャット AI に注入する MCP サーバーです。
 追加の API キーは不要です。Cursor 搭載の AI がそのまま処理します。
 
+> **このページは3種類の読み手に向けて書かれています。** 該当するところだけ読めば足ります。
+>
+> - **GoDD 導入済みのプロジェクトに参加した方**（エンジニア経験は問いません）
+> - **GoDD を自分のプロジェクトに導入する方**
+> - **GoDD 自体をリリースする方**
+
+---
+
+## どこから読むか
+
+| あなたの状況 | 読むところ |
+|---|---|
+| **GoDD 導入済みのプロジェクトに参加した**（エンジニア経験は問いません） | **下の「はじめて参加した方へ」**。ここだけで環境構築が終わります |
+| GoDD を自分のプロジェクトに導入する | 「必要なもの」以降 |
+| GoDD 自体をリリースする | 「リリース（npm publish）」 |
+
+---
+
+## はじめて参加した方へ
+
+**このページだけで、開発を始められる状態まで進みます。** エンジニア経験は前提としません。上から順に、書いてあるとおりに実行してください。
+
+| # | やること | 時間の目安 |
+|---|---|---|
+| 1 | 必要なものが揃っているか確かめる | 5分 |
+| 2 | AI と話せるアプリを入れる | 10分 |
+| 3 | 開発で使うファイルをパソコンにコピーする | 10分 |
+| 4 | GoDD を入れる | 10分 |
+| 5 | 「このプロジェクトで GoDD を使う」と設定する | 5分 |
+| 6 | ちゃんと繋がったか確かめる | 5分 |
+
+**合計 45分ほど**が目安です。1回で終わらなくても構いません。各 Step の最後に「**これができていれば OK**」があります。そこまで進んだら次へ移ってください。
+
+> 所要時間は暫定の置き値です（実測ではありません）。実績が溜まったらチームで書き換えてください。
+
+---
+
+### Step 1. 必要なものが揃っているか確かめる
+
+#### なぜやるの？
+
+作業の途中で「あれが無い」と気づくと、届くまで手が止まります。**先に全部あるか見ておきます。**
+
+#### もらうもの
+
+**（このプロジェクトでは誰に頼むかを、参加時に書き足してください）**
+
+| もらうもの | これは何？ | 誰に頼む | いつ使う |
+|---|---|---|---|
+| **ライセンスキー** | GoDD を使ってよい人だと示す鍵。`godd-` で始まる長い文字列です | 管理者 | Step 5 |
+| **Registry URL** | GoDD が設定を取りに行く先の住所。`https://` で始まります | 管理者 | Step 5 |
+| **リポジトリの URL** | 開発で使うファイルの置き場所。`https://github.com/...` の形です | チーム | Step 3 |
+| **リポジトリに入る権限** | その置き場所を開いてよい許可。**招待メールが届きます** | チーム | Step 3 |
+| **GoDD の配布 ZIP** | GoDD 本体が入った圧縮ファイル | 管理者 | Step 4 |
+
+> **リポジトリ** = 開発で使うファイルをまとめて置いてある場所のこと。GitHub の中にあります。
+>
+> GoDD Notes を自分のパソコンで動かす場合だけ、**GitHub App の3つの値**（App ID / Private Key / Installation ID）も管理者からもらいます。
+
+#### やり方
+
+1. 上の表を見て、手元に無いものを確かめる
+2. **無いものがあったら、その場ですぐ頼む。** 「GoDD のライセンスキーと Registry URL をください」と伝えれば通じます
+3. **届くのを待たずに、Step 2 と3 を先に進める**（この2つはもらったものが無くてもできます）
+4. リポジトリの招待メールが来たら、中のボタンを押して参加する
+
+#### これができていれば OK
+
+表の5つが手元にある。
+
+> **ライセンスキーと Private Key は、家の鍵と同じ**です。チャットに貼らない・ファイルに書いて渡さない・人に転送しない。**渡っただけで、他人がシステムに入れてしまいます。**
+
+---
+
+### Step 2. AI と話せるアプリを入れる
+
+#### なぜやるの？
+
+これから先の作業は、**全部このアプリの中のチャット欄に文字を打つだけ**です。まずそのアプリを入れます。
+
+> **AI エディタ** = 文章を書くソフトに、AI と会話できるチャット欄が付いたもの。**Cursor / Claude Code / Codex** の3つが使えます。
+
+#### やり方
+
+**まず、どれを使うかチームに聞きます。** 「AI エディタは Cursor / Claude Code / Codex のどれを使いますか」と聞いてください。**決まっていなければ Cursor** を選べば大丈夫です（いちばん手数が少ないため）。
+
+有料の場合、**アカウントの用意もチームに頼みます。** 自分で契約する必要はありません。
+
+##### Cursor の場合
+
+1. https://www.cursor.com/ を開く
+2. 自分のパソコンに合う方（Mac か Windows）をダウンロードする
+3. ダウンロードしたファイルを開いて、画面の案内どおりに進める
+4. Cursor を起動し、案内に従ってログインする
+
+##### Claude Code / Codex の場合
+
+それぞれの公式の手順どおりに入れて、ログインまで済ませます。**入れ方が分からなければチームに聞いてください。** GoDD 用の設定はStep 5 で自動的に作られるので、ここでは何もしません。
+
+#### これができていれば OK
+
+アプリが起動して、チャット欄に文字を打てる。
+
+---
+
+### Step 3. 開発で使うファイルをパソコンにコピーする
+
+#### なぜやるの？
+
+開発で使うファイルは **GitHub** という場所に置いてあります。そのままでは編集できないので、**自分のパソコンにコピーを作ります。**
+
+作業はこのコピーに対して行い、できあがったら GitHub に戻します。
+
+> **GitHub（ギットハブ）** = ファイルをチームで共有し、誰がいつ何を直したかを記録しておく場所。
+> **clone（クローン）** = GitHub にあるファイル一式を、自分のパソコンにコピーすること。
+
+#### やり方
+
+**先に、Step 1 でもらったリポジトリの URL を手元に用意します。** まだ無ければ「開発で使うリポジトリの URL を教えてください」とチームに聞いてください。
+
+1. AI エディタを開く
+2. チャット欄に、`<...>` の部分を**もらった URL に置き換えて**打つ
+
+   ```text
+   https://github.com/<組織名>/<リポジトリ名> をこのパソコンに clone して
+   ```
+
+3. 「どこに保存しますか」と聞かれたら、**自分が分かる場所**を選ぶ（書類フォルダなどで構いません）
+4. しばらく待つ。ファイルの数によっては数分かかります
+
+#### これができていれば OK
+
+アプリの左側にファイルの一覧が出ている。
+
+#### うまくいかないとき
+
+| こんなとき | どうする |
+|---|---|
+| `docs` というフォルダが見当たらない | そのプロジェクトではまだ説明書が作られていません。チームに確認する |
+| 「権限がありません」と出る | まだ招待されていない可能性があります。チームに確認する |
+
+---
+
+### Step 4. GoDD を入れる
+
+#### なぜやるの？
+
+GoDD は、AI に「このチームのやり方」を教えるための道具です。**入れないと AI が普通の AI のままで、チームの決まりに沿って作ってくれません。**
+
+> **ターミナル** = 文字でパソコンに命令する画面です。GoDD を入れるときだけ使います。
+>
+> **AI エディタの中で開けます。** 上部メニューの **Terminal → New Terminal**（Cursor / Claude Code）。画面の下側に文字を打てる欄が出れば成功です。別のアプリを探す必要はありません。
+
+#### やり方
+
+**Step 1 でもらった ZIP から入れます。** まだ無ければ「GoDD の配布 ZIP をください」と管理者に頼んでください。
+
+> Node.js が既に入っている人は、代わりにターミナルで `npm install -g @ripla/godd-mcp` と打つ方法もあります。**分からなければ ZIP のほうを使ってください。**
+
+1. 受け取った ZIP を展開する（ファイルをダブルクリック）
+2. ターミナルを開き、展開したフォルダへ移動する
+
+   移動の仕方が分からなければ、チャットに「展開したフォルダをターミナルで開いて」と打つと AI がやってくれます。
+
+3. ターミナルに次をそのまま打って Enter
+
+   **Windows:**
+   ```powershell
+   .\godd.exe install
+   ```
+
+   **macOS / Linux:**
+   ```bash
+   ./godd install
+   ```
+
+4. **ターミナルを一度閉じて、開き直す**
+
+   > **必ずやってください。** 飛ばすと次の手順で「見つかりません」と言われます。入れたばかりの命令は、開き直さないと使えるようにならないためです。
+
+> Mac で「開発元が確認できないため開けません」と出たら、ターミナルに `xattr -d com.apple.quarantine godd` と打ってから、もう一度 3 をやり直してください。
+
+#### これができていれば OK
+
+ターミナルにこう打って、
+
+```bash
+godd version
+```
+
+`GoDD CLI v1.0.7` のように表示される（数字は版によって変わります）。
+
+**`command not found` と出たら**、Step 4-4（ターミナルを開き直す）を飛ばしていないか確かめてください。それでも直らなければ プロジェクトの `docs/007_guides/troubleshooting.md` を見ます。
+
+---
+
+### Step 5. 「このプロジェクトで GoDD を使う」と設定する
+
+#### なぜやるの？
+
+Step 4 で入れたのは道具そのものです。ここでは **「このプロジェクトでその道具を使います」と登録**します。鍵と接続先を1回だけ教える作業です。
+
+#### 先に用意するもの
+
+Step 1 でもらった**ライセンスキー**と **Registry URL** を、貼り付けられる状態にしておきます。
+
+あわせて、**チームに「技術スタックは何を選べばいいですか」と先に聞いておいてください。**
+
+> **技術スタック** = このプロジェクトで使っているプログラムの種類（例: React、Python）。GoDD がそれに合わせた作り方をするために聞かれます。
+
+#### やり方
+
+**Step 3 でコピーしたフォルダの中で**、ターミナルに打ちます。
+
+```bash
+godd init
+```
+
+> フォルダの中で打つ必要があります。**移動の仕方が分からなければ、チャットに「プロジェクトのフォルダをターミナルで開いて」と打つと AI がやってくれます。**
+
+打つと、**画面が1つずつ質問してきます。** 上から順に答えて、そのつど Enter を押します。
+
+| 聞かれること | どう答えるか |
+|---|---|
+| ライセンスキー | もらったキーを貼り付ける |
+| 使用言語 | `ja` と打つ（何も打たずに Enter でも同じ） |
+| プロジェクト URL | もらった **Registry URL** を貼り付ける |
+| **技術スタック（5回に分かれます）** | **1回目の「プログラミング言語」だけは必ず選ぶ**（番号を打つ。複数なら `1,3`）。**2回目以降は何も打たずに Enter で飛ばしてよい** |
+| `config.godd` の保存先 | 何も打たずに Enter |
+| MCP 設定を生成するか | `Y` と打つ |
+| Headroom / agent-browser / TypeUI | **3つとも `n` と打つ**（使いません） |
+
+> **1回目の「プログラミング言語」で何も選ばずに Enter を押すと、そこで終了します。** 分からなければ、この手順を始める前にチームに聞いてください。
+
+途中で「リポジトリを登録中」と出ますが、**ここは自動で進みます。** 何も打つ必要はありません。
+
+終わると、使っているアプリに合わせた設定ファイルが自動で作られます。**中身を開く必要はありません。** 鍵が入ったファイルは、他の人に見えないよう自動で設定されます。
+
+#### 途中で止まったとき
+
+| 画面に出た言葉 | どうする |
+|---|---|
+| `エラー: Git リモート (origin) が見つかりません。` | Step 3 のコピーがうまくいっていません。**チームに「clone したのに origin が無いと言われる」と伝える** |
+| `ライセンスキーが無効です。` | 貼り付けたキーの前後に余計な空白が入っていないか確かめる。それでも駄目なら**管理者にキーの再発行を頼む** |
+| `リポジトリ数の上限に達しています。` | **管理者に「リポジトリ数の上限に達したので枠を増やしてください」と伝える**。自分では直せません |
+
+#### これができていれば OK
+
+フォルダの中に `config.godd` というファイルができている。
+
+> **`config.godd`** = このプロジェクトで GoDD をどう使うかを書いた設定ファイル。**中を開いたり編集したりする必要はありません。** できていることだけ確かめてください。
+
+うまくいかなかったときは プロジェクトの `docs/007_guides/troubleshooting.md` を見てください。
+
+> **プロジェクトごとに1回ずつ必要**です。別のプロジェクトを担当するときは、そちらでももう一度やります。
+
+---
+
+### Step 6. ちゃんと繋がったか確かめる
+
+#### なぜやるの？
+
+Step 5 で作った設定は、**アプリを立ち上げ直さないと読み込まれません。** ここで繋がっていないと、この先の作業が全部動きません。
+
+> **MCP（エムシーピー）** = AI エディタと GoDD をつなぐ仕組みの名前。画面にこの言葉が出てきますが、**意味を覚える必要はありません。** 「GoDD との接続」と読み替えてください。
+
+#### やり方
+
+1. **アプリを完全に終了して、もう一度開く**（閉じるボタンだけでなく、完全に終了させます）
+2. Step 3 でコピーしたフォルダを開く
+3. 下の表のとおり、繋がっているか見る
+
+| 使っているアプリ | どこを見るか |
+|---|---|
+| Cursor | 設定（Settings）を開き、`MCP` の欄で `godd` が **緑色（Running）** になっている |
+| Claude Code | 起動したとき「許可しますか」と聞かれるので **許可する**。その後ターミナルで `claude mcp list` と打つと一覧に出る |
+| Codex | 使えるもの一覧に `$godd-dev` が出ている |
+
+**緑にならないときは、まずアプリをもう一度完全に終了して開き直してください。** それでも駄目なら プロジェクトの `docs/007_guides/troubleshooting.md` の「GoDD を認識しない」を見ます。
+
+#### 試しに話しかけてみる
+
+チャット欄にこう打ってみます。
+
+```text
+このリポジトリの構造を教えて
+```
+
+#### これができていれば OK
+
+返事が返ってくる。
+
+---
+
+
+---
+
+### 環境構築が終わったら
+
+**ここまでで準備は完了です。** 次は実際に1件やってみます。
+
+プロジェクトの **`docs/007_guides/getting_started.md`** を開いてください。最初の作業から PR を出すまでが書かれています。
+
+| 読む場所 | 開き方 |
+|---|---|
+| **エディタ** | 左のファイル一覧から `docs` → `007_guides` → `getting_started.md` |
+| GitHub | リポジトリの画面で同じ場所 |
+
+明日からの進め方は `docs/006_development_workflow/daily_flow.template.md` にあります。
+
+---
+
+### 途中で止まってしまったら
+
+**20分やって進まなかったら、遠慮なく聞いてください。** 最初の準備はパソコンごとに違いが出やすく、**聞いたほうが速い**部分です。自分で解決する必要はありません。
+
+聞くときに、この4つを伝えるとすぐ答えが返ってきます。
+
+```text
+1. どの手順で止まったか（例: Step 4 の godd install）
+2. 何を打ったか
+3. 画面に出た文字（そのままコピーして貼る。まとめない）
+4. 使っているパソコン（Windows / Mac）
+```
+
 ---
 
 ## 必要なもの
 
+> **ここから先は、GoDD を自分のプロジェクトへ導入する担当者向けです。**
+
 | 項目 | 備考 |
 |------|------|
 | Node.js 20 以上 | `node -v` で確認 |
 | Cursor IDE | 最新版推奨 |
 | ライセンスキー | 管理者から受領 |
-| Registry URL | 管理者から受領 |
+| プロジェクトURL（Registry API URL） | GoDD Admin Console と連携してプロンプトを取得する接続先。管理者から受領 |
 
 ---
 
-## セットアップ
+## セットアップ（導入担当向け）
+
+> **「はじめて参加した方へ」を読んだ方は、この節は不要です。** ここは、GoDD を新しいプロジェクトへ導入する担当者が読む節です。
 
 ### Step 1: GoDD をインストールする
 
@@ -30,6 +359,8 @@ npm install -g @ripla/godd-mcp
 godd version
 ```
 
+**完了の目安**: `GoDD CLI v1.0.x` のようにバージョンが表示される。`command not found` と出た場合はターミナルを開き直してください（PATH の反映に再起動が必要です）。
+
 > グローバルインストールしたくない場合は、以降のコマンドを `npx @ripla/godd-mcp <command>` で代替できます。
 > 例: `npx @ripla/godd-mcp init`
 
@@ -37,7 +368,7 @@ godd version
 
 ### Step 2: プロジェクトをセットアップする
 
-GoDD を使いたいプロジェクトのディレクトリに移動し、`godd init` を実行します。
+GoDD を使いたいプロジェクトのディレクトリに移動し、`godd init` を実行します。**対象のプロジェクトが手元にあり、`origin` の Git リモートが設定されていることが前提**です（無いとリポジトリ登録の段階で中断します）。
 
 ```bash
 cd /path/to/your-project
@@ -48,11 +379,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 +396,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,22 +410,37 @@ 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`） |
 
-> **`.env` にはライセンスキーが含まれます。`.gitignore` に追加してください。**
+> **ライセンスキーは `.env`、`.cursor/mcp.json`、`.mcp.json`、`.codex/config.toml` で扱われます。`.gitignore` への除外は必須です。**
+> `godd init` / `godd notes compose` が次を自動追記します（#1159 / #1216）。実行後は `git status` で除外を確認してください。
 >
 > ```gitignore
 > .env
+> .cursor/mcp.json
+> .cursor/mcp.json.bak
+> .mcp.json
+> .mcp.json.bak
+> .codex/config.toml
+> .codex/config.toml.bak
 > ```
+>
+> **`config.godd` は除外されません。** 使っている技術構成をチームで共有するファイルのため、コミットする前提です。旧形式で `license_key` を含めている場合のみ、その行を取り除いてからコミットしてください。
 
 ---
 
-### 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` が接続済みと表示されれば完了です。
 
 ---
 
@@ -104,9 +450,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）でのインストール
 
@@ -139,7 +485,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` で確認スキップ） |
@@ -153,7 +499,7 @@ chmod +x godd
 
 ---
 
-## 利用可能なツール（29 件）
+## 利用可能なツール（34 件）
 
 Cursor のチャットで以下のツールが使えます。ツール名を指定しなくても、AI が自動的に適切なツールを選択します。
 全ツールの入力は optional — 引数なしで呼び出し可能で、Chat の文脈から AI が自動補完します。
@@ -164,60 +510,75 @@ Cursor のチャットで以下のツールが使えます。ツール名を指
 
 | ツール | 説明 | 呼び出し例 |
 |--------|------|-----------|
-| `godd_dev` | 開発ワークフローのメインエントリ。Spec 確認→影響調査→実装→品質ゲート→PR 本文生成まで一貫実行。デフォルトブランチ上では `feat/<slug>-<YYYYMMDD>` ブランチを自動作成 | 「ユーザー登録 API を実装して」 |
-| `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-requirements` | 要件定義ハーネス。議事録 / RFP / 生入力からフェーズ単位の対話ループで要件定義成果物（001_project 概要 / 002_business_flow / requirements-list.csv / questions.csv）を生成・更新 |
+| `godd-spec` | 要求を仕様に変換。API/UI/DB/Feature/Usecase の粒度で Spec 化 |
+| `godd-impact` | 影響分析。変更の影響範囲を洗い出し |
+| `godd-test-plan` | テスト計画。unit/integration/e2e の必要性とテスト項目を策定 |
+| `godd-adr` | ADR 作成。設計判断をトレードオフ・ロールバック含めて記録 |
 
 ### サブコマンド — ドキュメント系
 
 | ツール | 説明 |
 |--------|------|
-| `godd_documentation` | ドキュメント更新。Spec/README/設定説明/技術スタックの更新を洗い出し |
-| `godd_docs_init` | docs/ フォルダ構造をテンプレートから生成 |
-| `godd_docs_update` | コード変更に合わせて docs/ 内の関連ドキュメントを同期・更新 |
-| `godd_release_notes` | リリースノート作成。変更点・互換性・既知の問題を整理 |
+| `godd-docs-init` | docs/ フォルダ構造をテンプレートから生成。既存 docs/ が旧構成の場合は最新構成へ再配置 |
+| `godd-docs` | コード変更に合わせて docs/・README・設定・技術スタック・運用ドキュメントを同期・更新。`docs/` 未作成時は `godd-docs-init` を案内 |
+| `godd-comment` | フィードバック機構（画面スクショ + ピン + コメント → GitHub Issue 自動起票）の導入。ウィジェット / Lambda / Terraform のテンプレートを展開（GoDD Notes 導入済みが前提） |
+| `godd-release-notes` | リリースノート作成。変更点・互換性・既知の問題を整理 |
+
+### サブコマンド — 連携系
+
+| ツール | 説明 |
+|--------|------|
+| `godd-slack-question` | Issue の「# 質問内容」コメントから未質問の不明点を抽出し、不明点ごとに Slack スレッドを立てて質問を投稿（スレッド URL を Issue に記録）。事前レビュー済みの `config.godd.slack` を読み取り専用で参照 |
 
 ### サブコマンド — 分析・変換系
 
 | ツール | 説明 |
 |--------|------|
-| `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 |
+| `godd-notes-init` | GoDD Notes 用に docs/ の初期テンプレートを展開。バンドル済みテンプレートを docs/ にコピー |
+| `godd-memory` | セッション間記憶。`remember` で保存、`recall` で検索、`consolidate` で整理（保存先 `.godd/memory/godd-memory.json`） |
+
+### サブコマンド — ナレッジ
+
+| ツール | 説明 |
+|--------|------|
+| `godd-knowledge-save` | 作業中に得た開発知見を GoDD Knowledge DB へ保存。**ユーザーから明示的に指示されたときだけ使われます** |
 
 ---
 
@@ -229,60 +590,67 @@ Cursor のチャットで `/` を入力すると、GoDD の MCP ツールをス
 
 チャット入力欄で `/` を入力するとコマンド候補が表示されます。キーワードを続けて入力すると候補が絞り込まれます。
 
-**コマンド形式**: `/{サーバー名}/{ツール名}`
+**コマンド形式**: `/{サーバー名}/{ツール名}`（クライアントによってはツール名だけを表示）
+
+開発入口の正式なツール名は `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` になる場合があります。**コマンドファイルが生成されるのは `godd-dev` だけ**なので、他のツールはサーバー名を付けた形で呼びます（`godd` と二重に見えるのは、サーバー名とツール名の両方に `godd` が付くためです）。
 
-`godd init` で生成される `.cursor/mcp.json` のサーバーキー名（デフォルト: `godd`）がプレフィックスになります。例えばサーバー名が `godd` なら `/godd/dev`、`godd-a` なら `/godd-a/dev` のように表示されます。
+Codex はリポジトリ内の `.agents/skills/godd-dev/SKILL.md` を自動検出し、`$godd-dev` で同じ開発フローを起動できます。Codex の公式なプロジェクト共有スキル経路は `$` メンションであり、MCP由来の `/godd-dev` を全クライアントで強制する仕組みではありません。
 
 ```
 例 1: ツールを明示して依頼
 
-  /godd/dev ユーザー登録 API を実装して
+  /godd-dev ユーザー登録 API を実装して
 
 例 2: 複数ツールの組み合わせ
 
-  /godd/spec この要件を仕様に変換して
+  /godd/godd-spec この要件を仕様に変換して
 
 例 3: ツールを指定しなくても AI が自動選択
 
   コミットメッセージを作って
-  → AI が自動的に godd_commit を選択
+  → AI が自動的に godd-commit を選択
 ```
 
 > **ヒント**: ツールを明示しなくても AI が自動的に最適なツールを選びます。特定のツールを確実に使いたい場合にスラッシュコマンドを活用してください。
 
-#### スラッシュコマンド一覧（29 件）
+#### スラッシュコマンド一覧（34 件）
 
 | コマンド（サーバー名 `godd` の場合） | 用途 |
 |--------------------------------------|------|
-| `/godd/dev` | 開発ワークフロー（ブランチ自動管理・分割コミット付き） |
-| `/godd/review` | CTO レベルコードレビュー |
-| `/godd/check` | 品質チェック |
-| `/godd/commit` | 責務分割コミット |
-| `/godd/submit` | 提出一括実行（品質チェック→push→PR 作成） |
-| `/godd/notes_deploy` | Notes デプロイ案内 |
-| `/godd/sync` | デフォルトブランチ同期 |
-| `/godd/new_branch` | ブランチ作成 |
-| `/godd/git_workflow` | sync→branch→commit 一括 |
-| `/godd/push` | 提出前チェック |
-| `/godd/push_execute` | 提出前チェック＋push 実行 |
-| `/godd/pr_create` | PR 作成 |
-| `/godd/spec` | 要求→仕様変換 |
-| `/godd/impact` | 影響分析 |
-| `/godd/test_plan` | テスト計画作成 |
-| `/godd/adr` | ADR（設計判断記録）作成 |
-| `/godd/documentation` | ドキュメント更新支援 |
-| `/godd/docs_init` | docs/ フォルダ構造生成 |
-| `/godd/docs_update` | docs/ ドキュメント同期 |
-| `/godd/release_notes` | リリースノート作成 |
-| `/godd/pr_analyze` | PR 分析 |
-| `/godd/report` | 完了報告作成 |
-| `/godd/req_to_flow` | 要求→ビジネスフロー変換 |
-| `/godd/req_to_tickets` | 要求→チケット変換 |
-| `/godd/spec_to_tickets` | 仕様→チケット変換 |
-| `/godd/setup` | 環境構築・設定変更 |
-| `/godd/config` | config.godd の表示・更新 |
-| `/godd/install` | ツール・ライブラリのインストール支援 |
-| `/godd/dev_workflow` | エージェント開発ワークフロー全体 |
+| `/godd/godd-dev` | 開発ワークフロー（起票モード / 実装モード）。Cursor / Claude Code は生成コマンド `/godd-dev`、Codex は `$godd-dev` でも起動できる |
+| `/godd/godd-check` | 品質チェック |
+| `/godd/godd-review` | CTO レベルコードレビュー |
+| `/godd/godd-commit` | 責務分割コミット |
+| `/godd/godd-spec` | 要求→仕様変換 |
+| `/godd/godd-requirements` | 要件定義ハーネス（対話ループで要件定義成果物を生成） |
+| `/godd/godd-impact` | 影響分析 |
+| `/godd/godd-test-plan` | テスト計画作成 |
+| `/godd/godd-pr-analyze` | PR 分析 |
+| `/godd/godd-setup` | 環境構築・設定変更 |
+| `/godd/godd-release-notes` | リリースノート作成 |
+| `/godd/godd-adr` | ADR（設計判断記録）作成 |
+| `/godd/godd-sync` | デフォルトブランチ同期 |
+| `/godd/godd-new-branch` | ブランチ作成 |
+| `/godd/godd-git-workflow` | sync→branch→commit 一括 |
+| `/godd/godd-push` | 提出前チェック |
+| `/godd/godd-push-execute` | 提出前チェック＋push 実行 |
+| `/godd/godd-pr-create` | PR 作成 |
+| `/godd/godd-submit` | 提出一括実行（品質チェック→push→PR 作成） |
+| `/godd/godd-dev-workflow` | エージェント開発ワークフロー全体 |
+| `/godd/godd-report` | 完了報告作成 |
+| `/godd/godd-req-to-flow` | 要求→ビジネスフロー変換 |
+| `/godd/godd-req-to-tickets` | 要求→チケット変換 |
+| `/godd/godd-spec-to-tickets` | 仕様→チケット変換 |
+| `/godd/godd-install` | ツール・ライブラリのインストール支援 |
+| `/godd/godd-slack-question` | Issue の質問を Slack スレッドへ投稿 |
+| `/godd/godd-docs-init` | docs/ フォルダ構造生成 |
+| `/godd/godd-docs` | docs/ ドキュメント同期 |
+| `/godd/godd-notes-init` | GoDD Notes 用の docs/ テンプレート展開 |
+| `/godd/godd-notes-deploy` | Notes デプロイ案内 |
+| `/godd/godd-memory` | セッション間記憶の保存・検索・整理 |
+| `/godd/godd-config` | config.godd の表示・更新 |
+| `/godd/godd-comment` | コメント（フィードバック）機構の導入 |
+| `/godd/godd-knowledge-save` | 開発知見の保存 |
 
 ### エコシステムツールのガイダンス
 
@@ -387,6 +755,8 @@ Notes のクラウドデプロイで pnpm 10+ 関連のエラーが出る場合
 
 GoDD Notes は GoDD のドキュメント閲覧・編集 Web アプリです。初回オンボーディングでは、まずローカル Docker Compose で動かし、AWS などのクラウドインフラ構築は後から必要なタイミングで実行します。ローカル利用だけなら AWS アカウント設定は不要です。
 
+> **初回の推奨順**: GoDD をインストール → プロジェクトで `godd init` → IDE で MCP 接続を確認 → `godd-docs-init` で `docs/` を初期化 → ローカルの `godd notes compose`（AWS 不要）→ 必要な場合のみ `godd notes infra` / `godd notes deploy`。
+
 ### 1. GoDD をインストール
 
 ```bash
@@ -414,14 +784,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`（MCP ツールのサーバー名付き表示例: `/godd/godd-docs-init`）を実行して、標準のドキュメント構造を作成します。
 
 ```text
-Cursor IDE で: godd_docs_init を使って docs/ を初期化して
+Cursor IDE で: godd-docs-init を使って docs/ を初期化して
 ```
 
 ### 5. ローカルで Notes を起動
@@ -439,10 +809,12 @@ Docker Compose でローカルに Notes 環境を立ち上げます。起動後
 
 | 種別 | URL |
 |------|-----|
-| API | `http://localhost:8000` |
-| App | `http://localhost:5173` |
+| API | `http://localhost:3100` |
+| App | `http://localhost:5175` |
+
+ポートは `godd notes compose` の対話で変更できます（既定値は上表のとおり）。
 
-`--auto` を省略すると、AI による自動実行ではなく手動確認しながら進められます。ローカル利用の詳細は [GoDD Notes 使い始め方ガイド](../docs/007_guides/godd_notes_getting_started.md) を参照してください。
+`--auto` を省略すると、AI による自動実行ではなく手動確認しながら進められます。ローカル利用の詳細は、`godd notes init` で展開される `docs/007_guides/` のガイドを参照してください。
 
 ### 6. 後でクラウドインフラを構築（必要な場合のみ）