npm - @ripla/godd-mcp - Versions diffs - 1.0.8-canary.3 → 1.0.8-canary.31 - Mend

@ripla/godd-mcp 1.0.8-canary.3 → 1.0.8-canary.31

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 (23) hide show

package/README.md +26 -937
package/dist/godd.cjs +314 -410
package/dist/godd.js +26224 -25634
package/dist/index.js +171 -285
package/notes/api/docker/Dockerfile +11 -2
package/notes/api/docker/Dockerfile.test +6 -2
package/package.json +8 -4
package/templates/notes-docs/007_guides/godd_tools.md +16 -122
package/templates/notes-docs/007_guides/godd_usage.md +0 -2
package/templates/notes-docs/007_guides/setup_godd.md +6 -0
package/templates/feedback/feedback-lambda/index.mjs +0 -342
package/templates/feedback/frontend/FeedbackWidget.tsx +0 -574
package/templates/feedback/frontend/api.ts +0 -38
package/templates/feedback/frontend/composePinImage.ts +0 -80
package/templates/feedback/frontend/config.ts +0 -14
package/templates/feedback/frontend/types.ts +0 -41
package/templates/feedback/terraform/Makefile +0 -43
package/templates/feedback/terraform/backend.tf +0 -10
package/templates/feedback/terraform/lambda.tf +0 -95
package/templates/feedback/terraform/local.tf +0 -12
package/templates/feedback/terraform/output.tf +0 -9
package/templates/feedback/terraform/provider.tf +0 -24
package/templates/feedback/terraform/variables.tf +0 -25

package/README.md CHANGED Viewed

@@ -1,950 +1,39 @@
 # GoDD MCP Server
-**GoDD（Governance-orchestrated Driven Development / 統治駆動開発）** の方法論を、Cursor IDE のチャット AI に注入する MCP サーバーです。
-追加の API キーは不要です。Cursor 搭載の AI がそのまま処理します。
+**GoDD を AI エディタから利用する方のための導入ガイドです。**
+個別ツールの使い方は、ログイン後に Registry から取得できます。
-> **このページは3種類の読み手に向けて書かれています。** 該当するところだけ読めば足ります。
->
-> - **GoDD 導入済みのプロジェクトに参加した方**（エンジニア経験は問いません）
-> - **GoDD を自分のプロジェクトに導入する方**
-> - **GoDD 自体をリリースする方**
+## 導入するとき
----
+1. Node.js が利用できる環境で `npm install -g @ripla/godd-mcp` を実行します。
+2. 利用するプロジェクトで `godd init` を実行し、案内に従って接続先と構成を設定します。
+3. `godd login` でログインし、AI エディタで GoDD MCP の接続を確認します。
-## どこから読むか
+AI エディタに利用可能なツールが表示されれば導入は完了です。
+ライセンスの発行や停止の解除は管理者へ依頼してください。
+旧 Ed25519 ライセンスから移る場合は、[切り替え手順](https://github.com/ripla-inc/GoDD/blob/main/docs/007_guides/guide-user.md#旧-ed25519-ライセンスから切り替えるとき)を確認してください。
-| あなたの状況 | 読むところ |
-|---|---|
-| **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 | 最新版推奨 |
-| ライセンスキー | 管理者から受領 |
-| プロジェクトURL（Registry API URL） | GoDD Admin Console と連携してプロンプトを取得する接続先。管理者から受領 |
----
-## セットアップ（導入担当向け）
-> **「はじめて参加した方へ」を読んだ方は、この節は不要です。** ここは、GoDD を新しいプロジェクトへ導入する担当者が読む節です。
-### Step 1: GoDD をインストールする
-```bash
-npm install -g @ripla/godd-mcp
-```
-インストール後、以下でバージョンを確認できます:
-```bash
-godd version
-```
-**完了の目安**: `GoDD CLI v1.0.x` のようにバージョンが表示される。`command not found` と出た場合はターミナルを開き直してください（PATH の反映に再起動が必要です）。
-> グローバルインストールしたくない場合は、以降のコマンドを `npx @ripla/godd-mcp <command>` で代替できます。
-> 例: `npx @ripla/godd-mcp init`
----
-### Step 2: プロジェクトをセットアップする
-GoDD を使いたいプロジェクトのディレクトリに移動し、`godd init` を実行します。**対象のプロジェクトが手元にあり、`origin` の Git リモートが設定されていることが前提**です（無いとリポジトリ登録の段階で中断します）。
-```bash
-cd /path/to/your-project
-godd init
-```
-実行前に、対話で聞かれる項目を準備しておきます:
-1. **ライセンスキー** — 管理者から受領したキーを入力（必須）
-2. **使用言語** — `ja` / `en` / `zh` / `ru` / `kz` / `tr` から選択（default: `ja`）
-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. **対応媒体の 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`）は質問されず、自動設定されます。
-| Step | 質問カテゴリ | 表示される選択肢 |
-|------|--------------|------------------|
-| 1 | プログラミング言語（必須・Enter スキップ不可） | `Python` / `TypeScript` / `JavaScript` / `Go` / `PHP` / `Ruby` / `C` / `HTML` / `CSS` |
-| 2 | フレームワーク / ライブラリ | `React` / `Next.js` / `Vue.js` / `Angular` / `Svelte` / `Electron`、`FastAPI` / `Django` / `Flask` / `Express` / `Fastify` / `NestJS` / `Gin` / `Echo` / `Fiber` / `Laravel` / `Symfony` / `WordPress` / `Ruby on Rails` / `Sinatra` / `Koa` |
-| 3 | 関連ツール（CSS / ビルド / ORM / タスクキュー / ランタイム） | `Tailwind CSS` / `Sass` / `Vite` / `SQLAlchemy` / `Celery` / `Node.js` / `Agent Stdio` |
-| 4 | データベース | `PostgreSQL` / `MySQL` / `MongoDB` / `Redis` |
-| 5 | インフラ | `Docker` / `Terraform` |
-順番 7 で `Y`（既定）を選んだ場合のみ、追加で以下を聞かれます（`n` だと `.cursor/mcp.json` / `.mcp.json` は生成されません）:
-| 質問 | 既定 | 前提 |
-|------|------|------|
-| Headroom（コンテキスト圧縮 MCP）も登録しますか？ | `N` | 事前に `pip install "headroom-ai[mcp]"` が必要 |
-| agent-browser（ブラウザ操作 MCP）も登録しますか？ | `N` | 事前に `npm install -g agent-browser && agent-browser install` が必要。`core` profile には JavaScript 実行（eval）が含まれます |
-| TypeUI（デザインスキル / UI プロンプト MCP）も登録しますか？ | `N` | ホスト型サーバー（`https://mcp.typeui.sh`）。初回利用時に TypeUI アカウントのサインインが必要 |
-| TypeUI Bearer トークン（TypeUI を `y` にしたときのみ） | 空 Enter | 通常は空 Enter で OAuth 対話サインイン。独自ホスト/トークン認証のときだけ入力 |
+## ツールの使い方を確認するとき
-完了すると、以下のファイルが生成されます:
+AI に「GoDD の利用可能なツールと、使いたいツールのガイドを取得して」と依頼してください。
+一覧には短い説明と引数が表示され、詳しい手順は `godd://mcp-tools/<ツール名>` のリソースから取得します。
+ガイドには目的、必要なもの、手順、成功した状態、失敗時の対処が記載されています。
-| ファイル | 内容 |
-|---------|------|
-| `config.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`、`.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: IDE で MCP を有効化する
-- **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` です。
-Cursor では再起動後、Settings > MCP で `godd` サーバーのステータスが **Running** になっていれば完了です。Claude Code では承認後に `claude mcp list` で `godd` が接続済みと表示されれば完了です。
----
-### 複数プロジェクトで使う場合
-プロジェクトごとに `godd init` を実行するだけです。プロジェクト A は React + FastAPI、プロジェクト B は Vue + Django のように、それぞれ異なる構成にできます。GoDD の再インストールは不要です。
-### 技術スタックを変更したい場合
-プロジェクトディレクトリで `godd init` を再実行してください。コンポーネントは `config.godd` を直接編集することもできます。ライセンスキー・言語・プロジェクトURL（Registry API URL）は `.env` の `GODD_LICENSE_KEY` / `GODD_LANGUAGE` / `GODD_REGISTRY_URL` を編集してください。Cursor のチャットで `godd-config` ツールを使って更新することもできます。変更後は Cursor IDE を再起動してください。
-> **再実行時**: 既存の `config.godd` があると検出メッセージが表示され、ライセンスキー・使用言語・プロジェクトURL（Registry API URL）・保存先は Enter で既存値を保持できます。コンポーネントは「既存のコンポーネント設定を引き継ぎますか？ `[Y/n]`」で引き継ぎ（既定 `Y`）か、ウィザードで再選択（`n`）を選べます。再選択時も Step 1（プログラミング言語）は 1 つ以上必須です。
-### 旧 Ed25519 ライセンスから切り替えるとき
-**旧 `stack_profile` 方式の利用者向けです。** 旧ライセンスには許可ツールの情報が無いため、通常の GoDD ツールは表示されません。設定を直すための `godd-config` は利用できます。
-| 必要なもの | 誰から受け取るか |
+| 表示される状況 | 対処 |
 |---|---|
-| 新しい Registry ライセンスキーと Registry URL | GoDD のライセンス管理者 |
-| プロジェクトで使うコンポーネント名 | プロジェクトの管理者 |
-1. **管理者が権限を設定する**: 管理画面で新しい Registry ライセンスを発行し、使わせるツールを個別に選ぶか、「すべてのツールを許可する」を明示的に選びます。何も選ばなければ通常ツールは使えません。
-2. **AI エディタに設定変更を頼む**: 対象プロジェクトのチャットで、新しいキー・Registry URL・コンポーネント名を渡し、「`godd-config` の `update` で `license_key`、`registry_url`、`components` を一度に更新して」と依頼します。キーを画面やログに再表示させないでください。
-3. **旧キーを片付ける**: AI に `godd-config` の `show` で設定を確認させます。`config.godd` に旧 `license_key` が残っている場合はその項目だけを削除し、`stack_profile` が無く `components` があることを確認させます。新しいキーは `.env` に保存され、表示時は伏せられます。
-4. **AI エディタを再起動する**: MCP サーバーのツール一覧に、管理者が許可したツールが現れれば切り替え完了です。`godd-config` しか出ない場合は、管理者に新ライセンスの許可ツールと Registry 接続を確認してもらいます。
-以前の Ed25519 キーに戻しても通常ツールの利用は復旧しません。切り替えに失敗した場合は、管理者に新しい Registry ライセンスの設定を確認してもらってください。
-### バイナリ（ZIP）でのインストール
-Node.js をインストールせずに使いたい場合は、スタンドアロンバイナリも利用できます。
-管理者から受領した ZIP ファイルを展開し、以下を実行してください:
-**Windows:**
-```
-.\godd.exe install
-```
-**macOS / Linux:**
-```bash
-chmod +x godd
-./godd install
-```
-> macOS で「開発元不明」の警告が出た場合は、先に以下を実行してください:
->
-> ```bash
-> xattr -d com.apple.quarantine godd
-> ```
----
-## GoDD CLI コマンド一覧
-| コマンド | 短縮形 | 説明 |
-|---------|--------|------|
-| `godd install` | `godd i` | GoDD をシステムにインストール |
-| `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` で確認スキップ） |
-| `godd notes infra` | `godd n infra` | `notes-api/` / `notes-app/` とクラウドインフラを対話形式で構築（AWS/GCP/Azure/Vercel×Railway） |
-| `godd notes status` | `godd n status` | デプロイ状態・ヘルスチェックを確認 |
-| `godd version` | `godd v` | バージョン表示 |
-| `godd help` | `godd h` | ヘルプ表示 |
-> npx で実行する場合は `npx @ripla/godd-mcp <command>` に置き換えてください。
-> 例: `npx @ripla/godd-mcp notes deploy -y`
----
-## 利用可能なツール（36 件）
-Cursor のチャットで以下のツールが使えます。ツール名を指定しなくても、AI が自動的に適切なツールを選択します。
-全ツールの入力は optional — 引数なしで呼び出し可能で、Chat の文脈から AI が自動補完します。
-### プライマリコマンド（厳選 6 個）
-開発の基本ワークフローに必須のコマンド。
-| ツール | 説明 | 呼び出し例 |
-|--------|------|-----------|
-| `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-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-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-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 へ保存。**ユーザーから明示的に指示されたときだけ使われます** |
-| `godd-knowledge-search` | 蓄積された開発知見をハイブリッド検索（意味 + キーワード）で引き当てる。**ユーザーから明示的に指示されたときだけ使われます** |
-| `godd-knowledge-attachment` | 検索結果に出た添付ファイルのダウンロード URL（約 1 時間で失効）を取得 |
----
-## スラッシュコマンドの使い方
-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` が付くためです）。
-Codex はリポジトリ内の `.agents/skills/godd-dev/SKILL.md` を自動検出し、`$godd-dev` で同じ開発フローを起動できます。Codex の公式なプロジェクト共有スキル経路は `$` メンションであり、MCP由来の `/godd-dev` を全クライアントで強制する仕組みではありません。
-```
-例 1: ツールを明示して依頼
-  /godd-dev ユーザー登録 API を実装して
-例 2: 複数ツールの組み合わせ
-  /godd/godd-spec この要件を仕様に変換して
-例 3: ツールを指定しなくても AI が自動選択
-  コミットメッセージを作って
-  → AI が自動的に godd-commit を選択
-```
-> **ヒント**: ツールを明示しなくても AI が自動的に最適なツールを選びます。特定のツールを確実に使いたい場合にスラッシュコマンドを活用してください。
-#### スラッシュコマンド一覧（36 件）
-| コマンド（サーバー名 `godd` の場合） | 用途 |
-|--------------------------------------|------|
-| `/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` | 開発知見の保存 |
-| `/godd/godd-knowledge-search` | 開発知見の検索 |
-| `/godd/godd-knowledge-attachment` | 開発知見の添付ファイル取得 |
-### エコシステムツールのガイダンス
-`godd init` で選択した技術スタックに応じて、プロジェクトで使用するライブラリやフレームワーク（**エコシステムツール**）の利用ガイダンスが MCP リソースとして自動登録されます。AI はスタック設定に基づいてこのガイダンスを自動的にコンテキストへ注入します。
-#### エコシステムツールの例（FastAPI + React 構成の場合）
-| カテゴリ | ツール | 説明 |
-|---------|--------|------|
-| Frontend | Orval | OpenAPI クライアントコード自動生成 |
-| Frontend | TanStack Query | 非同期データフェッチング/キャッシュ管理 |
-| Frontend | Vite | 高速フロントエンドビルドツール |
-| Frontend | Storybook | UI コンポーネント開発/カタログ |
-| Backend | SQLModel | SQLAlchemy + Pydantic ORM |
-| Backend | Alembic | DB マイグレーション |
-| Backend | FastAPI Users | 認証/ユーザー管理 |
-| DevTool | Ruff | Python Linter / Formatter |
-| DevTool | uv | Python パッケージマネージャ |
-| DevTool | Biome | Linter / Formatter（JS/TS） |
-| Testing | Pytest | Python テストフレームワーク |
-| Testing | HTTPX | Python HTTP クライアント（テスト用） |
-| Testing | Playwright | E2E テストフレームワーク |
-| Infra | Docker Compose | マルチコンテナオーケストレーション |
-| Monitoring | Sentry | エラー追跡 / パフォーマンス監視 |
-> **注**: 表示されるエコシステムツールは、`godd init` で選択した技術スタック（コンポーネント）によって変わります。
-### 自動 vs 手動
-| モード | 動作 | いつ使う |
-|--------|------|---------|
-| **自動** | ツール名を指定せず依頼すると、AI が最適な MCP ツールを自動選択。エコシステムツールのガイダンスもスタック設定に基づいて自動注入される | 通常の開発作業 |
-| **手動** | `/` でスラッシュコマンドを明示指定 | 特定のツールを確実に使いたい場合、複数ツールを組み合わせたい場合 |
----
-## トラブルシューティング
-### `godd` コマンドが見つからない
-npm グローバルインストールの場合:
-```bash
-npm install -g @ripla/godd-mcp
-```
-バイナリの場合は `godd install` を再実行し、ターミナルを再起動してください。
-### MCP サーバーが起動しない
-1. `godd version` が動くか確認
-2. `.cursor/mcp.json` の `env.GODD_CONFIG` が正しいパスを指しているか確認
-3. `config.godd` が指定パスに存在するか確認
-4. 手動でサーバーを起動してエラーを確認:
-**Windows:**
-```
-set GODD_CONFIG=C:\path\to\your-project\config.godd
-godd server
-```
-**macOS / Linux:**
-```bash
-GODD_CONFIG=/path/to/your-project/config.godd godd server
-```
-### ライセンスエラー
-| エラー | 対処 |
-|--------|------|
-| `Invalid license key` | `.env` の `GODD_LICENSE_KEY` が正しいか確認 |
-| `Registry 発行のライセンスキーは Registry API で検証してください` | `components` と `registry_url` を設定し、Registry API に接続できる状態で起動 |
-| `License has expired` | 管理者に更新を依頼 |
-### Registry に接続できない
-- `.env` の `GODD_REGISTRY_URL` が正しいか確認
-- ネットワーク接続を確認
-- `godd-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 形式の Registry 発行キーは、旧 `stack_profile` のローカル署名検証では利用できません。`components` を設定した Registry モードで利用してください。
-初回接続後は 10 時間のローカルキャッシュが有効です。キャッシュ期間中はオフラインでも動作します。
-### 古いバージョンが動いている
-`godd version` の出力が期待と異なる場合、古いバイナリが PATH に残っている可能性があります:
-```bash
-# npm で最新版に更新
-npm install -g @ripla/godd-mcp
-# バージョン確認
-godd version
-```
-Notes のクラウドデプロイで pnpm 10+ 関連のエラーが出る場合は、`@latest` ではなく canary を明示して更新してください（後述の「esbuild の build script が拒否される」参照）。
----
-## GoDD Notes ライフサイクル
-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
-npm install -g @ripla/godd-mcp
-godd version
-```
-Notes をクラウドデプロイする場合（ローカルに pnpm 10+ がある環境）は、pnpm 10+ 向けの Notes App ビルド対応が `@latest` に含まれるまで canary の利用を推奨します:
-```bash
-npm install -g @ripla/godd-mcp@canary
-godd version   # 1.0.4-canary.20 以上であることを確認
-```
-### 2. プロジェクトで `godd init`
-```bash
-cd /path/to/your-project
-godd init
-```
-プロジェクトごとに実行が必要です（2人目以降のメンバーも各自実行）。`godd init` が生成した `.cursor/mcp.json` を Cursor に読み込ませるため、この後に Cursor IDE を再起動します。
-### 3. MCP 接続を確認
-1. Cursor IDE を再起動する
-2. Settings > MCP で `godd` サーバーが **Running** であることを確認する（これが主確認）
-3. 任意で、チャットから `godd-check` を呼ぶか、MCP ツール一覧に GoDD ツールが並ぶことを確認する
-### 4. docs/ 構造を初期化
-GoDD Notes は GitHub リポジトリの `docs/` を表示・編集対象にします。まだ `docs/` がないプロジェクトでは、Cursor のチャットから `godd-docs-init`（MCP ツールのサーバー名付き表示例: `/godd/godd-docs-init`）を実行して、標準のドキュメント構造を作成します。
-```text
-Cursor IDE で: godd-docs-init を使って docs/ を初期化して
-```
-### 5. ローカルで Notes を起動
-前提: Docker Desktop が起動済みであること。加えて、GitHub App 用の以下3つの値をOrg管理者から事前に受け取っていること（AWS アカウントは不要でも、これらは必要です）。
-- App ID
-- Installation ID
-- Private Key
-```bash
-godd notes compose --auto
-```
-Docker Compose でローカルに Notes 環境を立ち上げます。起動後は以下のエンドポイントを確認します。
-| 種別 | URL |
-|------|-----|
-| API | `http://localhost:3100` |
-| App | `http://localhost:5175` |
-ポートは `godd notes compose` の対話で変更できます（既定値は上表のとおり）。
-`--auto` を省略すると、AI による自動実行ではなく手動確認しながら進められます。ローカル利用の詳細は、`godd notes init` で展開される `docs/007_guides/` のガイドを参照してください。
-### 6. 後でクラウドインフラを構築（必要な場合のみ）
-本番 AWS などへデプロイする段階で、インフラ担当者が `godd notes infra` を実行します。ローカル利用だけならこの手順は不要です。
-```bash
-godd notes infra
-```
-対話形式で AWS リージョンや環境名を入力すると、以下が生成されます:
-- `godd-notes/` ディレクトリ内の `notes-api/`, `notes-app/`（既存ディレクトリも同梱ソースで上書き更新し、`.env` / `node_modules` / `dist` などは除外）
-- `notes-app/pnpm-workspace.yaml`（pnpm 10+ 向け `allowBuild: esbuild` を同梱）
-- Terraform ファイル（VPC, ECS, RDS, S3, CloudFront 等）
-- CI/CD ワークフロー
-チームで1人が実行すれば OK です。
-既存環境で旧ブランド名の出力先や設定ファイルを生成済みの場合は、
-`godd notes infra` を再実行して `godd-notes/` と `.godd-notes-*.json` を再生成してください。
-### 7. クラウドへデプロイ（必要な場合のみ）
-```bash
-godd notes deploy      # 対話形式
-godd notes deploy -y   # 確認スキップ（CI 向け）
-```
-`.godd-notes-infra.json` の `provider`（AWS / GCP / Azure / Vercel×Railway）に応じて、ローカルの `notes-api` と `notes-app` をクラウドにデプロイします。
-`notes-api` が GitHub の `main` ブランチから `docs/` を読んで Notes に展開します。
-**pnpm 10+ について**: `1.0.4-canary.20` 以降の CLI では、Notes App ビルド前に `pnpm install --ignore-scripts`（`node_modules` が無い場合のみ）と `pnpm rebuild esbuild` を自動実行します。`pnpm approve-builds` を手動で実行する必要はありません。
-> `godd notes deploy` 実行時に `@ripla/godd-mcp` の新しいバージョンが利用可能な場合、警告が表示されます。
-### 8. 既存環境を最新化する（CLI 更新の反映）
-すでにデプロイ済みの環境に、新しい `@ripla/godd-mcp` バージョン（Terraform テンプレート変更を含む）を反映する場合の手順です。手順 1〜7（新規オンボーディング）は不要です。
-```bash
-# 1. CLI を更新（インフラ変更を検証する場合は canary を明示。安定版のみなら不要）
-npm install -g @ripla/godd-mcp@canary
-godd version
-# 2. AWS CLI 認証を確認
-export AWS_PROFILE=<PROFILE>          # PowerShell: $env:AWS_PROFILE = "<PROFILE>"
-aws sts get-caller-identity
-# 3. Terraform ファイル・同梱ソースを最新テンプレートで再生成（保存済み設定を非対話で再利用）
-godd notes infra --yes
-# 4. Terraform テンプレートに変更がある場合のみ、{env}-iam → {env} の順で適用（apply 前に plan で差分確認）
-cd terraform/godd-notes/{env}-iam
-terraform init
-cd ../{env}
-terraform init
-cd ../{env}-iam
-terraform plan
-cd ../{env}
-terraform plan
-cd ../{env}-iam
-terraform apply
-cd ../{env}
-terraform apply
-# 5. アプリを再デプロイ
-cd /path/to/your-project
-godd notes deploy -y
-```
-> **`{env}-iam` を先に適用する**: `{env}` モジュール（ECS/RDS/ALB 等）は `{env}-iam` が作成する IAM ロール（ECS 実行ロール、GitHub Actions OIDC 等）を参照するため、`{env}-iam` → `{env}` の順を守ってください。`godd notes infra --yes` は `.tf` を毎回無条件で再生成しますが、**テンプレート自体に変更がある場合のみ** `terraform apply` の再適用が必要です（同梱ソース [`notes-api`/`notes-app`] の変更だけなら手順 4 は不要）。
-### Notes デプロイで `esbuild` の build script が拒否される
-pnpm 10+ で `[ERR_PNPM_IGNORED_BUILDS] Ignored build scripts: esbuild` や `pnpm install` 失敗が出る場合:
-1. CLI を更新する: `npm install -g @ripla/godd-mcp@canary`（`1.0.4-canary.20` 以降）
-2. `notes-app` を再 scaffold する: プロジェクトで `godd notes infra` を再実行（`pnpm-workspace.yaml` を含む同梱ソースで上書き更新）
-3. 再デプロイする: `godd notes deploy -y`
-Terraform テンプレートの変更も反映する必要がある場合は、上記「8. 既存環境を最新化する」の手順4（`terraform apply`）も実行してください。
-ローカルで `notes-app` を直接ビルドする場合は、同梱の `notes-app/README.md` を参照してください。
----
-## リリース（npm publish）
-### canary リリース（自動 / 手動 ref 指定）
-`main` ブランチに `godd-mcp-server/` または `notes/` 配下の変更がマージされると、GitHub Actions（「Publish npm (auto on main push / canary)」）が自動で canary バージョンを publish します。
-- バージョン形式: `v0.1.3-canary.1`（本番最新タグの次 patch + canary 連番）
-- npm タグ: `canary`（`npm install @ripla/godd-mcp@canary` でインストール可能）
-- GitHub Release は作成しない（git tag のみ）
-- 手動実行も可能（#1099）: Actions タブから `ref` 入力に対象ブランチ/タグを指定して dispatch（bump コミットなし・canary タグのみ作成。dev デプロイと downstream 通知は `deploy_dev` 入力で制御）
-### 本番リリース（本番タグ作成 → タグ指定 publish）
-旧「Release GoDD MCP Server (latest / manual)」は #1099 で廃止されました。本番リリースは次の 2 ステップです:
-1. main の対象コミットに本番タグ（例: `v1.0.3`。`patch` / `minor` / `major` は PM が判断）を作成して push
-2. Actions タブから「Publish npm (by tag / manual)」を `tag=v1.0.3` で手動実行（dist-tag はタグ名から自動で `latest` と判定）
-3. GitHub Release は別途手動で作成（リリース前に差分確認が可能）
-### 前提条件
+| Registry に接続できません | 通信、接続先 URL、DNS と HTTPS の状態を確認します。 |
+| Registry が利用できません | 管理者に稼働状況を確認し、復旧後に再実行します。 |
+| 応答待ち・利用制限・時間切れ | 時間をおいて再実行します。 |
+| 認証または権限を確認してください | `godd login` でログインし直した後は MCP を再起動します。停止や権限は管理者に確認してもらいます。 |
+| 配信データを利用できません | 管理者に配信データの登録状態と本体との対応を確認してもらいます。 |
-GitHub リポジトリの **Settings > Secrets and variables > Actions** に以下を設定:
+## 関連ドキュメント
-| Secret 名 | 値 |
-|------------|-----|
-| `NPM_TOKEN` | npmjs.com のアクセストークン（Automation タイプ推奨） |
+- [利用ガイド](https://github.com/ripla-inc/GoDD/blob/main/docs/007_guides/guide-user.md)
+- [配信とガイドの仕様](https://github.com/ripla-inc/GoDD/blob/main/docs/003_requirements/spec/registry-api.md)