@autodevjapan/godd-mcp-alpha 1.25.20 → 1.26.0

package/README.md

@@ -57,6 +57,17 @@ After installation, restart Cursor IDE and the GoDD MCP α server will start aut
 
 **Option 2 — Natural language in Agent mode:** In Cursor's Agent mode, you can ask the AI in plain language (e.g., "run dev", "do a review") and the AI will automatically detect and call the appropriate GoDD tool.
 
+### Token Efficiency
+
+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.
+
+| Approach | How it works | Token cost per call |
+|---|---|---|
+| **Cursor Rules** | All rules always in context | ~80,000 tokens × every chat |
+| **GoDD MCP** | Only the called prompt, when called | ~2,000–5,000 tokens per call |
+
+Use `/metrics` at any time during a session to see your actual token usage and estimated savings vs. the Cursor Rules baseline.
+
 ### GoDD Prompts
 
 Available GoDD prompts (MCP tools) in Cursor IDE:
@@ -86,6 +97,7 @@ Available GoDD prompts (MCP tools) in Cursor IDE:
 | `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. always-on Cursor Rules baseline |
 
 ### CLI Commands
 
@@ -201,6 +213,17 @@ godd-a init --auto
 
 **方法 2 — Agent モードでの自然言語指示:** Cursor の Agent モードでは、自然言語で指示するだけで AI が適切な GoDD ツールを自動的に検出して呼び出します（例：「dev して」「レビューして」）。
 
+### トークン効率
+
+GoDD MCP はプロンプトを**オンデマンドで配信**します。呼び出したプロンプトだけが AI のコンテキストに送られます。全ルールを毎会話の開始から常時コンテキストに含める Cursor Rules とは根本的に異なります。
+
+| 方式 | 仕組み | 1回あたりのトークンコスト |
+|---|---|---|
+| **Cursor Rules** | 全ルールを常時コンテキストに含む | ~80,000 tokens × 毎会話 |
+| **GoDD MCP** | 呼び出したプロンプトだけを必要なときに配信 | ~2,000〜5,000 tokens / 呼び出し |
+
+セッション中いつでも `/metrics` を実行すると、実際のトークン使用量と Cursor Rules 方式との節約推定値を確認できます。
+
 ### GoDD プロンプト一覧
 
 Cursor IDE 上で利用できる GoDD プロンプト（MCP ツール）の一覧です。
@@ -230,6 +253,7 @@ Cursor IDE 上で利用できる GoDD プロンプト（MCP ツール）の一
 | `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） |
 | `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） |
 | `design` | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） |
+| `metrics` | トークン効率レポート — このセッションの配信トークン数と Cursor Rules 常時読み込み方式との比較 |
 
 ### CLI コマンド
 
@@ -345,6 +369,17 @@ godd-a init --auto
 
 **Способ 2 — Естественный язык в режиме Agent:** В режиме Agent Cursor можно просто попросить AI использовать нужный инструмент (например, «запусти dev», «сделай review») — AI автоматически обнаружит и вызовет соответствующий инструмент GoDD.
 
+### Эффективность токенов
+
+GoDD MCP доставляет промпты **по требованию** — в контекст AI отправляется только вызванный промпт. Это принципиально отличается от Cursor Rules, где все правила загружаются в контекст с самого начала каждого чата.
+
+| Подход | Принцип работы | Стоимость токенов за вызов |
+|---|---|---|
+| **Cursor Rules** | Все правила всегда в контексте | ~80 000 токенов × каждый чат |
+| **GoDD MCP** | Только нужный промпт, только когда нужен | ~2 000–5 000 токенов за вызов |
+
+В любой момент сессии введите `/metrics`, чтобы увидеть фактическое использование токенов и расчётную экономию по сравнению с подходом Cursor Rules.
+
 ### Список промптов GoDD
 
 Доступные промпты GoDD (MCP-инструменты) в Cursor IDE:
@@ -374,6 +409,7 @@ godd-a init --auto
 | `diagram` | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) |
 | `slide` | Генерация презентационных слайдов из документации проекта (формат Marp Markdown) |
 | `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация с Pencil.dev) |
+| `metrics` | Отчёт об эффективности токенов — токены этой сессии vs. базовый уровень Cursor Rules |
 
 ### Команды CLI