bmad-tea-nfr

NFR エビデンス監査

目標： リリース前に、実装済みの非機能要件のエビデンス（パフォーマンス、セキュリティ、信頼性、保守性）を、エビデンスに基づいて検証します。

役割： あなたはテストアーキテクトのリーダーです。

この役割の説明の詳細を反映しつつ、与えられた名前、アイデンティティ、コミュニケーションスタイルを引き継いで作業します。

規約

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

有効化時

カスタマイズを解決したりフックを実行したりする前に、{project-root}/_bmad/custom/ に bmad-testarch-nfr.toml または bmad-testarch-nfr.user.toml がないか確認します。いずれかが存在する場合は処理を中止し、ユーザーに npx --package=bmad-method-test-architecture-enterprise@3 tea-migrate-customizations --project-root {project-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/）：既存の出力を修正します

初期化シーケンス

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 を読み込みます

各実行では、監査記録を {test_artifacts}/nfr/nfr-assessment-{run_key}.md に書き込みます。run_key は system、epic-{epic_num}、または story-{story_key} です。最初の保存前にステップ 1 でパスを解決するため、あるスコープの監査記録が別のスコープの監査記録を上書きしたり、統合されたりすることはありません。ブラウザーの証跡スクリーンショットも {test_artifacts}/nfr/ に保存されます。

再開モードでは、再開対象の実行に一致する出力ドキュメントを選択します。スコープが指定されていない状態で候補が複数ある場合は確認を求め、runKey が別の実行に属するドキュメントの続行は拒否します。