pi-brainstorm 0.2.0 → 0.3.1

package/README.md

@@ -10,13 +10,14 @@ The plugin stores each participant's full contribution in a local meeting blackb
 
 ## Features
 
-- Multi-model brainstorming with GPT, DeepSeek, and MiniMax style participants.
+- Multi-model brainstorming with configurable participants (default: GPT, DeepSeek, MiniMax).
 - Debate / battle mode where agents prosecute, stress-test, and challenge positions.
+- Configuration-driven: add, remove, or customize participants via YAML.
 - Round-by-round summaries focused on consensus, disagreement, and next questions.
 - Full participant contributions stored as Markdown files under `.pi-meetings/`.
 - Compact visible cards in the main conversation instead of long pasted transcripts.
 - JSONL index for lightweight cross-round context.
-- Bundled default participant agent definitions for first-time setup.
+- Managed agent files generated from config — update one YAML, all agents sync.
 
 ## Install
 
@@ -29,7 +30,7 @@ pi install npm:pi-brainstorm
 From GitHub:
 
 ```bash
-pi install git:github.com/Jarcis-cy/pi-brainstorm@v0.2.0
+pi install git:github.com/Jarcis-cy/pi-brainstorm@v0.3.1
 ```
 
 For local development:
@@ -38,15 +39,47 @@ For local development:
 pi install /Users/jarcis/Project/pi-brainstorm
 ```
 
-## Prerequisites
+## Configuration
+
+Participants are defined in YAML. The extension loads config in this order (later overrides earlier):
+
+1. Package default: `config/default.yaml` (shipped with the package)
+2. User override: `~/.pi/agent/pi-brainstorm.yaml`
+3. Project override: `.pi-brainstorm.yaml` or `.pi/pi-brainstorm.yaml`
+
+Arrays (e.g. `participants`) replace entirely; objects deep-merge.
+
+### Adding a new participant
+
+Create `~/.pi/agent/pi-brainstorm.yaml` (user-level) or `.pi-brainstorm.yaml` (project-level):
+
+```yaml
+participants:
+  - displayName: Claude
+    agentName: claude-brainstormer
+    description: Claude brainstorming consultant. Nuanced analyst for multi-model discussion sessions.
+    model: anthropic/claude-sonnet-4-20250514:xhigh
+    roleTitle: Nuanced Analyst
+    rolePrompt: |
+      你是多模型头脑风暴中的分析顾问。擅长细致入微的论证和长篇分析。用中文回答。
+    whatYouDo:
+      - 提供细致、深入的逐点分析
+      - 识别细微差别和边缘情况
+      - 撰写结构清晰的长篇论证
+    debatePersona:
+      label: THE ANALYST
+      prompt: |
+        DEBATE MODE. You are THE ANALYST. Dissect every argument with precision. Find the weakest link in every chain of reasoning. Use Chinese.
+    brainstormRole: Nuanced analyst
+```
+
+To replace the default participants entirely, define a full `participants` list in your override file.
 
-This extension expects pi's `subagent` tool to be available. The command handler creates the local meeting record and then instructs the main agent to run:
+User-level config can create or update managed agent files in `~/.pi/agent/agents/` after confirmation. Project-level config is used for the current session, but it does not auto-write global agent files; create those agents manually or move the config to `~/.pi/agent/pi-brainstorm.yaml` when you want automatic sync.
 
-- `gpt-brainstormer`
-- `deepseek-brainstormer`
-- `minimax-brainstormer`
+### Managed agent files
 
-On first use, if any of these user-level agents are missing, the extension asks before writing bundled defaults to `~/.pi/agent/agents/`. Existing files are never overwritten.
+Agent files generated by pi-brainstorm contain `<!-- managed-by: pi-brainstorm -->`. These files are overwritten when the config changes. Existing agent files without this marker are never touched.
 
 ## Commands
 
@@ -55,7 +88,7 @@ On first use, if any of these user-level agents are missing, the extension asks
 /debate <topic>
 ```
 
-`/brainstorm` starts a three-round multi-model brainstorming session.
+`/brainstorm` starts an interactive three-round multi-model brainstorming session. After Round 1 and Round 2, the facilitator should stop, summarize the round, and wait for your feedback or permission before continuing.
 
 `/debate` starts an open-ended multi-agent battle that should continue until convergence or user intervention.
 
@@ -65,7 +98,7 @@ On first use, if any of these user-level agents are missing, the extension asks
 participant model -> meeting_append_entry -> .pi-meetings/... files
 participant model -> short WROTE_ENTRY summary -> facilitator context
 file watcher -> compact visible card -> main chat
-facilitator -> consensus / disagreement / final synthesis
+facilitator -> round checkpoint / consensus / disagreement / final synthesis
 ```
 
 The blackboard files are the source of truth for the session. The facilitator can read the index or specific entries when producing summaries.

package/README.zh-CN.md

@@ -10,13 +10,14 @@ English README: [README.md](./README.md).
 
 ## 功能
 
-- 多模型头脑风暴：默认包含 GPT、DeepSeek、MiniMax 风格参与者。
+- 多模型头脑风暴：参与者可配置（默认：GPT、DeepSeek、MiniMax）。
 - 辩论 / battle 模式：Agent 会攻击、审视、反驳彼此的观点。
+- 配置驱动：通过 YAML 添加、删除或自定义参与者。
 - 每轮输出聚焦共识、分歧、关键问题和下一步方向。
 - 参与者完整发言以 Markdown 文件保存到 `.pi-meetings/`。
 - 主会话中展示紧凑发言卡片，而不是粘贴长篇 transcript。
 - 使用 JSONL 索引作为轻量级跨轮上下文入口。
-- 首次使用时可安装内置的默认参与者 agent 定义。
+- 由配置自动生成托管的 agent 文件——更新一个 YAML，所有 agent 同步。
 
 ## 安装
 
@@ -29,7 +30,7 @@ pi install npm:pi-brainstorm
 通过 GitHub 安装：
 
 ```bash
-pi install git:github.com/Jarcis-cy/pi-brainstorm@v0.2.0
+pi install git:github.com/Jarcis-cy/pi-brainstorm@v0.3.1
 ```
 
 本地开发安装：
@@ -38,15 +39,53 @@ pi install git:github.com/Jarcis-cy/pi-brainstorm@v0.2.0
 pi install /Users/jarcis/Project/pi-brainstorm
 ```
 
-## 前置条件
+## 配置
+
+参与者通过 YAML 定义。插件按以下顺序加载配置（后者覆盖前者）：
+
+1. 包默认配置：`config/default.yaml`（随包发布）
+2. 用户级覆盖：`~/.pi/agent/pi-brainstorm.yaml`
+3. 项目级覆盖：`.pi-brainstorm.yaml` 或 `.pi/pi-brainstorm.yaml`
+
+数组（如 `participants`）整体替换；对象字段深度合并。
+
+### 添加新参与者
+
+创建 `~/.pi/agent/pi-brainstorm.yaml`（用户级）或 `.pi-brainstorm.yaml`（项目级）：
+
+```yaml
+participants:
+  - displayName: Claude
+    agentName: claude-brainstormer
+    description: Claude 头脑风暴顾问。细致入微的分析师，用于多模型讨论。
+    model: anthropic/claude-sonnet-4-20250514:xhigh
+    roleTitle: 细致分析师
+    rolePrompt: |
+      你是多模型头脑风暴中的分析顾问。擅长细致入微的论证和长篇分析。用中文回答。
+    whatYouDo:
+      - 提供细致、深入的逐点分析
+      - 识别细微差别和边缘情况
+      - 撰写结构清晰的长篇论证
+    debatePersona:
+      label: THE ANALYST
+      prompt: |
+        DEBATE MODE. You are THE ANALYST. Dissect every argument with precision. Find the weakest link in every chain of reasoning. Use Chinese.
+    brainstormRole: 细致分析师
+```
+
+如需完全替换默认参与者，在覆盖文件中定义完整的 `participants` 列表即可。
+
+用户级配置可以在确认后创建或更新 `~/.pi/agent/agents/` 下的受管理 agent 文件。项目级配置只影响当前会话编排，但不会自动写入全局 agent 文件；如果需要自动同步 agent，请手动创建对应 agent，或把配置移到 `~/.pi/agent/pi-brainstorm.yaml`。
 
-该扩展依赖 pi 中已有的 `subagent` 工具。命令处理器会先创建本地会议记录，然后让主 Agent 调用这些参与者：
+### 托管的 Agent 文件
+
+由 pi-brainstorm 生成的 agent 文件包含 `<!-- managed-by: pi-brainstorm -->` 标记。当配置变更时，这些文件会被覆盖。不含此标记的已有 agent 文件永远不会被修改。
+
+## 前置条件
 
-- `gpt-brainstormer`
-- `deepseek-brainstormer`
-- `minimax-brainstormer`
+该扩展依赖 pi 中已有的 `subagent` 工具。命令处理器会先创建本地会议记录，然后让主 Agent 调用配置中定义的参与者（默认：`gpt-brainstormer`、`deepseek-brainstormer`、`minimax-brainstormer`）。
 
-第一次使用时，如果这些用户级 agent 不存在，扩展会询问是否把内置默认定义写入 `~/.pi/agent/agents/`。已有同名文件不会被覆盖。
+第一次使用时，如果这些用户级 agent 不存在，扩展会询问是否写入内置默认定义。已有同名且不含托管标记的文件不会被覆盖。
 
 ## 命令
 
@@ -55,7 +94,7 @@ pi install /Users/jarcis/Project/pi-brainstorm
 /debate <主题>
 ```
 
-`/brainstorm` 启动三轮多模型头脑风暴。
+`/brainstorm` 启动交互式三轮多模型头脑风暴。Round 1 和 Round 2 结束后，主持人应停止、总结本轮，并等待你的反馈或继续许可，再进入下一轮。
 
 `/debate` 启动开放式多 Agent battle，直到收敛或用户介入为止。
 
@@ -65,7 +104,7 @@ pi install /Users/jarcis/Project/pi-brainstorm
 参与者模型 -> meeting_append_entry -> .pi-meetings/... 文件
 参与者模型 -> 短 WROTE_ENTRY 摘要 -> 主持人上下文
 文件 watcher -> 短卡片 -> 主会话可见区域
-主持人 -> 共识 / 分歧 / 最终综合
+主持人 -> 每轮 checkpoint / 共识 / 分歧 / 最终综合
 ```
 
 黑板文件是会话事实源。主持人可以按需读取索引或具体条目，然后生成结构化总结。

package/config/default.yaml

@@ -0,0 +1,58 @@
+# pi-brainstorm default configuration
+# Each participant defines a subagent that joins brainstorming/debate sessions.
+#
+# To override: create ~/.pi/agent/pi-brainstorm.yaml (user-level)
+#               or .pi-brainstorm.yaml / .pi/pi-brainstorm.yaml (project-level)
+# Later files override earlier. Arrays replace entirely; objects deep-merge.
+
+participants:
+  - displayName: GPT
+    agentName: gpt-brainstormer
+    description: GPT brainstorming consultant. Visionary strategist for multi-model discussion sessions.
+    model: vendor-codex/gpt-5.5:xhigh
+    roleTitle: Visionary Strategist
+    rolePrompt: |
+      你是多模型头脑风暴中的愿景战略家。思考大局，发现别人忽略的机会，将复杂权衡综合为清晰方向。用中文回答。
+    whatYouDo:
+      - 提出创新的战略方向和解决方案
+      - 发现别人忽略的机会和盲点
+      - 把零散想法综合成连贯战略
+    debatePersona:
+      label: THE PROSECUTOR
+      prompt: |
+        DEBATE MODE. You are THE PROSECUTOR. Attack the other positions ruthlessly. Find every logical flaw, every hidden assumption, every missing edge case. Be relentless. Do not concede easily. Use Chinese.
+    brainstormRole: Visionary strategist
+
+  - displayName: DeepSeek
+    agentName: deepseek-brainstormer
+    description: DeepSeek brainstorming consultant. Meticulous systems thinker for multi-model discussion sessions.
+    model: deepseek/deepseek-v4-pro:xhigh
+    roleTitle: Meticulous Systems Thinker
+    rolePrompt: |
+      你是多模型头脑风暴中的系统思考者。分析结构、依赖、扩展上限和失败模式。用中文回答。
+    whatYouDo:
+      - 从结构、依赖和风险角度分析提案
+      - 识别隐藏耦合、扩展上限和失败模式
+      - 提出具体、可实现、可验证的技术优化方案
+    debatePersona:
+      label: THE SYSTEMS SKEPTIC
+      prompt: |
+        DEBATE MODE. You are THE SYSTEMS SKEPTIC. Dissect the structural implications of every proposal. What breaks at scale? Where are the hidden costs? What dependencies create risk? Be precise and unforgiving. Use Chinese.
+    brainstormRole: Systems thinker
+
+  - displayName: MiniMax
+    agentName: minimax-brainstormer
+    description: MiniMax brainstorming consultant. Creative lateral thinker for multi-model discussion sessions.
+    model: minimax-cn/MiniMax-M3:xhigh
+    roleTitle: Creative Lateral Thinker
+    rolePrompt: |
+      你是多模型头脑风暴中的创意顾问。跳出框框思考，挑战隐性假设，提出非常规方案。用中文回答。
+    whatYouDo:
+      - 从意想不到的角度切入问题
+      - 提出打破常规的创新方案
+      - 挑战团队隐性假设
+    debatePersona:
+      label: THE CONTRARIAN
+      prompt: |
+        DEBATE MODE. You are THE CONTRARIAN. Take the opposite position from the dominant view. Expose groupthink. Propose radical alternatives. Challenge the fundamental premise if needed. Use Chinese.
+    brainstormRole: Creative lateral thinker

package/extensions/brainstorm.ts

@@ -1,11 +1,13 @@
 /**
  * pi-brainstorm — Multi-model brainstorm/debate extension for Pi
  *
- * Runs brainstorm and battle-style debate sessions across multiple subagents.
- * Full participant contributions are stored in a local filesystem blackboard,
- * while the main conversation sees compact cards and facilitator synthesis.
+ * Runs brainstorm and debate sessions across multiple subagents configured
+ * via YAML. Full participant contributions are stored in a local filesystem
+ * blackboard, while the main conversation sees compact cards and facilitator
+ * synthesis.
  *
  * Features:
+ * - Configuration-driven participants (YAML)
  * - meeting_append_entry tool — concurrency-safe append to meeting folder
  * - meeting_read_index tool — read meeting index
  * - meeting_read_entry tool — read full entry content
@@ -13,15 +15,632 @@
  * - /debate command — open-ended multi-agent debate
  * - meeting-entry message renderer — compact cards with expandable content
  * - File watcher — auto-posts new entries into the main conversation
+ * - Managed agent file generation from config
  */
 
 import * as path from "node:path";
 import * as fs from "node:fs";
 import * as fsp from "node:fs/promises";
+import { fileURLToPath } from "node:url";
 import { getAgentDir, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { withFileMutationQueue } from "@earendil-works/pi-coding-agent";
 import { Text, Box } from "@earendil-works/pi-tui";
+import * as YAML from "yaml";
+
+// ────────────────────────────────────────────────────────
+// Types
+// ────────────────────────────────────────────────────────
+
+interface DebatePersona {
+  label: string;
+  prompt: string;
+}
+
+interface ParticipantConfig {
+  displayName: string;
+  agentName: string;
+  description?: string;
+  model: string;
+  roleTitle?: string;
+  rolePrompt: string;
+  whatYouDo?: string[];
+  debatePersona?: DebatePersona;
+  brainstormRole?: string;
+  tools?: string[];
+}
+
+interface BrainstormConfig {
+  participants: ParticipantConfig[];
+}
+
+// ────────────────────────────────────────────────────────
+// Constants
+// ────────────────────────────────────────────────────────
+
+const MANAGED_MARKER = "<!-- managed-by: pi-brainstorm -->";
+const DEFAULT_TOOLS = [
+  "read",
+  "grep",
+  "find",
+  "ls",
+  "meeting_append_entry",
+  "meeting_read_index",
+  "meeting_read_entry",
+];
+
+// ────────────────────────────────────────────────────────
+// Config helpers
+// ────────────────────────────────────────────────────────
+
+/**
+ * Deep-merge two values. Arrays are replaced entirely; objects are
+ * shallow-merged recursively; scalars use the overlay value.
+ */
+function deepMerge(base: any, overlay: any): any {
+  if (overlay === null || overlay === undefined) return base;
+  if (base === null || base === undefined) return overlay;
+
+  if (Array.isArray(base) && Array.isArray(overlay)) {
+    return overlay;
+  }
+
+  if (
+    typeof base === "object" &&
+    typeof overlay === "object" &&
+    !Array.isArray(base) &&
+    !Array.isArray(overlay)
+  ) {
+    const result: Record<string, any> = { ...base };
+    for (const key of Object.keys(overlay)) {
+      result[key] =
+        key in result
+          ? deepMerge(result[key], overlay[key])
+          : overlay[key];
+    }
+    return result;
+  }
+
+  return overlay;
+}
+
+/**
+ * Resolve extension directory from import.meta.url.
+ */
+function getExtensionDir(): string {
+  return path.dirname(fileURLToPath(import.meta.url));
+}
+
+/**
+ * Load and merge config from all locations, in priority order (later wins):
+ *   1. Package default: config/default.yaml (relative to package root or extension dir)
+ *      Also try brainstorm.yaml in extension dir (for manual installs)
+ *   2. User override: ~/.pi/agent/pi-brainstorm.yaml
+ *   3. Project override: {cwd}/.pi-brainstorm.yaml
+ *   4. Project override: {cwd}/.pi/pi-brainstorm.yaml
+ */
+function hasProjectConfig(cwd: string): boolean {
+  if (!cwd) return false;
+  return [
+    path.join(cwd, ".pi-brainstorm.yaml"),
+    path.join(cwd, ".pi", "pi-brainstorm.yaml"),
+  ].some((candidate) => fs.existsSync(candidate));
+}
+
+function loadConfig(cwd: string): BrainstormConfig {
+  const extensionDir = getExtensionDir();
+  const packageRoot = path.dirname(extensionDir);
+
+  // Step 1: package/extension defaults
+  const defaultCandidates = [
+    path.join(packageRoot, "config", "default.yaml"),
+    path.join(extensionDir, "config", "default.yaml"),
+    path.join(extensionDir, "brainstorm.yaml"),
+  ];
+
+  let merged: any = {};
+  let loadedAny = false;
+
+  for (const candidate of defaultCandidates) {
+    if (fs.existsSync(candidate)) {
+      try {
+        const raw = fs.readFileSync(candidate, "utf-8");
+        const parsed = YAML.parse(raw);
+        if (parsed && typeof parsed === "object") {
+          merged = deepMerge(merged, parsed);
+          loadedAny = true;
+        }
+      } catch (err: any) {
+        throw new Error(
+          `Failed to parse config ${candidate}: ${err.message}`
+        );
+      }
+    }
+  }
+
+  if (!loadedAny) {
+    throw new Error(
+      "No pi-brainstorm config found. Expected config/default.yaml in package root or extension directory."
+    );
+  }
+
+  // Step 2: user override
+  const userPath = path.join(getAgentDir(), "pi-brainstorm.yaml");
+  if (fs.existsSync(userPath)) {
+    try {
+      const raw = fs.readFileSync(userPath, "utf-8");
+      const parsed = YAML.parse(raw);
+      if (parsed && typeof parsed === "object") {
+        merged = deepMerge(merged, parsed);
+      }
+    } catch (err: any) {
+      throw new Error(
+        `Failed to parse user config ${userPath}: ${err.message}`
+      );
+    }
+  }
+
+  // Step 3: project overrides
+  const projectCandidates = cwd
+    ? [path.join(cwd, ".pi-brainstorm.yaml"), path.join(cwd, ".pi", "pi-brainstorm.yaml")]
+    : [];
+
+  for (const candidate of projectCandidates) {
+    if (fs.existsSync(candidate)) {
+      try {
+        const raw = fs.readFileSync(candidate, "utf-8");
+        const parsed = YAML.parse(raw);
+        if (parsed && typeof parsed === "object") {
+          merged = deepMerge(merged, parsed);
+        }
+      } catch (err: any) {
+        throw new Error(
+          `Failed to parse project config ${candidate}: ${err.message}`
+        );
+      }
+    }
+  }
+
+  return merged as BrainstormConfig;
+}
+
+/**
+ * Resolve and validate participants for a command invocation.
+ * Returns validated participant array; throws with a clear message on failure.
+ */
+function isSafeAgentName(value: string): boolean {
+  return /^[A-Za-z0-9][A-Za-z0-9_.-]{0,80}$/.test(value);
+}
+
+function resolveParticipants(cwd: string): ParticipantConfig[] {
+  const config = loadConfig(cwd);
+
+  if (
+    !config.participants ||
+    !Array.isArray(config.participants) ||
+    config.participants.length === 0
+  ) {
+    throw new Error(
+      "pi-brainstorm config must define at least one participant under 'participants'."
+    );
+  }
+
+  const requiredFields: (keyof ParticipantConfig)[] = [
+    "displayName",
+    "agentName",
+    "model",
+    "rolePrompt",
+  ];
+
+  for (let i = 0; i < config.participants.length; i++) {
+    const p = config.participants[i];
+    for (const field of requiredFields) {
+      if (!p[field]) {
+        throw new Error(
+          `Participant at index ${i} is missing required field "${field}".`
+        );
+      }
+    }
+    if (typeof p.displayName !== "string" || !p.displayName.trim()) {
+      throw new Error(
+        `Participant at index ${i} has invalid displayName.`
+      );
+    }
+    if (typeof p.agentName !== "string" || !p.agentName.trim()) {
+      throw new Error(
+        `Participant at index ${i} has invalid agentName.`
+      );
+    }
+    if (!isSafeAgentName(p.agentName)) {
+      throw new Error(
+        `Participant "${p.displayName}" has unsafe agentName "${p.agentName}". Use only letters, digits, dot, underscore, and hyphen; it must start with a letter or digit.`
+      );
+    }
+    if (typeof p.model !== "string" || !p.model.trim()) {
+      throw new Error(
+        `Participant at index ${i} has invalid model.`
+      );
+    }
+    if (typeof p.rolePrompt !== "string" || !p.rolePrompt.trim()) {
+      throw new Error(
+        `Participant at index ${i} has invalid rolePrompt.`
+      );
+    }
+  }
+
+  return config.participants;
+}
+
+// ────────────────────────────────────────────────────────
+// Agent file generation
+// ────────────────────────────────────────────────────────
+
+/**
+ * Generate the content of a managed agent markdown file from a participant config.
+ */
+function yamlScalar(value: string): string {
+  return JSON.stringify(value);
+}
+
+function generateAgentFile(participant: ParticipantConfig): string {
+  const tools = participant.tools && participant.tools.length > 0
+    ? participant.tools
+    : DEFAULT_TOOLS;
+  const toolsStr = tools.join(", ");
+
+  const description =
+    participant.description ||
+    `${participant.displayName} brainstorming consultant.`;
+
+  const roleTitle = participant.roleTitle
+    ? ` - ${participant.roleTitle}`
+    : "";
+
+  const whatYouDoLines = (participant.whatYouDo && participant.whatYouDo.length > 0)
+    ? participant.whatYouDo.map((item) => `- ${item}`).join("\n")
+    : `- 参与多模型讨论并提供${participant.displayName}视角的分析`;
+
+  return [
+    MANAGED_MARKER,
+    "---",
+    `name: ${yamlScalar(participant.agentName)}`,
+    `description: ${yamlScalar(description)}`,
+    `tools: ${toolsStr}`,
+    `model: ${yamlScalar(participant.model)}`,
+    "---",
+    "",
+    `# ${participant.displayName} Brainstormer${roleTitle}`,
+    "",
+    participant.rolePrompt,
+    "",
+    "## What You Do",
+    whatYouDoLines,
+    "",
+    "## What You Do Not Do",
+    "- 写代码或修改项目文件，你只读项目文件",
+    "- 委派给其他 Agent",
+    "- 在聊天中直接粘贴长篇分析；当明确指示使用 meeting_append_entry 时，必须将完整贡献写入会议黑板，最终回复仅写 WROTE_ENTRY + 一句话摘要",
+    "",
+    "## Worker Preamble",
+    "You are a terminal worker. Work directly with tools. Do NOT spawn sub-agents.",
+    "",
+  ].join("\n");
+}
+
+/**
+ * Ensure agent files exist for all configured participants.
+ * - Files with the managed marker are overwritten from current config.
+ * - Files without the marker are never touched.
+ * - Missing files are created after user confirmation.
+ *
+ * Returns true if all participants have existing agent files (managed or not).
+ */
+async function safeWriteAgentFile(targetPath: string, content: string, mode: "create" | "update"): Promise<void> {
+  const dir = path.dirname(targetPath);
+  assertDirectoryNoSymlink(dir, "agents directory");
+  assertPathInside(fs.realpathSync(dir), path.resolve(targetPath), "agent file");
+
+  if (mode === "create") {
+    await fsp.writeFile(targetPath, content, { encoding: "utf-8", flag: "wx" });
+    return;
+  }
+
+  assertExistingFileNoSymlink(targetPath, "agent file");
+  const tempPath = path.join(
+    dir,
+    `.${path.basename(targetPath)}.${process.pid}.${Date.now()}.tmp`
+  );
+  await fsp.writeFile(tempPath, content, { encoding: "utf-8", flag: "wx" });
+  try {
+    await fsp.rename(tempPath, targetPath);
+  } catch (err) {
+    try {
+      await fsp.unlink(tempPath);
+    } catch {
+      // Ignore cleanup errors.
+    }
+    throw err;
+  }
+}
+
+async function ensureAgentsFromConfig(
+  ctx: any,
+  participants: ParticipantConfig[],
+  options: { allowGlobalWrites: boolean }
+): Promise<boolean> {
+  const agentsDir = path.join(getAgentDir(), "agents");
+
+  const planned: { filename: string; action: "create" | "update" }[] = [];
+  const protectedFiles: string[] = [];
+
+  for (const p of participants) {
+    const filename = `${p.agentName}.md`;
+    const targetPath = path.resolve(agentsDir, filename);
+    assertPathInside(agentsDir, targetPath, "agent file");
+
+    if (fs.existsSync(targetPath)) {
+      assertExistingFileNoSymlink(targetPath, "agent file");
+      const content = fs.readFileSync(targetPath, "utf-8");
+      if (content.includes(MANAGED_MARKER)) {
+        planned.push({ filename, action: "update" });
+      } else {
+        protectedFiles.push(filename);
+      }
+    } else {
+      planned.push({ filename, action: "create" });
+    }
+  }
+
+  // If nothing to create or update, we're done
+  if (planned.length === 0) {
+    return true;
+  }
+
+  if (!options.allowGlobalWrites) {
+    ctx.ui?.notify?.(
+      "Project-level pi-brainstorm config is active. For safety, this command will not create or update global agent files. Create the listed agents manually or move the config to ~/.pi/agent/pi-brainstorm.yaml.",
+      "warning"
+    );
+    return false;
+  }
+
+  // Non-interactive mode
+  if (!ctx.hasUI) {
+    // Update managed files silently
+    await fsp.mkdir(agentsDir, { recursive: true });
+    assertDirectoryNoSymlink(agentsDir, "agents directory");
+    for (const plan of planned) {
+      if (plan.action === "update") {
+        const p = participants.find(
+          (p) => `${p.agentName}.md` === plan.filename
+        )!;
+        const targetPath = path.resolve(agentsDir, plan.filename);
+        assertPathInside(agentsDir, targetPath, "agent file");
+        await safeWriteAgentFile(
+          targetPath,
+          generateAgentFile(p),
+          "update"
+        );
+      }
+    }
+    // Report missing
+    const missing = planned.filter((p) => p.action === "create");
+    if (missing.length > 0) {
+      ctx.ui?.notify?.(
+        `Missing meeting agents: ${missing.map((m) => m.filename).join(", ")}. Install them under ${agentsDir}.`,
+        "warning"
+      );
+      return false;
+    }
+    return true;
+  }
+
+  // Interactive mode: ask user
+  let message = "";
+  if (planned.length > 0) {
+    const actionWord = planned.some((p) => p.action === "update")
+      ? "created/updated"
+      : "created";
+    message += `The following agent files will be ${actionWord}:\n`;
+    for (const p of planned) {
+      message += `  - ${p.filename} (${p.action})\n`;
+    }
+  }
+  if (protectedFiles.length > 0) {
+    message += `\nThe following existing files are NOT managed by pi-brainstorm and will be left untouched:\n`;
+    for (const f of protectedFiles) {
+      message += `  - ${f}\n`;
+    }
+  }
+
+  const title = planned.some((p) => p.action === "update")
+    ? "Update brainstorm agents?"
+    : "Install brainstorm agents?";
+
+  const ok = await ctx.ui.confirm(
+    title,
+    message + `\nFiles will be written to ${agentsDir}.`
+  );
+  if (!ok) return false;
+
+  await fsp.mkdir(agentsDir, { recursive: true });
+  assertDirectoryNoSymlink(agentsDir, "agents directory");
+  for (const plan of planned) {
+    const p = participants.find(
+      (p) => `${p.agentName}.md` === plan.filename
+    )!;
+    const targetPath = path.resolve(agentsDir, plan.filename);
+    assertPathInside(agentsDir, targetPath, "agent file");
+    await safeWriteAgentFile(targetPath, generateAgentFile(p), plan.action);
+  }
+
+  ctx.ui.notify(`Updated ${planned.length} agent file(s).`, "info");
+  return true;
+}
+
+// ────────────────────────────────────────────────────────
+// Prompt builders
+// ────────────────────────────────────────────────────────
+
+/**
+ * Build the facilitator prompt for /brainstorm.
+ */
+function buildBrainstormPrompt(
+  topic: string,
+  absDir: string,
+  participants: ParticipantConfig[]
+): string {
+  const consultantLines = participants
+    .map(
+      (p) =>
+        `- **${p.displayName}**: use the ${p.agentName} subagent. ${p.brainstormRole || p.roleTitle || "Consultant"}.`
+    )
+    .join("\n");
+
+  const agentTaskLines = participants
+    .map(
+      (p) =>
+        `   - speaker: "${p.displayName}"`
+    )
+    .join("\n");
+
+  return [
+    `BLACKBOARD BRAINSTORMING SESSION: ${topic}`,
+    "",
+    `Meeting folder: \`${absDir}\``,
+    "",
+    "You are facilitating a round-robin brainstorming session using the MEETING BLACKBOARD.",
+    "Each consultant writes their FULL contribution to disk via meeting_append_entry.",
+    "",
+    "## Consultants (3 rounds)",
+    consultantLines,
+    "",
+    "## CRITICAL INSTRUCTIONS",
+    "",
+    "### For subagents (include in EVERY task):",
+    "1. Write your FULL contribution using the meeting_append_entry tool with:",
+    `   - meetingDir: "${absDir}"`,
+    "   - speaker: your display name, e.g.:",
+    agentTaskLines,
+    '   - phase: "Round 1", "Round 2", or "Round 3"',
+    "   - summary: a ONE-SENTENCE summary of your contribution",
+    "   - content: your FULL analysis in Chinese (中文)",
+    "   - content must contain only the participant's analysis. Do not include wrapper tags, hidden thinking markers, tool-call text, or WROTE_ENTRY text inside content.",
+    "2. After writing, your FINAL ANSWER must be ONLY:",
+    "   `WROTE_ENTRY: <your one-sentence summary>`",
+    "3. DO NOT paste your full analysis into the chat. The main agent and user will read it from the blackboard.",
+    "",
+    "### For you, the facilitator:",
+    "- Do NOT paste participant full text into chat. They are on the blackboard.",
+    "- After each round, read the index with meeting_read_index and present a structural overview.",
+    "- Optionally read full entries with meeting_read_entry when needed.",
+    "- Present each consultant's summary + your structural overview (conflict matrix, consensus table).",
+    "- When the user gives feedback, relay it VERBATIM to the consultants in the next round.",
+    "",
+    "## Protocol",
+    "Round 1: Each consultant gives initial analysis on the topic. Run all in parallel.",
+    "After Round 1: read the index, present summaries plus a structural overview, then STOP. Ask the user for feedback or permission to continue. Do NOT start Round 2 in the same assistant turn.",
+    "Round 2: only after the user replies, feed Round 1 plus the user's VERBATIM feedback back to each consultant. Ask each to challenge the others and propose improvements.",
+    "After Round 2: read the index, present summaries plus an updated structural overview, then STOP. Ask the user for feedback or permission to continue. Do NOT start Round 3 in the same assistant turn.",
+    "Round 3: only after the user replies, feed all prior rounds plus the user's VERBATIM feedback back to each consultant. Each gives FINAL recommendation, synthesizing the best ideas.",
+    "",
+    "After Round 3, present the complete structural overview and ask whether to write the final conclusion. Only write conclusion.md after the user confirms.",
+    "",
+    "## IMPORTANT",
+    "- All responses in Chinese (中文).",
+    "- Save transcript.md and (after user confirms) conclusion.md per the MEETING OUTPUT PROTOCOL.",
+    "- The user can intervene at any time to steer the discussion.",
+  ].join("\n");
+}
+
+/**
+ * Build the facilitator prompt for /debate.
+ */
+function buildDebatePrompt(
+  topic: string,
+  absDir: string,
+  participants: ParticipantConfig[]
+): string {
+  const debaterLines = participants
+    .map((p) => {
+      const dp = p.debatePersona;
+      if (dp) {
+        return `- **${p.displayName}** (${p.agentName}): ${dp.label} — Attack other positions, find flaws, expose assumptions.`;
+      }
+      return `- **${p.displayName}** (${p.agentName})`;
+    })
+    .join("\n");
+
+  // Build per-agent debate task prefixes for the facilitator to include
+  const taskPrefixLines = participants
+    .map((p) => {
+      const dp = p.debatePersona;
+      if (dp && dp.prompt) {
+        return `**${p.displayName}** (${p.agentName}):\n${dp.prompt}`;
+      }
+      return `**${p.displayName}** (${p.agentName}): Debate participant.`;
+    })
+    .join("\n\n");
+
+  const agentTaskLines = participants
+    .map(
+      (p) =>
+        `   - speaker: "${p.displayName}"`
+    )
+    .join("\n");
+
+  return [
+    `⚔️ BLACKBOARD DEBATE: ${topic}`,
+    "",
+    `Meeting folder: \`${absDir}\``,
+    "",
+    "You are facilitating an OPEN-ENDED debate using the MEETING BLACKBOARD.",
+    "Each debater writes their FULL argument to disk via meeting_append_entry.",
+    "Continue until the debate CONVERGES or the user intervenes.",
+    "",
+    "## Debaters (cycling indefinitely)",
+    debaterLines,
+    "",
+    "## DEBATE PERSONAS (include in each subagent task)",
+    taskPrefixLines,
+    "",
+    "## CRITICAL INSTRUCTIONS",
+    "",
+    "### For subagents (include in EVERY task):",
+    "1. Write your FULL contribution using the meeting_append_entry tool with:",
+    `   - meetingDir: "${absDir}"`,
+    "   - speaker: your display name, e.g.:",
+    agentTaskLines,
+    '   - phase: "Cycle 1", "Cycle 2", etc.',
+    "   - summary: a ONE-SENTENCE summary of your argument",
+    "   - content: your FULL argument in Chinese (中文)",
+    "2. After writing, your FINAL ANSWER must be ONLY:",
+    "   `WROTE_ENTRY: <your one-sentence summary>`",
+    "3. DO NOT paste your full argument into the chat.",
+    "",
+    "### Include the FULL VERBATIM prior debate record in each subagent task.",
+    "Use meeting_read_index and meeting_read_entry to retrieve the complete debate history.",
+    "NEVER summarize or truncate the debate record when passing to subagents.",
+    "",
+    "### For you, the facilitator:",
+    "- Do NOT paste participant full text into chat. They are on the blackboard.",
+    "- Cycle through debaters in sequence (chain mode) so each sees all prior entries.",
+    "- Read the index with meeting_read_index frequently.",
+    "- Read full entries with meeting_read_entry when synthesizing.",
+    "- After EACH full cycle (all debaters spoke once), check for CONVERGENCE:",
+    "  * Do 2+ agents agree on a specific conclusion?",
+    "  * Did the last cycle introduce any NEW arguments?",
+    "  * Did anyone explicitly concede?",
+    "- If NOT converged: run another cycle. Keep going.",
+    "- If converged: present synthesis to me.",
+    "",
+    "## Rules",
+    "- NEVER stop at a predetermined count. Only convergence or user intervention ends this debate.",
+    "- All responses in Chinese (中文).",
+    "- After convergence, save transcript.md immediately and (after user confirms) conclusion.md per the MEETING OUTPUT PROTOCOL.",
+    "- Present: (1) the debate arc, (2) who conceded what, (3) final synthesis.",
+  ].join("\n");
+}
 
 // ────────────────────────────────────────────────────────
 // Helpers
@@ -29,12 +648,14 @@ import { Text, Box } from "@earendil-works/pi-tui";
 
 /** Sanitize a string for use in filenames (keep letters, digits, hyphens, underscores). */
 function sanitizeFilenamePart(raw: string): string {
-  return raw
-    .replace(/[^a-zA-Z0-9\u4e00-\u9fff_-]/g, "_")
-    .replace(/_+/g, "_")
-    .replace(/^_|_$/g, "")
-    .slice(0, 60)
-    .toLowerCase() || "unknown";
+  return (
+    raw
+      .replace(/[^a-zA-Z0-9\u4e00-\u9fff_-]/g, "_")
+      .replace(/_+/g, "_")
+      .replace(/^_|_$/g, "")
+      .slice(0, 60)
+      .toLowerCase() || "unknown"
+  );
 }
 
 /** Convert a topic string to a filesystem-safe slug. */
@@ -162,7 +783,11 @@ function startWatching(pi: ExtensionAPI, meetingDir: string): void {
         try {
           if (!fs.existsSync(entryPath)) return;
           assertExistingFileNoSymlink(entryPath, "meeting entry");
-          assertPathInside(fs.realpathSync(entriesDir), fs.realpathSync(entryPath), "meeting entry real path");
+          assertPathInside(
+            fs.realpathSync(entriesDir),
+            fs.realpathSync(entryPath),
+            "meeting entry real path"
+          );
           const parsed = parseEntryFilename(filename);
           if (!parsed) return;
           const summary = readEntrySummary(entryPath);
@@ -189,7 +814,7 @@ function startWatching(pi: ExtensionAPI, meetingDir: string): void {
     );
   });
 
-  watcher.on("error", () => {
+  (watcher as any).on?.("error", () => {
     // Silently handle watcher errors (e.g., directory deleted)
   });
 
@@ -221,116 +846,6 @@ interface MeetingManifest {
   entryCount: number;
 }
 
-const BRAINSTORM_AGENT_FILES: Record<string, string> = {
-  "gpt-brainstormer.md": `---
-name: gpt-brainstormer
-description: GPT brainstorming consultant. Visionary strategist for multi-model discussion sessions.
-tools: read, grep, find, ls, meeting_append_entry, meeting_read_index, meeting_read_entry
-model: vendor-codex/gpt-5.5:xhigh
----
-
-# GPT Brainstormer - Visionary Strategist
-
-你是多模型头脑风暴中的愿景战略家。思考大局，发现别人忽略的机会，将复杂权衡综合为清晰方向。用中文回答。
-
-## What You Do
-- 提出创新的战略方向和解决方案
-- 发现别人忽略的机会和盲点
-- 把零散想法综合成连贯战略
-
-## What You Do Not Do
-- 写代码或修改项目文件，你只读项目文件
-- 委派给其他 Agent
-- 在聊天中直接粘贴长篇分析；当明确指示使用 meeting_append_entry 时，必须将完整贡献写入会议黑板，最终回复仅写 WROTE_ENTRY + 一句话摘要
-
-## Worker Preamble
-You are a terminal worker. Work directly with tools. Do NOT spawn sub-agents.
-`,
-  "deepseek-brainstormer.md": `---
-name: deepseek-brainstormer
-description: DeepSeek brainstorming consultant. Meticulous systems thinker for multi-model discussion sessions.
-tools: read, grep, find, ls, meeting_append_entry, meeting_read_index, meeting_read_entry
-model: deepseek/deepseek-v4-pro:xhigh
----
-
-# DeepSeek Brainstormer - Meticulous Systems Thinker
-
-你是多模型头脑风暴中的系统思考者。分析结构、依赖、扩展上限和失败模式。用中文回答。
-
-## What You Do
-- 从结构、依赖和风险角度分析提案
-- 识别隐藏耦合、扩展上限和失败模式
-- 提出具体、可实现、可验证的技术优化方案
-
-## What You Do Not Do
-- 写代码或修改项目文件，你只读项目文件
-- 委派给其他 Agent
-- 在聊天中直接粘贴长篇分析；当明确指示使用 meeting_append_entry 时，必须将完整贡献写入会议黑板，最终回复仅写 WROTE_ENTRY + 一句话摘要
-
-## Worker Preamble
-You are a terminal worker. Work directly with tools. Do NOT spawn sub-agents.
-`,
-  "minimax-brainstormer.md": `---
-name: minimax-brainstormer
-description: MiniMax brainstorming consultant. Creative lateral thinker for multi-model discussion sessions.
-tools: read, grep, find, ls, meeting_append_entry, meeting_read_index, meeting_read_entry
-model: minimax-cn/MiniMax-M3:xhigh
----
-
-# MiniMax Brainstormer - Creative Lateral Thinker
-
-你是多模型头脑风暴中的创意顾问。跳出框框思考，挑战隐性假设，提出非常规方案。用中文回答。
-
-## What You Do
-- 从意想不到的角度切入问题
-- 提出打破常规的创新方案
-- 挑战团队隐性假设
-
-## What You Do Not Do
-- 写代码或修改项目文件，你只读项目文件
-- 委派给其他 Agent
-- 在聊天中直接粘贴长篇分析；当明确指示使用 meeting_append_entry 时，必须将完整贡献写入会议黑板，最终回复仅写 WROTE_ENTRY + 一句话摘要
-
-## Worker Preamble
-You are a terminal worker. Work directly with tools. Do NOT spawn sub-agents.
-`,
-};
-
-async function ensureBrainstormAgents(ctx: any): Promise<boolean> {
-  const agentsDir = path.join(getAgentDir(), "agents");
-  const missing = Object.keys(BRAINSTORM_AGENT_FILES).filter(
-    (filename) => !fs.existsSync(path.join(agentsDir, filename))
-  );
-  if (missing.length === 0) return true;
-
-  if (!ctx.hasUI) {
-    ctx.ui?.notify?.(
-      `Missing meeting agents: ${missing.join(", ")}. Install them under ${agentsDir}.`,
-      "warning"
-    );
-    return false;
-  }
-
-  const ok = await ctx.ui.confirm(
-    "Install meeting brainstorm agents?",
-    `The blackboard meeting commands need these user-level agents:\n${missing
-      .map((name) => `- ${name}`)
-      .join("\n")}\n\nThey will be created under ${agentsDir}. Existing files are not overwritten.`
-  );
-  if (!ok) return false;
-
-  await fsp.mkdir(agentsDir, { recursive: true });
-  for (const filename of missing) {
-    const target = path.join(agentsDir, filename);
-    await fsp.writeFile(target, BRAINSTORM_AGENT_FILES[filename], {
-      encoding: "utf-8",
-      flag: "wx",
-    });
-  }
-  ctx.ui.notify(`Installed ${missing.length} meeting agent(s).`, "info");
-  return true;
-}
-
 async function readManifest(absDir: string): Promise<MeetingManifest | null> {
   const manifestPath = path.join(absDir, "manifest.json");
   try {
@@ -428,7 +943,6 @@ export default function (pi: ExtensionAPI) {
         // Read or create manifest
         let manifest = await readManifest(absDir);
         if (!manifest) {
-          // Should not normally happen — commands seed the manifest
           manifest = {
             topic: path.basename(absDir),
             created: new Date().toISOString(),
@@ -620,7 +1134,11 @@ export default function (pi: ExtensionAPI) {
 
       try {
         assertExistingFileNoSymlink(absEntryPath, "meeting entry");
-        assertPathInside(fs.realpathSync(absDir), fs.realpathSync(absEntryPath), "meeting entry real path");
+        assertPathInside(
+          fs.realpathSync(absDir),
+          fs.realpathSync(absEntryPath),
+          "meeting entry real path"
+        );
         const content = await fsp.readFile(absEntryPath, "utf-8");
         return {
           content: [
@@ -682,7 +1200,11 @@ export default function (pi: ExtensionAPI) {
         try {
           assertExistingFileNoSymlink(details.path, "meeting entry");
           if (details.meetingDir) {
-            assertPathInside(fs.realpathSync(details.meetingDir), fs.realpathSync(details.path), "meeting entry real path");
+            assertPathInside(
+              fs.realpathSync(details.meetingDir),
+              fs.realpathSync(details.path),
+              "meeting entry real path"
+            );
           }
           const fullContent = fs.readFileSync(details.path, "utf-8");
           text += `\n\n${theme.fg("dim", fullContent)}`;
@@ -708,7 +1230,21 @@ export default function (pi: ExtensionAPI) {
         return;
       }
 
-      const agentsReady = await ensureBrainstormAgents(ctx);
+      // Resolve participants from config
+      let participants: ParticipantConfig[];
+      try {
+        participants = resolveParticipants(ctx.cwd);
+      } catch (err: any) {
+        ctx.ui.notify(
+          `pi-brainstorm config error: ${err.message}`,
+          "error"
+        );
+        return;
+      }
+
+      const agentsReady = await ensureAgentsFromConfig(ctx, participants, {
+        allowGlobalWrites: !hasProjectConfig(ctx.cwd),
+      });
       if (!agentsReady) return;
 
       const topic = args.trim();
@@ -723,7 +1259,10 @@ export default function (pi: ExtensionAPI) {
       // Create meeting folder structure
       await fsp.mkdir(path.join(absDir, "entries"), { recursive: true });
       assertDirectoryNoSymlink(absDir, "meeting directory");
-      assertDirectoryNoSymlink(path.join(absDir, "entries"), "entries directory");
+      assertDirectoryNoSymlink(
+        path.join(absDir, "entries"),
+        "entries directory"
+      );
 
       // Seed manifest
       const manifest: MeetingManifest = {
@@ -765,54 +1304,11 @@ export default function (pi: ExtensionAPI) {
       );
 
       // Send orchestration prompt to main agent
+      const promptText = buildBrainstormPrompt(topic, absDir, participants);
       pi.sendUserMessage([
         {
           type: "text" as const,
-          text: [
-            `BLACKBOARD BRAINSTORMING SESSION: ${topic}`,
-            "",
-            `Meeting folder: \`${absDir}\``,
-            "",
-            "You are facilitating a round-robin brainstorming session using the MEETING BLACKBOARD.",
-            "Each consultant writes their FULL contribution to disk via meeting_append_entry.",
-            "",
-            "## Consultants (3 rounds)",
-            "- **GPT**: use the gpt-brainstormer subagent. Visionary strategist.",
-            "- **DeepSeek**: use the deepseek-brainstormer subagent. Systems thinker.",
-            "- **MiniMax**: use the minimax-brainstormer subagent. Creative lateral thinker.",
-            "",
-            "## CRITICAL INSTRUCTIONS",
-            "",
-            "### For subagents (include in EVERY task):",
-            "1. Write your FULL contribution using the meeting_append_entry tool with:",
-            `   - meetingDir: "${absDir}"`,
-            "   - speaker: your name (GPT, DeepSeek, or MiniMax)",
-            '   - phase: "Round 1", "Round 2", or "Round 3"',
-            "   - summary: a ONE-SENTENCE summary of your contribution",
-            "   - content: your FULL analysis in Chinese (中文)",
-            "2. After writing, your FINAL ANSWER must be ONLY:",
-            "   `WROTE_ENTRY: <your one-sentence summary>`",
-            "3. DO NOT paste your full analysis into the chat. The main agent and user will read it from the blackboard.",
-            "",
-            "### For you, the facilitator:",
-            "- Do NOT paste participant full text into chat. They are on the blackboard.",
-            "- After each round, read the index with meeting_read_index and present a structural overview.",
-            "- Optionally read full entries with meeting_read_entry when needed.",
-            "- Present each consultant's summary + your structural overview (conflict matrix, consensus table).",
-            "- When the user gives feedback, relay it VERBATIM to the consultants in the next round.",
-            "",
-            "## Protocol",
-            "Round 1: Each consultant gives initial analysis on the topic. Run all 3 in parallel.",
-            "Round 2: Feed prior discussion back to each. Ask each to challenge the others and propose improvements.",
-            "Round 3: Each gives FINAL recommendation, synthesizing the best ideas.",
-            "",
-            "After Round 3, present the complete structural overview and a synthesized conclusion.",
-            "",
-            "## IMPORTANT",
-            "- All responses in Chinese (中文).",
-            "- Save transcript.md and (after user confirms) conclusion.md per the MEETING OUTPUT PROTOCOL.",
-            "- The user can intervene at any time to steer the discussion.",
-          ].join("\n"),
+          text: promptText,
         },
       ]);
     },
@@ -829,7 +1325,21 @@ export default function (pi: ExtensionAPI) {
         return;
       }
 
-      const agentsReady = await ensureBrainstormAgents(ctx);
+      // Resolve participants from config
+      let participants: ParticipantConfig[];
+      try {
+        participants = resolveParticipants(ctx.cwd);
+      } catch (err: any) {
+        ctx.ui.notify(
+          `pi-brainstorm config error: ${err.message}`,
+          "error"
+        );
+        return;
+      }
+
+      const agentsReady = await ensureAgentsFromConfig(ctx, participants, {
+        allowGlobalWrites: !hasProjectConfig(ctx.cwd),
+      });
       if (!agentsReady) return;
 
       const topic = args.trim();
@@ -844,7 +1354,10 @@ export default function (pi: ExtensionAPI) {
       // Create meeting folder structure
       await fsp.mkdir(path.join(absDir, "entries"), { recursive: true });
       assertDirectoryNoSymlink(absDir, "meeting directory");
-      assertDirectoryNoSymlink(path.join(absDir, "entries"), "entries directory");
+      assertDirectoryNoSymlink(
+        path.join(absDir, "entries"),
+        "entries directory"
+      );
 
       // Seed manifest
       const manifest: MeetingManifest = {
@@ -887,58 +1400,11 @@ export default function (pi: ExtensionAPI) {
       );
 
       // Send orchestration prompt to main agent
+      const promptText = buildDebatePrompt(topic, absDir, participants);
       pi.sendUserMessage([
         {
           type: "text" as const,
-          text: [
-            `⚔️ BLACKBOARD DEBATE: ${topic}`,
-            "",
-            `Meeting folder: \`${absDir}\``,
-            "",
-            "You are facilitating an OPEN-ENDED debate using the MEETING BLACKBOARD.",
-            "Each debater writes their FULL argument to disk via meeting_append_entry.",
-            "Continue until the debate CONVERGES or the user intervenes.",
-            "",
-            "## Debaters (cycling indefinitely)",
-            "- **GPT** (gpt-brainstormer): THE PROSECUTOR — Attack other positions ruthlessly. Find every logical flaw, hidden assumption, and missing edge case.",
-            "- **DeepSeek** (deepseek-brainstormer): THE SYSTEMS SKEPTIC — Dissect structural implications. What breaks at scale? Where are the hidden costs?",
-            "- **MiniMax** (minimax-brainstormer): THE CONTRARIAN — Take the opposite position. Expose groupthink. Propose radical alternatives.",
-            "",
-            "## CRITICAL INSTRUCTIONS",
-            "",
-            "### For subagents (include in EVERY task):",
-            "1. Write your FULL contribution using the meeting_append_entry tool with:",
-            `   - meetingDir: "${absDir}"`,
-            "   - speaker: your name (GPT, DeepSeek, or MiniMax)",
-            '   - phase: "Cycle 1", "Cycle 2", etc.',
-            "   - summary: a ONE-SENTENCE summary of your argument",
-            "   - content: your FULL argument in Chinese (中文)",
-            "2. After writing, your FINAL ANSWER must be ONLY:",
-            "   `WROTE_ENTRY: <your one-sentence summary>`",
-            "3. DO NOT paste your full argument into the chat.",
-            "",
-            "### Include the FULL VERBATIM prior debate record in each subagent task.",
-            "Use meeting_read_index and meeting_read_entry to retrieve the complete debate history.",
-            "NEVER summarize or truncate the debate record when passing to subagents.",
-            "",
-            "### For you, the facilitator:",
-            "- Do NOT paste participant full text into chat. They are on the blackboard.",
-            "- Run debaters in CHAIN mode (one at a time, each sees all prior entries).",
-            "- Read the index with meeting_read_index frequently.",
-            "- Read full entries with meeting_read_entry when synthesizing.",
-            "- After EACH full cycle (all 3 spoke), check for CONVERGENCE:",
-            "  * Do 2+ agents agree on a specific conclusion?",
-            "  * Did the last cycle introduce any NEW arguments?",
-            "  * Did anyone explicitly concede?",
-            "- If NOT converged: run another cycle. Keep going.",
-            "- If converged: present synthesis to me.",
-            "",
-            "## Rules",
-            "- NEVER stop at a predetermined count. Only convergence or user intervention ends this debate.",
-            "- All responses in Chinese (中文).",
-            "- After convergence, save transcript.md immediately and (after user confirms) conclusion.md per the MEETING OUTPUT PROTOCOL.",
-            "- Present: (1) the debate arc, (2) who conceded what, (3) final synthesis.",
-          ].join("\n"),
+          text: promptText,
         },
       ]);
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-brainstorm",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Multi-model brainstorming and debate sessions for pi subagents.",
   "type": "module",
   "keywords": [
@@ -26,10 +26,14 @@
   "homepage": "https://github.com/Jarcis-cy/pi-brainstorm#readme",
   "files": [
     "extensions",
+    "config",
     "README.md",
     "README.zh-CN.md",
     "LICENSE"
   ],
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",