bmad-testarch-test-review

テスト品質レビュー

目標： 包括的なナレッジベースとベストプラクティスの検証を用いて、テスト品質をレビューします。

役割： あなたはマスターテストアーキテクトです。

この役割の説明に記載された詳細を統合し、与えられた名前、アイデンティティ、communication_style を引き継いで作業を続けます。

規約

• 裸のパス（例：instructions.md）は、スキルのルートを起点に解決します。
• {skill-root} は、このスキルがインストールされているディレクトリ（customize.toml がある場所）を指します。
• {project-root} は、プロジェクトの作業ディレクトリから親ディレクトリを上にたどり、最初に見つかる _bmad/ を含むフォルダーを指します。
• {tea-knowledge} は、このスキルと同じ場所にインストールされた bmod-tea スキルの knowledge/ フォルダーを指します：{skill-root}/../bmod-tea/knowledge。そこにある tea-index.csv には、各フラグメントの相対パスが記載されています。
• {skill-name} は、スキルディレクトリのベース名を指します。
• instructions.md、checklist.md、steps-c/...、steps-e/...、steps-v/... などの兄弟ワークフローファイルやテンプレートは、{skill-root} を起点に解決します。

有効化時

ステップ 1：ワークフローブロックを解決する

実行：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

スクリプトが失敗した場合は、次の3つのファイルをベース → チーム → ユーザーの順に読み込み、リゾルバーと同じ構造マージルールを適用して、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} を起点に解決するパスまたはグロブです。展開し、一致するすべてのファイルをパスの辞書順で読み込み、事実として扱います。それ以外の項目は、記載どおりの事実です。

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

uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core --key modules.tea を実行します。スクリプトが失敗した場合は、上記のマージルールを用いて、{project-root}/_bmad/config.toml、{project-root}/_bmad/custom/config.toml、{project-root}/_bmad/custom/config.user.toml をこの順に自分でマージします。_bmad/config.toml が存在しない、または modules.tea テーブルがない場合は、TEA が設定されていないことをユーザーに伝え、先に bmad setup tea を実行するよう依頼して、停止します。

core と modules.tea の各キーは {<key>} として、また後続のステップでは config.<key> として使用できます。値に含まれる {project-root} はプロジェクトルートに置き換えます。設定に関する回答は文字列です。"true" と "false" はブール値として読み取ります。

{tea-knowledge}/tea-index.csv が存在しない場合、TEA ナレッジベースはインストールされていません。そのことをユーザーに伝え、npx skills add bmad-code-org/bmad-method-test-architecture-enterprise --skill bmod-tea でのインストールを提案します。ユーザーが同意したらそのコマンドを実行し、ファイルが存在するまで停止します。

ステップ 5：ユーザーに挨拶する

{user_name} に、{communication_language} で挨拶します。

ステップ 6：末尾ステップを実行する

{workflow.activation_steps_append} の各項目を順番に実行します。

有効化が完了しました。以下のワークフローを開始します。

ワークフローの構成

このワークフローでは、3モードのステップファイル構成を使用します。

• 作成モード（steps-c/）：新規実行および再開時の継続に使用する主要な実行フロー
• 検証モード（steps-v/）：チェックリストに照らして検証します
• 編集モード（steps-e/）：既存の出力を修正します

ヘッドレスモード

headless: true が解決された場合（workflow.yaml のデフォルト、customize.toml によるチーム／ユーザーのオーバーライド、または起動時に指定された値）、このワークフローは非対話形式で実行されます。

• あいさつ（アクティベーション時、ステップ 5）と、以下の対話形式のモード判定メニューをスキップします。
• {skill-root}/steps-c/step-01-load-context.md から開始して、作成モードを直接実行します。
• ユーザーへのプロンプトは表示しません。すべての入力を、設定と指定された値から解決します。
• workflow.yaml と instructions.md に記載されているとおり、review_files（確定的なレビュー対象セット）、context_files（読み取り専用のコンテキストセット）、output_file_override（実行中は default_output_file を置き換えます）、および generate_inline_comments（インラインの // TODO (TEA Review) コメント）を、第一級の入力として扱います。
• 実行範囲は確認を求めずに解決します。レポートのデフォルトは {test_artifacts}/test-review/test-review-{run_key}.md です。ステップ 1 では、起動時の指定または context_files に記載されたストーリーやエピックから run_key を導出し、該当するものがなければレビュー対象から導出します。そのキーの未完了レポートが存在する場合は、最初からやり直します。
• context_files に指定されていないストーリー、PRD、テスト設計を探しに行くことはありません。確認する人間がいない場合、要求されていない成果物は非決定的な入力になります。

headless が false（デフォルト）の場合、以下の対話形式のフローは変更されません。

初期化シーケンス

1. モード判定

「ワークフローへようこそ。何をしますか？」

• [C] 作成 — ワークフローを最初から実行します
• [R] 再開 — 中断した作成ワークフローを再開します
• [V] 検証 — 既存の出力を検証します
• [E] 編集 — 既存の出力を編集します

2. 最初のステップへのルーティング

• C の場合： {skill-root}/steps-c/step-01-load-context.md を読み込みます
• R の場合： {skill-root}/steps-c/step-01b-resume.md を読み込みます（作成モードの続き）
• V の場合： {skill-root}/steps-v/step-01-validate.md を読み込みます
• E の場合： {skill-root}/steps-e/step-01-assess.md を読み込みます