@autodevjapan/godd-mcp-alpha 2.6.2 → 2.8.0

package/README.md

@@ -69,7 +69,7 @@ Invoke GoDD in whichever way your client supports:
 |---|---|
 | `run` | Unified entry point — parses a text command like "/godd-a/<tool> <args>" and runs the matching tool |
 | `dev` | Development (plan → implement → test → quality → docs in stages) |
-| `check` | Quality gate (verify spec alignment, tests, types, lint, security) |
+| `check` | Quality gate (verify Spec alignment, tests, types, lint, security) |
 | `docs` | Generate/update documentation |
 | `ship` | Ship (commit at proper granularity → quality check → push → create PR) |
 | `setup` | Environment setup (with recommended stack presets, confirms missing info) |
@@ -82,17 +82,22 @@ Invoke GoDD in whichever way your client supports:
 | `deploy` | Deploy (with verification & rollback plan) |
 | `adr` | Create ADR (Architecture Decision Record) |
 | `release` | Generate release notes (SemVer-compliant) |
-| `github` | GitHub configuration (repository/branch protection etc.) |
+| `github` | GitHub configuration (repository/branch protection, etc.) |
 | `config` | Generate/repair config.godd (auto-detect stack + validation) |
-| `questions` | Manage the question list interactively |
+| `questions` | Interactive Q&A from question list (質問リスト.md) |
 | `e2e` | Browser-based E2E testing (execute & verify critical user flows) |
 | `map` | Project knowledge graph (visualize architecture & dependencies with Mermaid) |
 | `learn` | Save/recall project-specific patterns, conventions, and pitfalls |
-| `scratchpad` | Persistent conversation memory (save/recall/search/list/forget) |
-| `diagram` | Auto-update architecture diagrams (living Mermaid docs in sync with code) |
-| `slide` | Generate presentation slides from project docs (Marp Markdown) |
-| `design` | Generate/update visual designs from the codebase |
-| `metrics` | Token efficiency report for the current session |
+| `scratchpad` | Persistent conversation memory — save/recall/search/list/forget with BM25 vector search (Qdrant or local JSON fallback) |
+| `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 and optional evidence-based quality, budget, learning outcome, and guardrail preflight report |
+| `plan` | Advance one approved plan task at a time with durable state and a test-evidence gate |
+
+The machine-readable version of this table is published at
+[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); the agent
+onboarding guide lives at [getgodd.dev/connect.md](https://getgodd.dev/connect.md).
 
 ### CLI commands
 
@@ -173,8 +178,8 @@ godd-a init
 
 | プロンプト | 説明 |
 |---|---|
-| `run` | 統一エントリポイント — "/godd-a/<tool> <args>" 形式のテキストをパースして対応ツールを実行 |
-| `dev` | 開発（段階的に計画→実装→テスト→品質→ドキュメント） |
+| `run` | 統一エントリポイント — "/godd-a/<tool> <args>" 形式のテキストコマンドをパースして対応ツールを実行 |
+| `dev` | 開発（段階的に計画→実装→テスト→品質→ドキュメントを実行） |
 | `check` | 品質ゲート（Spec整合・テスト・型・Lint・セキュリティを検証） |
 | `docs` | ドキュメント生成/更新 |
 | `ship` | 提出（適切な粒度でコミット → 品質チェック → プッシュ → PR 作成） |
@@ -189,16 +194,21 @@ godd-a init
 | `adr` | ADR（Architecture Decision Record）作成 |
 | `release` | リリースノート生成（SemVer 準拠） |
 | `github` | GitHub 設定（リポジトリ/ブランチ保護等） |
-| `config` | config.godd を生成・修正（スタック自動検出 + バリデーション） |
-| `questions` | 質問リストをインタラクティブに管理 |
+| `config` | config.godd を正確に生成・修正する（スタック自動検出 + バリデーション） |
+| `questions` | 質問リスト（質問リスト.md）からインタラクティブに質問を管理 |
 | `e2e` | ブラウザベース E2E テスト（重要ユーザーフローの実行・検証） |
 | `map` | プロジェクトナレッジグラフ（Mermaid でアーキテクチャ・依存関係を可視化） |
 | `learn` | プロジェクト固有のパターン・慣例・落とし穴を保存/参照 |
-| `scratchpad` | 会話記憶の永続化（save/recall/search/list/forget） |
-| `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメント） |
-| `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown） |
-| `design` | コードベースからビジュアルデザインを生成/更新 |
-| `metrics` | このセッションのトークン効率レポート |
+| `scratchpad` | 会話記憶の永続化 — BM25 ベクター検索で save/recall/search/list/forget（Qdrant またはローカル JSON フォールバック） |
+| `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） |
+| `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） |
+| `design` | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） |
+| `metrics` | トークン効率と、任意の証拠に基づく品質・予算・学習成果・guardrail preflightレポート |
+| `plan` | 承認済み計画を永続状態とテスト証跡ゲート付きで一タスクずつ進める |
+
+この表の機械可読版は
+[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json) に公開しています。
+エージェント向けの接続手順は [getgodd.dev/connect.md](https://getgodd.dev/connect.md) を参照してください。
 
 ### CLI コマンド
 
@@ -279,32 +289,37 @@ godd-a init
 
 | Промпт | Описание |
 |---|---|
-| `run` | Единая точка входа — разбирает текстовую команду "/godd-a/<tool> <args>" и запускает нужный инструмент |
-| `dev` | Разработка (поэтапно: план → реализация → тесты → качество → документация) |
-| `check` | Контроль качества (соответствие спецификации, тесты, типы, линтер, безопасность) |
+| `run` | Единая точка входа — разбирает текстовую команду "/godd-a/<tool> <args>" и запускает соответствующий инструмент |
+| `dev` | Разработка (план → реализация → тесты → качество → документация поэтапно) |
+| `check` | Контроль качества (Spec, тесты, типы, линтер, безопасность) |
 | `docs` | Генерация/обновление документации |
-| `ship` | Отправка (коммит нужной гранулярности → проверка качества → push → создание PR) |
+| `ship` | Отправка (коммит → проверка качества → пуш → создание PR) |
 | `setup` | Настройка среды (с рекомендуемыми пресетами стека) |
-| `review` | Ревью (уровень CTO + контроль качества) |
+| `review` | Ревью (CTO-уровень + контроль качества) |
 | `test` | Запуск/создание тестов |
 | `impact` | Анализ влияния |
-| `commit` | Коммит изменений |
-| `push` | Push на удалённый репозиторий |
-| `pr` | Создание PR (по шаблону) |
-| `deploy` | Деплой (с верификацией и планом отката) |
-| `adr` | Создание ADR (Architecture Decision Record) |
-| `release` | Генерация заметок к релизу (SemVer) |
-| `github` | Настройка GitHub (защита репозитория/веток и т.д.) |
+| `commit` | Зафиксировать изменения |
+| `push` | Отправить в удалённый репозиторий |
+| `pr` | Создать PR (по шаблону) |
+| `deploy` | Развернуть (с проверкой и планом отката) |
+| `adr` | Создать ADR (запись архитектурного решения) |
+| `release` | Сгенерировать заметки к релизу (SemVer) |
+| `github` | Настройка GitHub (репозиторий/защита веток и т.д.) |
 | `config` | Генерация/исправление config.godd (автодетект стека + валидация) |
-| `questions` | Интерактивное управление списком вопросов |
-| `e2e` | E2E-тестирование в браузере (критические пользовательские потоки) |
-| `map` | Граф знаний проекта (архитектура и зависимости через Mermaid) |
-| `learn` | Сохранение/вызов паттернов, соглашений и подводных камней проекта |
-| `scratchpad` | Постоянная память диалога (save/recall/search/list/forget) |
-| `diagram` | Автообновление архитектурных диаграмм (Mermaid в синхронизации с кодом) |
-| `slide` | Генерация слайдов из документации проекта (Marp Markdown) |
-| `design` | Генерация/обновление визуального дизайна из кодовой базы |
-| `metrics` | Отчёт об эффективности токенов текущей сессии |
+| `questions` | Интерактивный Q&A из списка вопросов (質問リスト.md) |
+| `e2e` | E2E-тестирование в браузере (выполнение и проверка критических пользовательских потоков) |
+| `map` | Граф знаний проекта (визуализация архитектуры и зависимостей через Mermaid) |
+| `learn` | Сохранение/вызов специфичных для проекта паттернов, соглашений и подводных камней |
+| `scratchpad` | Постоянная память диалога — save/recall/search/list/forget с BM25 векторным поиском (Qdrant или локальный JSON фоллбэк) |
+| `diagram` | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) |
+| `slide` | Генерация слайдов из документов проекта (формат Marp Markdown) |
+| `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация Pencil.dev) |
+| `metrics` | Эффективность токенов и необязательная оценка качества, бюджета, обучения и предварительной проверки guardrail по доказательствам |
+| `plan` | Пошаговое выполнение утверждённого плана с сохраняемым состоянием и проверкой тестов |
+
+Машиночитаемая версия этой таблицы опубликована по адресу
+[getgodd.dev/godd/commands.json](https://getgodd.dev/godd/commands.json); руководство
+по подключению агента — [getgodd.dev/connect.md](https://getgodd.dev/connect.md).
 
 ### Команды CLI