【アジャイルFAQ 今日は実験室】BMADを動かしてみる——環境づくりから「AIだけ」と「人が答える」の比べ方まで（後編・手順編）

FROM mcr.microsoft.com/devcontainers/typescript-node:22
# Node.js 22（BMAD v6.12 は 20.12 以上が必要）、git、zsh が入っている

# Claude Code をコンテナ内に入れる
RUN npm install -g @anthropic-ai/claude-code

USER node

{
  "name": "bmad-lab",
  "build": { "dockerfile": "Dockerfile" },
  "features": {
    "ghcr.io/devcontainers/features/python:1": { "version": "3.12" },
    "ghcr.io/va-h/devcontainers-features/uv:1": {}
  },
  "remoteUser": "node",
  "mounts": [
    "source=${localEnv:HOME}/.claude,target=/home/node/.claude,type=bind",
    "source=${localEnv:HOME}/.claude.json,target=/home/node/.claude.json,type=bind"
  ],
  "customizations": {
    "vscode": {
      "extensions": ["anthropic.claude-code"],
      "settings": { "terminal.integrated.defaultProfile.linux": "zsh" }
    }
  }
}

devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . zsh   # コンテナの中のシェルに入る

mkdir -p trials/support-site && cd trials/support-site
npx bmad-method@6.12 install

npx -y bmad-method@6.12 install --yes --tools claude-code --modules bmm \
  --communication-language Japanese --document-output-language Japanese \
  --directory "$PWD"

[core]
user_name = "Tom"
communication_language = "Japanese"
document_output_language = "Japanese"
project_name = "support-site"

uv run _bmad/scripts/resolve_config.py --project-root .

{
  "core": {
    "user_name": "Tom",
    "communication_language": "Japanese",
    "project_name": "support-site",
    "document_output_language": "Japanese",
    "output_folder": "_bmad-output"
  },

#!/usr/bin/env bash
# BMAD v6.12 の実験環境をつくる（開発コンテナの中で実行）
#   bash setup_bmad.sh [作業フォルダ] [呼び名]
#   例：bash setup_bmad.sh trials/support-site Tom
set -euo pipefail
DIR="${1:-trials/support-site}"
NAME="${2:-User}"
BMAD_VERSION="${BMAD_VERSION:-6.12}"

echo "== 前提の確認"
ok=1
check() {
  if command -v "$1" >/dev/null 2>&1; then
    echo "  ✓ $1 $("$1" --version 2>/dev/null | head -1)"
  else
    echo "  ✗ $1 が見つかりません"; ok=0
  fi
}
check node; check python3; check uv; check git; check claude
[ "$ok" = 1 ] || { echo "足りないものを入れてから、もう一度実行してください"; exit 1; }

echo "== BMAD v${BMAD_VERSION} をインストール：$DIR"
mkdir -p "$DIR"
npx -y "bmad-method@${BMAD_VERSION}" install --yes --tools claude-code --modules bmm \
  --communication-language Japanese --document-output-language Japanese \
  --directory "$(cd "$DIR" && pwd)"

echo "== 会話と文書を日本語に固定（_bmad/custom/config.toml）"
cd "$DIR"
if ! grep -q '^\[core\]' _bmad/custom/config.toml 2>/dev/null; then
  cat >> _bmad/custom/config.toml <<EOF

[core]
user_name = "${NAME}"
communication_language = "Japanese"
document_output_language = "Japanese"
project_name = "$(basename "$PWD")"
EOF
fi

echo "== 設定の確認"
uv run _bmad/scripts/resolve_config.py --project-root . \
  | grep -E '"(user_name|communication_language|document_output_language|project_name)"'
echo "完了。次は：cd $DIR && claude を起動し、/bmad-help を呼んでください"

claude -p --dangerously-skip-permissions \
'/bmad-product-brief ヘッドレスで実行してください（headless: true、intent: create）。
入力はこの一文だけです。ほかの情報はありません。
「当社製品の利用者向けのサポートサイトを作り、顧客の利便性を最大化したい。」
人に質問せず、スキルの Headless Mode の指示に従って製品概要を完成させ、最後に JSON の状態を返してください。' \
  < /dev/null > headless_brief.log 2>&1

_bmad-output/planning-artifacts/briefs/brief-support-site-2026-11-09/
├── brief.md      製品概要
├── addendum.md   製品概要に入りきらない材料（調査の要点など）
└── .memlog.md    決定・推測・調査結果の記録

mv _bmad-output/planning-artifacts/briefs/brief-support-site-2026-11-09 \
   _bmad-output/planning-artifacts/briefs/brief-support-site-headless

B=_bmad-output/planning-artifacts/briefs/brief-support-site-headless
claude -p --dangerously-skip-permissions \
"/bmad-prd ヘッドレスで実行してください（headless: true、intent: create）。
入力は製品概要 $B/brief.md と $B/addendum.md だけです。人に質問せず、スキルの references/headless.md の指示に従って PRD を完成させ、最後に JSON の状態を返してください。" \
  < /dev/null > headless_prd.log 2>&1

{
  "status": "partial",
  "intent": "create",
  "open_questions": [
    "★Q1 製品は何か（業務ソフトウェア／消費者向け／機器）。利用者の人数と職種",
    "Q2 現状の問い合わせ件数・内訳・解決までの時間（目標値と最初の記事の選び方が決まる）",
    "★Q3 既存の FAQ・マニュアル・問い合わせ窓口は何で、誰が管理しているか。問い合わせ窓口から何を取り込めるか",
    "…（全10件）"
  ],
  "assumptions": [
    "製品は業務ソフトウェアで、利用者は製品の専門家ではない業務担当者",
    "…（全12件）"
  ]
}

#!/usr/bin/env bash
# 実験1：要望の一文だけを渡し、AIだけ（ヘッドレス）で製品概要とPRDを作らせる
# 開発コンテナの中で実行：bash run_experiment1.sh [作業フォルダ]
# お題を変えるとき：REQUEST="（あなたの要望）" bash run_experiment1.sh
set -euo pipefail
cd "${1:-trials/support-site}"
REQUEST="${REQUEST:-当社製品の利用者向けのサポートサイトを作り、顧客の利便性を最大化したい。}"
BRIEFS=_bmad-output/planning-artifacts/briefs
HEADLESS="$BRIEFS/brief-$(basename "$PWD")-headless"
mkdir -p logs

echo "== 1/3 製品概要をAIだけで作る（数分かかります）"
claude -p --dangerously-skip-permissions \
"/bmad-product-brief ヘッドレスで実行してください（headless: true、intent: create）。
入力はこの一文だけです。ほかの情報はありません。
「${REQUEST}」
人に質問せず、スキルの Headless Mode の指示に従って製品概要を完成させ、最後に JSON の状態を返してください。" \
  < /dev/null > logs/headless_brief.log 2>&1

echo "== 2/3 実験2と混ざらないよう、フォルダ名を変える"
SRC=$(ls -dt "$BRIEFS"/brief-* | grep -v -- '-headless$' | head -1)
mv "$SRC" "$HEADLESS"
echo "   $SRC → $HEADLESS"

echo "== 3/3 その製品概要から、PRDをAIだけで作る（十数分かかります）"
claude -p --dangerously-skip-permissions \
"/bmad-prd ヘッドレスで実行してください（headless: true、intent: create）。
入力は製品概要 $HEADLESS/brief.md と $HEADLESS/addendum.md だけです。人に質問せず、スキルの references/headless.md の指示に従って PRD を完成させ、最後に JSON の状態を返してください。" \
  < /dev/null > logs/headless_prd.log 2>&1

echo "完了。最後の JSON（status、open_questions、assumptions）を確認してください："
echo "  tail -60 $PWD/logs/headless_prd.log"

claude

/bmad-product-brief 製品概要を新しく作成したいです（既存の briefs/brief-support-site-headless は別の実験なので再開しないでください）。

当社製品の利用者向けのサポートサイトを作り、顧客の利便性を最大化したい。

cd trials/support-site/_bmad-output/planning-artifacts   # 作業フォルダの最上位から
grep -n "\[ASSUMPTION" briefs/brief-support-site-headless/brief.md
grep -c "\[ASSUMPTION" prds/*/prd.md

grep "^- (assumption)" briefs/*/.memlog.md
grep "^- (override)"   briefs/*/.memlog.md

# 実験1（AIだけ）の記録から
- (assumption) 製品は B2B の業務ソフトウェア（パッケージ/SaaS）と仮定。根拠なし：『当社製品の利用者』『顧客』の語のみ。B2C や物理製品なら構成が変わる
- (assumption) 現状の問い合わせ窓口は電話・メール中心で、FAQ/マニュアルは分散または PDF と仮定
- (insight) 調査：自己サービスで完全解決は14%、最大の失敗理由は『関連情報が見つからない』43%（Gartner 2024）。サイトの核は記事の量より『見つかること』

# 実験2（人が答える）の記録から
- (decision) 現状の窓口：簡単なサポートサイトが既にある。問い合わせはメール・電話・担当営業経由
- (decision) 今のサイトが役立たない理由：記事が足りない（c）・探しにくい（b）とユーザーは見ている（確かめた結果ではなく見立て）
- (decision) 言い換え（AIの提案、ユーザー未確認）：『サイトを作る』ではなく『操作の質問を、利用者が人に聞かずに短時間で解決でき、それでも残る質問は開発者でない窓口で受ける』状態をつくる
- (override) 『AI自動応答を最初の版に含めない』の仮定を取り下げ、AIの活用を最初の版の範囲に入れた（ユーザー回答：AIも活用したい）。使い方は PRD で決める（候補：記事をもとにした回答／記事の下書き作成／一次窓口の補助）