Domain 1: Agentic Architecture & Orchestration

// 正しいエージェンティックループ（TypeScript）
const messages: Message[] = [...];
while (true) {
  const response = await client.messages.create({ model, tools, messages });
 
  // stop_reasonで分岐
  if (response.stop_reason === "end_turn") break;  // ✅ 終了
 
  if (response.stop_reason === "tool_use") {
    messages.push({ role: "assistant", content: response.content });
    const toolResults = await executeTools(response.content);
    messages.push({ role: "user", content: toolResults }); // 履歴に追加
  }
}
// ❌ Anti-pattern: if (text.includes("完了")) break;  → 自然言語で判定
// ❌ Anti-pattern: for (let i=0; i<10; i++) { ... }   → 固定回数が主要停止機構

// ✅ 良いコンテキスト渡しの例
const analysisAgentPrompt = `
## 元のユーザー要求
"Q4の売上トレンドと競合動向を比較した投資レポートを作成"
 
## 前段（Search Agent）の出力
${JSON.stringify(searchResults, null, 2)}
 
## あなたのタスク
上記の検索結果を分析し、以下のJSON形式で返してください：
{
  "trends": [{"metric": string, "direction": "up"|"down", "evidence": {...}}],
  "competitors": [{"name": string, "signal": string, "source_url": string}]
}
 
## 制約
- 公開日2024年以降のソースのみ使用
- 各claim に source_url と公開日を必ず含める
`;
 
// ❌ 悪い例：コンテキストなし
const badPrompt = "競合を分析してください";
// → サブエージェントが「何の競合？どんなフォーマットで？」を推測することになり信頼性低下