@ripla/godd-mcp 1.0.4-canary.3 → 1.0.4-canary.30

package/README.md

@@ -76,17 +76,18 @@ Registry API URL (default: http://localhost:8100): https://godd-registry.example
   選択 (例: 1): 1
 ```
 
-完了すると、以下の 2 ファイルが自動生成されます:
+完了すると、以下の 3 ファイルが自動生成されます:
 
 | ファイル | 内容 |
 |---------|------|
-| `config.godd` | ライセンスキー・技術スタック・言語の設定 |
-| `.cursor/mcp.json` | Cursor IDE への MCP サーバー登録（`GODD_CONFIG` で config.godd のパスを指定） |
+| `config.godd` | 技術スタックコンポーネントの設定 |
+| `.env` | ライセンスキー・言語・Registry URL（GoDD 管理値） |
+| `.cursor/mcp.json` | Cursor IDE への MCP サーバー登録 |
 
-> **config.godd にはライセンスキーが含まれます。`.gitignore` に追加してください。**
+> **`.env` にはライセンスキーが含まれます。`.gitignore` に追加してください。**
 >
 > ```gitignore
-> config.godd
+> .env
 > ```
 
 ---
@@ -105,7 +106,9 @@ Registry API URL (default: http://localhost:8100): https://godd-registry.example
 
 ### 技術スタックを変更したい場合
 
-プロジェクトディレクトリで `godd init` を再実行するか、`config.godd` を直接編集してください。Cursor のチャットで `godd_config` ツールを使って更新することもできます。変更後は Cursor IDE を再起動してください。
+プロジェクトディレクトリで `godd init` を再実行してください。コンポーネントは `config.godd` を直接編集することもできます。ライセンスキー・言語・Registry URL は `.env` の `GODD_LICENSE_KEY` / `GODD_LANGUAGE` / `GODD_REGISTRY_URL` を編集してください。Cursor のチャットで `godd_config` ツールを使って更新することもできます。変更後は Cursor IDE を再起動してください。
+
+> **再実行時の既存設定保護**: `config.godd` や `.env` が既に存在する場合、`godd init` は現在の設定をデフォルト値として表示します。Enter を押すだけで既存設定を保持できます。コンポーネントを再選択したい場合は、コンポーネント引き継ぎの質問で `n` を入力してください。
 
 ### バイナリ（ZIP）でのインストール
 
@@ -140,13 +143,15 @@ chmod +x godd
 | `godd install` | `godd i` | GoDD をシステムにインストール |
 | `godd init` | — | プロジェクトのセットアップ（config.godd + .cursor/mcp.json 生成） |
 | `godd server` | `godd s` | MCP サーバーを起動（Cursor が自動実行） |
-| `godd notes deploy` | `godd n deploy` | GoDD Notes をデプロイ（ローカル or AWS、`--target`/`-y` 対応） |
+| `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 --target aws -y`
+> 例: `npx @ripla/godd-mcp notes deploy -y`
 
 ---
 
@@ -211,110 +216,79 @@ Cursor のチャットで以下のツールが使えます。ツール名を指
 
 | ツール | 説明 |
 |--------|------|
-| `godd_setup` | 環境構築。config.godd / .cursor/mcp.json 生成、依存導入 |
-| `godd_config` | config.godd の表示・更新（ライセンスキー、コンポーネント、言語等） |
+| `godd_setup` | 環境構築。config.godd / .env / .cursor/mcp.json 生成、依存導入 |
+| `godd_config` | 設定の表示・更新（components は config.godd、license_key 等は .env） |
 | `godd_install` | ツール/MCP サーバーインストール案内 |
 | `godd_dev_workflow` | 開発ワークフロー全体。環境構築→実装→テスト→コミット→PR |
 
 ---
 
-## @メンションの使い方
-
-GoDD の MCP ツールやエコシステムツールは、Cursor のチャットで **`@` メンション** して明示的に指定できます。
-
-### メンションの方法
+## スラッシュコマンドの使い方
 
-Cursor のチャット入力欄で `@` を入力すると、候補一覧が表示されます。
+Cursor のチャットで `/` を入力すると、GoDD の MCP ツールをスラッシュコマンドとして呼び出せます。
 
-- **MCP ツール**（`godd_dev` 等）→ 「Tools」カテゴリに表示
-- **エコシステムツール**（`Orval` 等）→ 「MCP Resources」カテゴリに表示
+### 呼び出し方法
 
-キーワードを続けて入力すると候補が絞り込まれます。候補をクリックまたは Enter で選択すると、チャットにメンションが挿入されます。
+チャット入力欄で `/` を入力するとコマンド候補が表示されます。キーワードを続けて入力すると候補が絞り込まれます。
 
-### MCP ツールの @メンション
+**コマンド形式**: `/{サーバー名}/{ツール名}`
 
-MCP ツールをメンションすると、AI にそのツールの使用を明示的に指示できます。
-
-**構文**: `@godd_dev`（`@` + ツール名）
+`godd init` で生成される `.cursor/mcp.json` のサーバーキー名（デフォルト: `godd`）がプレフィックスになります。例えばサーバー名が `godd` なら `/godd/dev`、`godd-a` なら `/godd-a/dev` のように表示されます。
 
 ```
 例 1: ツールを明示して依頼
 
-  @godd_dev ユーザー登録 API を実装して
+  /godd/dev ユーザー登録 API を実装して
 
 例 2: 複数ツールの組み合わせ
 
-  @godd_spec この要件を仕様に変換して。
-  完了したら @godd_dev で実装して
+  /godd/spec この要件を仕様に変換して
 
-例 3: 特定ツールの指定がないと、AI が自動選択
+例 3: ツールを指定しなくても AI が自動選択
 
   コミットメッセージを作って
   → AI が自動的に godd_commit を選択
 ```
 
-> **ヒント**: ツール名を指定しなくても AI が自動的に最適なツールを選びます。明示的に指定したい場合にのみ `@` メンションを使ってください。
-
-#### メンション可能な MCP ツール一覧（29 件）
-
-| メンション | 用途 |
-|-----------|------|
-| `@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 init` で選択した技術スタックに応じて、プロジェクトで使用するライブラリやフレームワーク（**エコシステムツール**）が MCP リソースとして自動登録されます。これらもチャットで `@` メンションできます。
-
-メンションすると、そのツール固有の **利用ガイダンス**（ベストプラクティス・コマンド例など）が AI のコンテキストに注入され、ツールに適した正確なアドバイスが得られます。
-
-**構文**: `@` → 候補リストから「MCP Resources」セクションのツール名を選択
-
-```
-例 1: 特定ツールのベストプラクティスに沿った実装依頼
-
-  @Orval を使って API クライアントを再生成して
-
-例 2: ツール固有のガイダンスを活用
-
-  @Alembic でマイグレーションを作って。モデルに email カラムを追加した
-
-例 3: 複数のエコシステムツールを組み合わせ
-
-  @TanStack Query と @Orval を使って、
-  ユーザー一覧の取得を実装して
-
-例 4: MCP ツール + エコシステムツールの組み合わせ
-
-  @godd_dev @Playwright でログインフローの E2E テストを書いて
-```
+> **ヒント**: ツールを明示しなくても AI が自動的に最適なツールを選びます。特定のツールを確実に使いたい場合にスラッシュコマンドを活用してください。
+
+#### スラッシュコマンド一覧（29 件）
+
+| コマンド（サーバー名 `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 init` で選択した技術スタックに応じて、プロジェクトで使用するライブラリやフレームワーク（**エコシステムツール**）の利用ガイダンスが MCP リソースとして自動登録されます。AI はスタック設定に基づいてこのガイダンスを自動的にコンテキストへ注入します。
 
 #### エコシステムツールの例（FastAPI + React 構成の場合）
 
@@ -343,7 +317,7 @@ MCP ツールをメンションすると、AI にそのツールの使用を明
 | モード | 動作 | いつ使う |
 |--------|------|---------|
 | **自動** | ツール名を指定せず依頼すると、AI が最適な MCP ツールを自動選択。エコシステムツールのガイダンスもスタック設定に基づいて自動注入される | 通常の開発作業 |
-| **手動** | `@` で MCP ツールやエコシステムツールを明示指定 | 特定のツールを確実に使いたい場合、複数ツールを組み合わせたい場合 |
+| **手動** | `/` でスラッシュコマンドを明示指定 | 特定のツールを確実に使いたい場合、複数ツールを組み合わせたい場合 |
 
 ---
 
@@ -383,14 +357,13 @@ GODD_CONFIG=/path/to/your-project/config.godd godd server
 
 | エラー | 対処 |
 |--------|------|
-| `Invalid license key` | `config.godd` のライセンスキーが正しいか確認 |
+| `Invalid license key` | `.env` の `GODD_LICENSE_KEY` が正しいか確認 |
 | `Registry 発行のライセンスキーは Registry API で検証してください` | `components` と `registry_url` を設定し、Registry API に接続できる状態で起動 |
 | `License has expired` | 管理者に更新を依頼 |
-| `Seat limit reached` | 管理者にシート解放を依頼 |
 
 ### Registry に接続できない
 
-- `config.godd` の `registry_url` が正しいか確認
+- `.env` の `GODD_REGISTRY_URL` が正しいか確認
 - ネットワーク接続を確認
 - `godd-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 形式の Registry 発行キーは、旧 `stack_profile` のローカル署名検証では利用できません。`components` を設定した Registry モードで利用してください。
 
@@ -408,6 +381,8 @@ npm install -g @ripla/godd-mcp
 godd version
 ```
 
+Notes のクラウドデプロイで pnpm 10+ 関連のエラーが出る場合は、`@latest` ではなく canary を明示して更新してください（後述の「esbuild の build script が拒否される」参照）。
+
 ---
 
 ## GoDD Notes ライフサイクル
@@ -420,6 +395,13 @@ GoDD Notes は GoDD のドキュメント閲覧・編集 Web アプリです。
 npm install -g @ripla/godd-mcp
 ```
 
+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
@@ -437,6 +419,7 @@ 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 ワークフロー
 
@@ -452,11 +435,23 @@ godd notes deploy      # 対話形式
 godd notes deploy -y   # 確認スキップ（CI 向け）
 ```
 
-ローカルの `godd-notes/notes-api` と `notes-app` を AWS にデプロイします。
+`.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` の新しいバージョンが利用可能な場合、警告が表示されます。
 
+### 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`
+
+ローカルで `notes-app` を直接ビルドする場合は、同梱の `notes-app/README.md` を参照してください。
+
 ### ローカル開発（Docker Compose）
 
 ```bash