bmad-testarch-nfr について
bmad-testarch-nfrは、リリース前に非機能要件の証拠を監査するテストアーキテクト向けワークフローです。性能、セキュリティ、信頼性、保守性を確認し、作成・再開・検証・編集に対応します。
主な機能
- 01性能・セキュリティ・信頼性・保守性の証拠監査
- 02監査の作成・再開・検証・編集
- 03システム・エピック・ストーリー別の監査
- 04監査レポートとブラウザー画面の保存
活用シーン
- 01リリース前の非機能要件の証拠評価
- 02中断した監査ワークフローの再開
- 03既存の監査結果の検証や編集
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bmad-code-org/ bmad-method-test-architecture-enterprise --skill bmad-testarch-nfrインストール後、Claude Code で/bmad-testarch-nfrを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
bmod.tomlchecklist.mdcustomize.tomlinstructions.mdnfr-report-template.mdworkflow.yamlresources/nfr-assessment.example.mdsteps-c/nfr-status-definitions.mdstep-01-load-context.mdstep-01b-resume.mdstep-02-define-thresholds.mdstep-03-gather-evidence.mdstep-04-evaluate-and-score.mdstep-04a-subagent-security.mdstep-04b-subagent-performance.mdstep-04c-subagent-reliability.mdstep-04d-subagent-maintainability.mdstep-04e-aggregate-nfr.mdstep-05-generate-report.mdsteps-e/step-01-assess.mdstep-02-apply-edit.mdsteps-v/step-01-validate.md詳細
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}は、スキルディレクトリのベース名を指します。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 ブロックを自分で解決してください。
{skill-root}/customize.toml— デフォルト{project-root}/_bmad/custom/{skill-name}.toml— チームによる上書き{project-root}/_bmad/custom/{skill-name}.user.toml— 個人設定による上書き
存在しないファイルはスキップします。スカラーは上書きし、テーブルはディープマージします。code または id をキーとするテーブル配列は、一致するエントリーを置き換え、新しいエントリーを追加します。それ以外の配列はすべて追加します。
ステップ 2:先頭追加ステップを実行する
続行する前に、{workflow.activation_steps_prepend} の各エントリーを順に実行します。
ステップ 3:永続的な事実を読み込む
{workflow.persistent_facts} の各エントリーを、ワークフローの実行中に保持する基礎コンテキストとして扱います。file: で始まるエントリーは、{project-root} を起点に解決するパスまたは glob です。これらを展開し、一致するすべてのファイルをパスの辞書順に読み込み、事実として扱います。それ以外のエントリーは、記載どおりの事実です。
ステップ 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 が別の実行に属している場合は、続行を拒否します。