prizmkit 1.1.118 → 1.1.120

package/src/index.js

@@ -70,7 +70,6 @@ export async function runScaffold(directory, options) {
       platform: options.platform,
       runtime: normalizeRuntime(options.runtime),
       skills: options.skills || 'core',
-      team: options.team !== false,
       pipeline: options.pipeline !== false,
       playwrightCli: options.playwrightCli !== false,
       openCli: options.openCli !== false,
@@ -155,13 +154,7 @@ export async function runScaffold(directory, options) {
       });
     }
 
-    // 3. 团队模式
-    const team = await confirm({
-      message: '启用多 Agent 团队模式 (prizm-dev-team)?',
-      default: true,
-    });
-
-    // 4. Pipeline
+    // 3. Pipeline
     const pipeline = await confirm({
       message: '安装自动化流水线 (dev-pipeline)?',
       default: true,
@@ -209,7 +202,6 @@ export async function runScaffold(directory, options) {
     console.log(`    运行时:     ${chalk.cyan(runtimeLabel(runtime))}`);
     console.log(`    平台:       ${chalk.cyan(selectedPlatformLabel)}`);
     console.log(`    技能:       ${chalk.cyan(suiteLabel)}`);
-    console.log(`    团队模式:   ${team ? chalk.green('启用') : chalk.gray('禁用')}`);
     console.log(`    流水线:     ${pipeline ? chalk.green('启用') : chalk.gray('禁用')}`);
     const browserToolsLabel = [playwrightCli && 'playwright-cli', openCli && 'opencli'].filter(Boolean);
     console.log(`    浏览器工具: ${browserToolsLabel.length ? chalk.green(browserToolsLabel.join(' + ')) : chalk.gray('禁用')}`);
@@ -234,7 +226,6 @@ export async function runScaffold(directory, options) {
       platform,
       runtime,
       skills: skillSuite,
-      team,
       pipeline,
       playwrightCli,
       openCli,

package/src/manifest.js

@@ -1,7 +1,7 @@
 /**
  * Manifest management for PrizmKit installations.
  *
- * Tracks what was installed (skills, agents, rules, pipeline) so that
+ * Tracks what was installed (skills, rules, pipeline, extras) so that
  * `upgrade` can diff old vs new and `uninstall` can clean orphaned files.
  *
  * Manifest is written to <projectRoot>/.prizmkit/manifest.json
@@ -52,10 +52,8 @@ export async function writeManifest(projectRoot, data) {
  * @param {string} [params.runtime] - canonical Python runtime id or compatibility alias
  * @param {string} params.suite - skill suite name
  * @param {string[]} params.skills - resolved skill name list
- * @param {string[]} params.agents - agent file names (e.g. ['prizm-dev-team-dev.md'])
  * @param {string[]} params.rules - rule file names (e.g. ['prizm-documentation.md'])
  * @param {string[]} params.pipeline - pipeline file relative paths (or falsy if not installed)
- * @param {boolean} params.team - whether team config was installed
  * @param {string} [params.aiCli] - AI CLI command
  * @param {string} [params.rulesPreset] - rules preset name
  * @param {string[]} [params.payloadPlatforms] - concrete platform payloads installed for platform + aiCli
@@ -67,10 +65,8 @@ export function buildManifest({
   runtime,
   suite,
   skills,
-  agents,
   rules,
   pipeline,
-  team,
   aiCli,
   rulesPreset,
   extras,
@@ -88,14 +84,12 @@ export function buildManifest({
     runtime: normalizeRuntime(runtime),
     suite,
     options: {
-      team: Boolean(team),
       pipeline: Array.isArray(pipeline) ? pipeline.length > 0 : Boolean(pipeline),
       rules: rulesPreset || 'recommended',
       aiCli: aiCli || '',
     },
     files: {
       skills: [...skills],
-      agents: [...agents],
       rules: [...rules],
       pipeline: pipeline ? [...pipeline] : [],
       extras: extras ? [...extras] : [],
@@ -113,7 +107,7 @@ export function buildManifest({
  * Diff two manifests and return added/removed items.
  * @param {Object} oldManifest - previous manifest
  * @param {Object} newManifest - new manifest to compare against
- * @returns {Object} { skills: {added, removed}, agents: {added, removed}, rules: {added, removed}, pipeline: {added, removed}, extras: {added, removed} }
+ * @returns {Object} { skills: {added, removed}, rules: {added, removed}, pipeline: {added, removed}, extras: {added, removed}, legacyAgents: {added, removed} }
  */
 export function diffManifest(oldManifest, newManifest) {
   function diffArrays(oldArr, newArr) {
@@ -127,12 +121,12 @@ export function diffManifest(oldManifest, newManifest) {
 
   return {
     skills: diffArrays(oldManifest?.files?.skills, newManifest?.files?.skills),
-    agents: diffArrays(oldManifest?.files?.agents, newManifest?.files?.agents),
     rules: diffArrays(oldManifest?.files?.rules, newManifest?.files?.rules),
     pipeline: diffArrays(
       Array.isArray(oldManifest?.files?.pipeline) ? oldManifest.files.pipeline : [],
       Array.isArray(newManifest?.files?.pipeline) ? newManifest.files.pipeline : [],
     ),
     extras: diffArrays(oldManifest?.files?.extras, newManifest?.files?.extras),
+    legacyAgents: diffArrays(oldManifest?.files?.agents, []),
   };
 }

package/src/metadata.js

@@ -94,32 +94,6 @@ export function getSkillCandidatePaths(skillName, skillDef = {}, runtime = 'pyth
   return candidates;
 }
 
-/**
- * 获取 core agents 目录路径
- */
-export function getAgentsDir() {
-  const bundledDir = path.join(getBundledRoot(), 'agents');
-  const coreDir = path.join(getFrameworkRoot(), 'core', 'agents');
-
-  if (fs.pathExistsSync(bundledDir)) return bundledDir;
-  if (fs.pathExistsSync(coreDir)) return coreDir;
-
-  throw new Error('无法找到 Agents 目录。');
-}
-
-/**
- * 获取 core team 目录路径
- */
-export function getTeamDir() {
-  const bundledDir = path.join(getBundledRoot(), 'team');
-  const coreDir = path.join(getFrameworkRoot(), 'core', 'team');
-
-  if (fs.pathExistsSync(bundledDir)) return bundledDir;
-  if (fs.pathExistsSync(coreDir)) return coreDir;
-
-  throw new Error('无法找到 Team 目录。');
-}
-
 /**
  * 获取 templates 目录路径
  */

package/src/prompts.js

@@ -234,19 +234,6 @@ export async function selectExternalSkills(currentSkills, metadata) {
   return selectedSkills;
 }
 
-/**
- * Confirm team mode setting.
- * @param {boolean} currentValue - current team mode value
- * @returns {Promise<boolean>}
- */
-export async function confirmTeamMode(currentValue = true) {
-  const team = await confirm({
-    message: '启用多 Agent 团队模式 (prizm-dev-team)?',
-    default: currentValue,
-  });
-  return team;
-}
-
 /**
  * Confirm pipeline setting.
  * @param {boolean} currentValue - current pipeline value

package/src/scaffold.js

@@ -16,8 +16,6 @@ import { dirname, join } from 'path';
 import { execSync } from 'child_process';
 import {
   loadMetadata,
-  getAgentsDir,
-  getTeamDir,
   getTemplatesDir,
   getPipelineDir,
   getAdaptersDir,
@@ -82,6 +80,74 @@ const RETIRED_POWERSHELL_RUNTIME_FILES = new Set([
   'lib/branch.ps1',
   'lib/heartbeat.ps1',
 ]);
+const LEGACY_TEAM_NAME = ['prizm', 'dev', 'team'].join('-');
+const LEGACY_AGENT_BASENAMES = [
+  `${LEGACY_TEAM_NAME}-dev`,
+  `${LEGACY_TEAM_NAME}-reviewer`,
+];
+
+async function removeEmptyDirectory(dirPath) {
+  if (!await fs.pathExists(dirPath)) return;
+  const entries = await fs.readdir(dirPath);
+  if (entries.length === 0) {
+    await fs.remove(dirPath);
+  }
+}
+
+export async function removeRetiredAgentTeamArtifacts(platform, projectRoot, dryRun) {
+  const agentDir = platform === 'claude'
+    ? path.join(projectRoot, '.claude', 'agents')
+    : platform === 'codex'
+      ? path.join(projectRoot, '.codex', 'agents')
+      : path.join(projectRoot, '.codebuddy', 'agents');
+  const agentExtensions = platform === 'codex' ? ['.toml', '.md'] : ['.md'];
+
+  for (const basename of LEGACY_AGENT_BASENAMES) {
+    for (const extension of agentExtensions) {
+      const filePath = path.join(agentDir, `${basename}${extension}`);
+      if (!await fs.pathExists(filePath)) continue;
+      if (dryRun) {
+        console.log(chalk.gray(`      [dry-run] remove retired ${path.relative(projectRoot, filePath)}`));
+      } else {
+        await fs.remove(filePath);
+        console.log(chalk.red(`      ✗ removed retired ${path.relative(projectRoot, filePath)}`));
+      }
+    }
+  }
+
+  if (!dryRun) {
+    await removeEmptyDirectory(agentDir);
+  }
+
+  const teamInfoPath = platform === 'claude'
+    ? path.join(projectRoot, '.claude', 'team-info.json')
+    : platform === 'codex'
+      ? path.join(projectRoot, '.codex', 'team-info.json')
+      : path.join(projectRoot, '.codebuddy', 'team-info.json');
+  if (await fs.pathExists(teamInfoPath)) {
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] remove retired ${path.relative(projectRoot, teamInfoPath)}`));
+    } else {
+      await fs.remove(teamInfoPath);
+      console.log(chalk.red(`      ✗ removed retired ${path.relative(projectRoot, teamInfoPath)}`));
+    }
+  }
+
+  if (platform === 'codebuddy') {
+    const homeDir = process.env.HOME || process.env.USERPROFILE;
+    if (homeDir) {
+      const globalTeamDir = path.join(homeDir, '.codebuddy', 'teams', LEGACY_TEAM_NAME);
+      if (await fs.pathExists(globalTeamDir)) {
+        if (dryRun) {
+          console.log(chalk.gray('      [dry-run] remove retired global CodeBuddy team config'));
+        } else {
+          await fs.remove(globalTeamDir);
+          console.log(chalk.red('      ✗ removed retired global CodeBuddy team config'));
+        }
+      }
+    }
+  }
+}
 
 // ============================================================
 // Adapter 动态加载
@@ -282,186 +348,9 @@ export async function installSkills(platform, skills, projectRoot, dryRun, runti
 }
 
 /**
- * 安装 Agent 定义（纯 Copy 模式）
- */
-export async function installAgents(platform, projectRoot, dryRun) {
-  const agentsDir = getAgentsDir();
-  const agentFiles = (await fs.readdir(agentsDir)).filter(f => f.endsWith('.md'));
-
-  // Load Claude agent adapter
-  let convertAgentFn;
-  if (platform === 'claude') {
-    const agentAdapter = await loadAdapter('claude', 'agent-adapter.js');
-    convertAgentFn = agentAdapter.convertAgent;
-  } else if (platform === 'codex') {
-    const agentAdapter = await loadAdapter('codex', 'agent-adapter.js');
-    convertAgentFn = agentAdapter.convertAgent;
-  }
-
-  for (const file of agentFiles) {
-    const content = await fs.readFile(path.join(agentsDir, file), 'utf8');
-
-    if (platform === 'codebuddy') {
-      const targetDir = path.join(projectRoot, '.codebuddy', 'agents');
-      if (dryRun) {
-        console.log(chalk.gray(`      [dry-run] .codebuddy/agents/${file}`));
-        continue;
-      }
-      await fs.ensureDir(targetDir);
-      await fs.writeFile(path.join(targetDir, file), content);
-      console.log(chalk.green(`      ✓ .codebuddy/agents/${file}`));
-
-    } else if (platform === 'claude') {
-      const converted = convertAgentFn(content, { model: 'inherit' });
-
-      const targetDir = path.join(projectRoot, '.claude', 'agents');
-      if (dryRun) {
-        console.log(chalk.gray(`      [dry-run] .claude/agents/${file}`));
-        continue;
-      }
-      await fs.ensureDir(targetDir);
-      await fs.writeFile(path.join(targetDir, file), converted);
-      console.log(chalk.green(`      ✓ .claude/agents/${file}`));
-    } else if (platform === 'codex') {
-      const baseName = path.basename(file, '.md');
-      const targetFile = `${baseName}.toml`;
-      const converted = convertAgentFn(content, { name: baseName });
-      const targetDir = path.join(projectRoot, '.codex', 'agents');
-      if (dryRun) {
-        console.log(chalk.gray(`      [dry-run] .codex/agents/${targetFile}`));
-        continue;
-      }
-      await fs.ensureDir(targetDir);
-      await fs.writeFile(path.join(targetDir, targetFile), converted);
-      await fs.remove(path.join(targetDir, file));
-      console.log(chalk.green(`      ✓ .codex/agents/${targetFile}`));
-    }
-  }
-}
-
-/**
- * 安装 Team 配置
+ * Legacy platform named-agent and team installation has been retired.
+ * Skill-owned references now provide inline reviewer/implementation subagent contracts.
  */
-export async function installTeamConfig(platform, projectRoot, dryRun) {
-  const teamDir = getTeamDir();
-  const teamDefPath = path.join(teamDir, 'prizm-dev-team.json');
-
-  if (!await fs.pathExists(teamDefPath)) {
-    console.log(chalk.yellow('      ⚠ 未找到团队配置文件，跳过'));
-    return;
-  }
-
-  const teamDef = await fs.readJSON(teamDefPath);
-
-  if (platform === 'codebuddy') {
-    const homeDir = process.env.HOME || process.env.USERPROFILE;
-    const targetDir = path.join(homeDir, '.codebuddy', 'teams', 'prizm-dev-team');
-
-    if (dryRun) {
-      console.log(chalk.gray(`      [dry-run] ~/.codebuddy/teams/prizm-dev-team/`));
-      return;
-    }
-
-    await fs.ensureDir(path.join(targetDir, 'inboxes'));
-
-    const config = {
-      name: teamDef.name,
-      description: teamDef.description,
-      createdAt: Date.now(),
-      leadAgentId: `${teamDef.lead}@${teamDef.name}`,
-      leadSessionId: '',
-      members: teamDef.members.map((m, i) => ({
-        agentId: `${m.name}@${teamDef.name}`,
-        name: m.name,
-        agentType: m.agentDefinition || m.name,
-        ...(m.prompt ? { prompt: m.prompt } : {}),
-        joinedAt: Date.now() + i,
-        tmuxPaneId: '',
-        cwd: '',
-        subscriptions: m.subscriptions || [],
-      })),
-    };
-
-    await fs.writeFile(path.join(targetDir, 'config.json'), JSON.stringify(config, null, 2));
-
-    for (const member of teamDef.members) {
-      const inboxPath = path.join(targetDir, 'inboxes', `${member.name}.json`);
-      if (!await fs.pathExists(inboxPath)) {
-        await fs.writeFile(inboxPath, JSON.stringify([], null, 2));
-      }
-    }
-
-    console.log(chalk.green(`      ✓ ~/.codebuddy/teams/prizm-dev-team/`));
-
-  } else if (platform === 'claude') {
-    const claudeDir = path.join(projectRoot, '.claude');
-
-    if (dryRun) {
-      console.log(chalk.gray(`      [dry-run] .claude/team-info.json`));
-      return;
-    }
-
-    await fs.ensureDir(claudeDir);
-
-    const teamConfig = {
-      name: teamDef.name,
-      description: teamDef.description,
-      platform: 'claude',
-      orchestrationMode: 'subagent',
-      agents: teamDef.members
-        .filter(m => m.role !== 'lead')
-        .map(m => ({
-          name: m.name,
-          role: m.role,
-          agentFile: `.claude/agents/${m.agentDefinition}.md`,
-          prompt: m.prompt,
-        })),
-      upgrade: {
-        envVar: 'CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS',
-        command: '设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 可启用原生 Agent Teams 模式',
-      },
-    };
-
-    await fs.writeFile(
-      path.join(claudeDir, 'team-info.json'),
-      JSON.stringify(teamConfig, null, 2)
-    );
-
-    console.log(chalk.green(`      ✓ .claude/team-info.json`));
-  } else if (platform === 'codex') {
-    const codexDir = path.join(projectRoot, '.codex');
-
-    if (dryRun) {
-      console.log(chalk.gray(`      [dry-run] .codex/team-info.json`));
-      return;
-    }
-
-    await fs.ensureDir(codexDir);
-
-    const teamConfig = {
-      name: teamDef.name,
-      description: teamDef.description,
-      platform: 'codex',
-      orchestrationMode: 'codex-subagents',
-      agents: teamDef.members
-        .filter(m => m.role !== 'lead')
-        .map(m => ({
-          name: m.name,
-          role: m.role,
-          agentFile: `.codex/agents/${m.agentDefinition}.toml`,
-          prompt: m.prompt,
-          subscriptions: m.subscriptions || [],
-        })),
-    };
-
-    await fs.writeFile(
-      path.join(codexDir, 'team-info.json'),
-      JSON.stringify(teamConfig, null, 2)
-    );
-
-    console.log(chalk.green(`      ✓ .codex/team-info.json`));
-  }
-}
 
 /**
  * 安装平台配置文件（settings/hooks/rules）
@@ -591,7 +480,7 @@ export async function installSettings(platform, projectRoot, options, dryRun, ru
     await fs.ensureDir(path.dirname(configPath));
     const configToml = `# Generated by PrizmKit for Codex CLI project configuration.
 # Keep project guidance in AGENTS.md; repository skills in .agents/skills/;
-# PrizmKit behavioral rules live in .agents/rules/; native Codex subagents live in .codex/agents/.
+# PrizmKit behavioral rules live in .agents/rules/.
 
 project_doc_fallback_filenames = ["CLAUDE.md", "CODEBUDDY.md"]
 
@@ -1058,7 +947,7 @@ Codex discovers repository skills from \`.agents/skills/\`. When a user or promp
 - Start with \`.agents/skills/prizmkit/SKILL.md\` to see all available PrizmKit skills.
 - Skill assets and references live inside each \`.agents/skills/<skill>/\` directory.
 - PrizmKit behavioral rules live in \`.agents/rules/\`; read the relevant Markdown guidance before commit, documentation, or context-loading work.
-- Native Codex subagents live in \`.codex/agents/*.toml\`; use them when spawning or coordinating subagents.`
+`
     );
   }
 
@@ -1585,7 +1474,6 @@ export const EXTRAS_REGISTRY = {
  * @param {string} config.platform - 'codebuddy' | 'claude' | 'codex' | 'all'
  * @param {string} [config.runtime] - 'python' (legacy aliases accepted: 'unix' | 'windows')
  * @param {string} config.skills - 'core' | 'minimal' | 'recommended:<type>'
- * @param {boolean} config.team - 是否启用团队模式
  * @param {boolean} config.pipeline - 是否安装 dev-pipeline
  * @param {string} [config.rules] - Rules preset: 'recommended' | 'minimal' | 'none'
  * @param {string} [config.aiCli] - AI CLI 可执行命令（写入 .prizmkit/config.json）
@@ -1597,7 +1485,7 @@ export const EXTRAS_REGISTRY = {
  * @param {boolean} config.dryRun - 是否为预览模式
  */
 export async function scaffold(config) {
-  const { platform, skills, team, pipeline, rules, aiCli, aiCliLaunch, externalSkills, playwrightCli, openCli, openCliAutoDownload, projectRoot, dryRun } = config;
+  const { platform, skills, pipeline, rules, aiCli, aiCliLaunch, externalSkills, playwrightCli, openCli, openCliAutoDownload, projectRoot, dryRun } = config;
   const runtime = normalizeRuntime(config.runtime);
   const launchSelection = resolveAiCliLaunchSelection(aiCli || '', {
     aiCliLaunch,
@@ -1622,21 +1510,13 @@ export async function scaffold(config) {
   for (const p of payloadPlatforms) {
     console.log(chalk.bold(`  正在安装 ${platformLabel(p)} 环境...${platforms.includes(p) ? '' : chalk.gray(' (AI CLI payload)')}\n`));
 
+    await removeRetiredAgentTeamArtifacts(p, projectRoot, dryRun);
+
     // 1. Skills
     console.log(chalk.blue('    技能文件:'));
     await installSkills(p, skillList, projectRoot, dryRun, runtime);
 
-    // 2. Agents
-    console.log(chalk.blue('\n    Agent 定义:'));
-    await installAgents(p, projectRoot, dryRun);
-
-    // 3. Team
-    if (team) {
-      console.log(chalk.blue('\n    团队配置:'));
-      await installTeamConfig(p, projectRoot, dryRun);
-    }
-
-    // 4. Settings/Hooks/Rules
+    // 2. Settings/Hooks/Rules
     console.log(chalk.blue('\n    平台配置:'));
     await installSettings(p, projectRoot, { pipeline, rules }, dryRun, runtime);
 
@@ -1747,8 +1627,6 @@ export async function scaffold(config) {
 
   // 14. Write installation manifest
   if (!dryRun) {
-    const agentsDir = getAgentsDir();
-    const agentFileNames = (await fs.readdir(agentsDir)).filter(f => f.endsWith('.md'));
     const rulesMeta = await loadRulesMetadata();
     const rulesPresetName = rules || 'recommended';
     const ruleFileNames = resolveRuleNamesForRuntime(rulesMeta, rulesPresetName, runtime).map(name => `${name}.md`);
@@ -1759,10 +1637,8 @@ export async function scaffold(config) {
       runtime,
       suite: skills,
       skills: skillList,
-      agents: agentFileNames,
       rules: ruleFileNames,
       pipeline: installedPipelineFiles,
-      team,
       aiCli: resolvedAiCli,
       rulesPreset: rulesPresetName,
       extras: activeExtras,
@@ -1819,7 +1695,6 @@ export async function scaffold(config) {
       console.log(chalk.gray(`    AI CLI 载荷平台: ${payloadPlatforms.map(platformLabel).join(' + ')}`));
     }
     console.log(chalk.gray(`    运行时: ${runtimeLabel(runtime)}`));
-    console.log(chalk.gray(`    团队: ${team ? '已启用' : '未启用'}`));
     console.log(chalk.gray(`    流水线: ${pipeline ? '已安装' : '未安装'}`));
     const browserTools = [playwrightCli && 'playwright-cli', openCli && 'opencli'].filter(Boolean);
     console.log(chalk.gray(`    浏览器工具: ${browserTools.length ? '已安装 (' + browserTools.join(' + ') + ')' : '未安装'}`));

package/src/upgrade.js

@@ -16,23 +16,21 @@ import { confirm } from '@inquirer/prompts';
 import { readManifest, writeManifest, buildManifest, diffManifest } from './manifest.js';
 import {
   loadRulesMetadata,
-  getAgentsDir,
 } from './metadata.js';
 import {
   installSkills,
-  installAgents,
   installSettings,
   installPipeline,
   installPrizmkitScripts,
   installGitHook,
   installGitignore,
   installProjectMemory,
-  installTeamConfig,
   resolvePipelineFileList,
   findStaleManagedPipelineFiles,
   removeStaleManagedPipelineFiles,
   resolveRuleNamesForRuntime,
   resolveSkillList,
+  removeRetiredAgentTeamArtifacts,
   EXTRAS_REGISTRY,
 } from './scaffold.js';
 import { platformLabel, privateProjectMemoryFiles, resolvePayloadPlatforms } from './platforms.js';
@@ -222,7 +220,6 @@ export async function runUpgrade(directory, options = {}) {
   // 3. Resolve new skill list using old manifest's suite + platform (or defaults)
   const suite = oldManifest?.suite || 'core';
   const runtime = normalizeRuntime(oldManifest?.runtime);
-  const team = oldManifest?.options?.team ?? true;
   const pipeline = oldManifest?.options?.pipeline ?? true;
   const rulesPreset = oldManifest?.options?.rules || 'recommended';
   const aiCli = userConfig.ai_cli || oldManifest?.options?.aiCli || '';
@@ -243,12 +240,9 @@ export async function runUpgrade(directory, options = {}) {
         return false;
       }
     };
-    const hasClaude = await hasPlatformFiles(path.join(projectRoot, '.claude', 'commands'))
-                      || await hasPlatformFiles(path.join(projectRoot, '.claude', 'agents'));
-    const hasCodeBuddy = await hasPlatformFiles(path.join(projectRoot, '.codebuddy', 'skills'))
-                         || await hasPlatformFiles(path.join(projectRoot, '.codebuddy', 'agents'));
-    const hasCodex = await hasPlatformFiles(path.join(projectRoot, '.agents', 'skills'))
-                     || await hasPlatformFiles(path.join(projectRoot, '.codex', 'agents'));
+    const hasClaude = await hasPlatformFiles(path.join(projectRoot, '.claude', 'commands'));
+    const hasCodeBuddy = await hasPlatformFiles(path.join(projectRoot, '.codebuddy', 'skills'));
+    const hasCodex = await hasPlatformFiles(path.join(projectRoot, '.agents', 'skills'));
 
     const detectedPlatforms = [
       hasCodeBuddy && 'codebuddy',
@@ -262,8 +256,6 @@ export async function runUpgrade(directory, options = {}) {
   }
 
   const newSkillList = await resolveSkillList(suite);
-  const agentsDir = getAgentsDir();
-  const newAgentFiles = (await fs.readdir(agentsDir)).filter(f => f.endsWith('.md'));
   const rulesMeta = await loadRulesMetadata();
   const newRuleFiles = resolveRuleNamesForRuntime(rulesMeta, rulesPreset, runtime).map(name => `${name}.md`);
 
@@ -286,10 +278,8 @@ export async function runUpgrade(directory, options = {}) {
     runtime,
     suite,
     skills: newSkillList,
-    agents: newAgentFiles,
     rules: newRuleFiles,
     pipeline: newPipelineFiles,
-    team,
     aiCli,
     rulesPreset,
     extras: extrasToInstall,
@@ -301,7 +291,7 @@ export async function runUpgrade(directory, options = {}) {
     newManifest.installedAt = oldManifest.installedAt;
   }
 
-  const diff = oldManifest ? diffManifest(oldManifest, newManifest) : { skills: { added: [], removed: [] }, agents: { added: [], removed: [] }, rules: { added: [], removed: [] }, pipeline: { added: [], removed: [] }, extras: { added: [], removed: [] } };
+  const diff = oldManifest ? diffManifest(oldManifest, newManifest) : { skills: { added: [], removed: [] }, rules: { added: [], removed: [] }, pipeline: { added: [], removed: [] }, extras: { added: [], removed: [] }, legacyAgents: { added: [], removed: [] } };
   const removedPipelineSet = new Set(diff.pipeline.removed);
   const staleManagedPipelineFiles = pipeline
     ? (await findStaleManagedPipelineFiles(projectRoot, runtime))
@@ -317,14 +307,13 @@ export async function runUpgrade(directory, options = {}) {
   console.log(`    Suite: ${suite}`);
   console.log('');
 
-  const totalAdded = diff.skills.added.length + diff.agents.added.length + diff.rules.added.length + diff.pipeline.added.length + diff.extras.added.length;
-  const totalRemoved = diff.skills.removed.length + diff.agents.removed.length + diff.rules.removed.length + diff.pipeline.removed.length + diff.extras.removed.length + staleManagedPipelineFiles.length;
-  const totalUpdated = newSkillList.length + newAgentFiles.length + newRuleFiles.length;
+  const totalAdded = diff.skills.added.length + diff.rules.added.length + diff.pipeline.added.length + diff.extras.added.length;
+  const totalRemoved = diff.skills.removed.length + diff.rules.removed.length + diff.pipeline.removed.length + diff.extras.removed.length + diff.legacyAgents.removed.length + staleManagedPipelineFiles.length;
+  const totalUpdated = newSkillList.length + newRuleFiles.length;
 
   if (diff.skills.added.length) console.log(chalk.green(`    + Skills added: ${diff.skills.added.join(', ')}`));
   if (diff.skills.removed.length) console.log(chalk.red(`    - Skills removed: ${diff.skills.removed.join(', ')}`));
-  if (diff.agents.added.length) console.log(chalk.green(`    + Agents added: ${diff.agents.added.join(', ')}`));
-  if (diff.agents.removed.length) console.log(chalk.red(`    - Agents removed: ${diff.agents.removed.join(', ')}`));
+  if (diff.legacyAgents.removed.length) console.log(chalk.red(`    - Legacy agents removed: ${diff.legacyAgents.removed.join(', ')}`));
   if (diff.rules.added.length) console.log(chalk.green(`    + Rules added: ${diff.rules.added.join(', ')}`));
   if (diff.rules.removed.length) console.log(chalk.red(`    - Rules removed: ${diff.rules.removed.join(', ')}`));
   if (diff.pipeline.added.length) console.log(chalk.green(`    + Pipeline files added: ${diff.pipeline.added.length} file(s)`));
@@ -356,17 +345,19 @@ export async function runUpgrade(directory, options = {}) {
   const platforms = payloadPlatforms;
 
   // 7a. Remove orphaned files
-  if (diff.skills.removed.length || diff.agents.removed.length || diff.rules.removed.length || diff.pipeline.removed.length || staleManagedPipelineFiles.length) {
+  if (diff.skills.removed.length || diff.legacyAgents.removed.length || diff.rules.removed.length || diff.pipeline.removed.length || staleManagedPipelineFiles.length) {
     console.log(chalk.bold('\n  Removing orphaned files...'));
     for (const p of platforms) {
       if (diff.skills.removed.length) {
         console.log(chalk.blue(`\n    Removed skills (${p}):`));
         await removeSkillFiles(p, projectRoot, diff.skills.removed, dryRun);
       }
-      if (diff.agents.removed.length) {
-        console.log(chalk.blue(`\n    Removed agents (${p}):`));
-        await removeAgentFiles(p, projectRoot, diff.agents.removed, dryRun);
+      if (diff.legacyAgents.removed.length) {
+        console.log(chalk.blue(`\n    Removed legacy agents (${p}):`));
+        await removeAgentFiles(p, projectRoot, diff.legacyAgents.removed, dryRun);
       }
+      console.log(chalk.blue(`\n    Removed retired agent/team artifacts (${p}):`));
+      await removeRetiredAgentTeamArtifacts(p, projectRoot, dryRun);
       if (diff.rules.removed.length) {
         console.log(chalk.blue(`\n    Removed rules (${p}):`));
         await removeRuleFiles(p, projectRoot, diff.rules.removed, dryRun);
@@ -387,24 +378,16 @@ export async function runUpgrade(directory, options = {}) {
 
   for (const p of platforms) {
     console.log(chalk.bold(`  Installing ${platformLabel(p)} environment...\n`));
+    await removeRetiredAgentTeamArtifacts(p, projectRoot, dryRun);
 
     // Skills
     console.log(chalk.blue('    Skills:'));
     await installSkills(p, newSkillList, projectRoot, dryRun, runtime);
 
-    // Agents
-    console.log(chalk.blue('\n    Agents:'));
-    await installAgents(p, projectRoot, dryRun);
-
     // Settings/Rules
     console.log(chalk.blue('\n    Settings & Rules:'));
     await installSettings(p, projectRoot, { pipeline, rules: rulesPreset }, dryRun, runtime);
 
-    if (team) {
-      console.log(chalk.blue('\n    Team Config:'));
-      await installTeamConfig(p, projectRoot, dryRun);
-    }
-
     console.log('');
   }