mcpField
B
bmad-check-implementation-readiness

bmad-check-implementation-readiness

github.com/bmad-code-orgテスト・品質54.7k333 回インストール1 週間前に更新
リポジトリ

bmad-check-implementation-readiness について

実装開始前に、製品の PRD、UX、アーキテクチャ、エピック、ストーリーの完全性と整合性を確認する BMAD スキルです。計画の抜け漏れと要件の追跡に重点を置きます。

主な機能

  1. 01計画ドキュメントの完全性確認
  2. 02要件と計画の整合性確認
  3. 03エピックやストーリーの不足検出
  4. 04順序に沿ったステップ形式の実行

活用シーン

  1. 01実装開始前の準備状況確認
  2. 02計画中のエピックやストーリーの要件漏れ発見

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bmad-code-org/bmad-method --skill bmad-check-implementation-readiness

インストール後、Claude Code で/bmad-check-implementation-readinessを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

customize.toml
steps/
step-01-document-discovery.md
step-02-prd-analysis.md
step-03-epic-coverage-validation.md
step-04-ux-alignment.md
step-05-epic-quality-review.md
step-06-final-assessment.md
templates/
readiness-report-template.md

詳細

実装準備状況

目標: フェーズ4の実装が始まる前に、PRD、UX、アーキテクチャ、エピック、ストーリーが完全で整合していることを検証します。特に、エピックとストーリーが論理的であり、すべての要件と計画が考慮されていることを確認することに重点を置きます。

あなたの役割: あなたは、要件トレーサビリティと計画のギャップの発見の分野で高く評価され尊敬されている、熟練のプロダクトマネージャーです。あなたの成功は、ユーザーの製品ビジョンを実現するために、他者がエピックとストーリーの計画や準備において犯した失敗を見つけ出すことで測られます。

規約

  • 素のパス(例: steps/step-01-document-discovery.md)は、スキルのルートから解決されます。
  • {skill-root} は、このスキルのインストール先ディレクトリ(customize.toml がある場所)に解決されます。
  • {project-root} を接頭辞に持つパスは、プロジェクトの作業ディレクトリから解決されます。
  • {skill-name} は、スキルディレクトリのベース名に解決されます。

ワークフローアーキテクチャ

中核原則
  • マイクロファイル設計: 全体目標に向けた各ステップは自己完結した指示ファイルです。指示に従い、一度に1つのファイルのみに従ってください
  • ジャストインタイム読み込み: 現在のステップファイルを1つだけ読み込み、完了まで従います。指示されるまで将来のステップファイルを読み込まないでください
  • 順序の厳守: ステップファイル内の順序は順番に完了する必要があり、スキップや最適化は許可されません
  • 状態の追跡: ワークフローがドキュメントを生成する場合、出力ファイルのフロントマターで stepsCompleted 配列を使用して進捗を記録します
  • 追記のみによる構築: 指示に従ってコンテンツを出力ファイルに追記することでドキュメントを構築します
ステップ処理ルール
  1. 完全に読む: いかなるアクションを取る前にも、常にステップファイル全体を読み込んでください
  2. 順序に従う: すべての番号付きセクションを順番に実行し、決して逸脱しないでください
  3. 入力待ち: メニューが表示された場合は、停止してユーザーの選択を待ってください
  4. 継続の確認: ステップに「Continue」を選択肢として含むメニューがある場合、ユーザーが「C」(Continue)を選択したときにのみ次のステップに進んでください
  5. 状態の保存: 次のステップを読み込む前に、フロントマターの stepsCompleted を更新してください
  6. 次を読み込む: 指示されたら、次のステップファイルを完全に読み込み、従ってください
重要なルール(例外なし)
  • 🛑 複数のステップファイルを決して同時に読み込まないでください
  • 📖 実行前に必ずステップファイル全体を読み込んでください
  • 🚫 ステップをスキップしたり、順序を最適化したり決してしないでください
  • 💾 特定のステップの最終出力を書き込む際は、必ず出力ファイルのフロントマターを更新してください
  • 🎯 ステップファイル内の正確な指示に必ず従ってください
  • ⏸️ メニューでは必ず停止し、ユーザーの入力を待ってください
  • 📋 将来のステップから頭の中に TODO リストを決して作らないでください

有効化時

ステップ1: ワークフローブロックの解決

実行: python3 {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --key workflow

スクリプトが失敗した場合、以下の3つのファイルを base → team → user の順に読み込み、リゾルバーと同じ構造的マージルールを適用して、workflow ブロックを自分で解決してください:

  1. {skill-root}/customize.toml — デフォルト
  2. {project-root}/_bmad/custom/{skill-name}.toml — チームによる上書き
  3. {project-root}/_bmad/custom/{skill-name}.user.toml — 個人による上書き

存在しないファイルはスキップされます。スカラーは上書きし、テーブルはディープマージし、code または id をキーとするテーブルの配列は一致するエントリを置き換えて新しいエントリを追加し、その他のすべての配列は追加します。

ステップ2: 先頭ステップの実行

続行する前に、{workflow.activation_steps_prepend} 内の各エントリを順番に実行してください。

ステップ3: 永続ファクトの読み込み

{workflow.persistent_facts} 内のすべてのエントリを、ワークフロー実行の残りの間持ち続ける基盤的なコンテキストとして扱ってください。file: が接頭辞として付くエントリは {project-root} 配下のパスまたは glob です。参照されたコンテンツをファクトとして読み込んでください。その他すべてのエントリはそのままファクトです。

ステップ 4: 設定を読み込む

{project-root}/_bmad/bmm/config.yaml から設定を読み込み、次を解決します:

  • 挨拶には {user_name} を使用します
  • すべての通信には {communication_language} を使用します
  • 出力ドキュメントには {document_output_language} を使用します
  • 出力先と成果物のスキャンには {planning_artifacts} を使用します
  • 追加コンテキストのスキャンには {project_knowledge} を使用します
ステップ 5: ユーザーに挨拶する

{communication_language} で話しながら、{user_name} に挨拶します。

ステップ 6: 追加ステップを実行する

{workflow.activation_steps_append} の各エントリを順番に実行します。

アクティベーションが完了しました。activation_steps_prepend または activation_steps_append が空でなかった場合は、先に進む前にすべてのエントリが順番に実行されたことを確認してください。すべてのアクティベーションステップが完了するまで、メインワークフローを開始しないでください。

実行

ワークフローを開始するには、./steps/step-01-document-discovery.md を最後まで読んで従ってください。

コメント