prizmkit 1.0.0 → 1.0.1

package/bundled/VERSION.json

@@ -0,0 +1,5 @@
+{
+  "frameworkVersion": "1.0.0",
+  "bundledAt": "2026-03-09T15:24:07.558Z",
+  "bundledFrom": "/Users/loneyu/SelfProjects/PrizmKitEvolvingProgramming"
+}

package/bundled/adapters/claude/agent-adapter.js

@@ -0,0 +1,108 @@
+/**
+ * Claude Code Agent Adapter
+ * Converts core/ agent definitions to .claude/agents/ format.
+ *
+ * Key differences from CodeBuddy agents:
+ *   - tools: comma-separated string -> YAML array
+ *   - model: "inherit" -> explicit model name
+ *   - skills: field removed (skills become /slash-commands in body)
+ *   - TaskCreate/Get/Update/List -> Task (single tool)
+ *   - SendMessage -> SendMessage (native Agent Teams communication)
+ */
+
+import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
+import { mkdirSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'path';
+
+// Tool name mapping from CodeBuddy to Claude Code
+// Claude Code 原生 Agent Teams 支持 SendMessage 工具进行 teammate 间通信
+const TOOL_MAPPING = {
+  'TaskCreate': 'Task',
+  'TaskGet': 'Task',
+  'TaskUpdate': 'Task',
+  'TaskList': 'Task',
+  'SendMessage': 'SendMessage',
+};
+
+// Default model for Claude Code agents
+const DEFAULT_MODEL = 'claude-sonnet-4-20250514';
+
+/**
+ * Convert a core agent definition to Claude Code format.
+ * @param {string} agentContent - Content of the core agent .md
+ * @param {Object} options - { model?: string }
+ * @returns {string} - Claude Code formatted agent .md content
+ */
+export function convertAgent(agentContent, options = {}) {
+  const { frontmatter, body } = parseFrontmatter(agentContent);
+
+  // Convert tools: comma-separated string -> deduplicated array
+  let tools = [];
+  if (frontmatter.tools) {
+    const rawTools = frontmatter.tools.split(',').map(t => t.trim());
+    const mapped = rawTools.map(t => {
+      if (TOOL_MAPPING.hasOwnProperty(t)) {
+        return TOOL_MAPPING[t];
+      }
+      return t;
+    }).filter(Boolean);
+    tools = [...new Set(mapped)];
+  }
+
+  // Convert skills references in body to slash commands
+  let convertedBody = body;
+  if (frontmatter.skills) {
+    const skillsList = frontmatter.skills.split(',').map(s => s.trim());
+
+    // Add a section about available slash commands
+    const commandList = skillsList.map(s => `- \`/${s}\``).join('\n');
+    const commandSection = `\n\n### 可用命令 (Available Slash Commands)\n\n以下 PrizmKit 命令可通过 slash command 调用:\n${commandList}\n`;
+
+    // Insert before the first ### section or at the end of body
+    const firstH3 = convertedBody.indexOf('\n### ');
+    if (firstH3 > 0) {
+      convertedBody = convertedBody.slice(0, firstH3) + commandSection + convertedBody.slice(firstH3);
+    } else {
+      convertedBody += commandSection;
+    }
+  }
+
+  // Replace "invoke ... skill" with slash command syntax
+  convertedBody = convertedBody.replace(
+    /invoke\s+(?:the\s+)?[`"]?(\w[\w-]*)[`"]?\s+skill/gi,
+    'run `/$1` command'
+  );
+
+  // Replace prizmkit.xxx shorthand with /prizmkit-xxx
+  convertedBody = convertedBody.replace(
+    /prizmkit\.(\w+)/g,
+    (match, sub) => `/prizmkit-${sub.replace(/_/g, '-')}`
+  );
+
+  // Build Claude Code frontmatter
+  const claudeFrontmatter = {
+    name: frontmatter.name,
+    description: frontmatter.description,
+    tools: tools,
+    model: options.model || DEFAULT_MODEL,
+  };
+
+  return buildMarkdown(claudeFrontmatter, convertedBody);
+}
+
+/**
+ * Install an agent definition to the target project's .claude/agents/.
+ * @param {string} corePath - Path to core/agents/<name>.md
+ * @param {string} targetRoot - Target project root
+ * @param {Object} options - { model?: string }
+ */
+export async function installAgent(corePath, targetRoot, options = {}) {
+  const filename = path.basename(corePath);
+  const targetDir = path.join(targetRoot, '.claude', 'agents');
+  mkdirSync(targetDir, { recursive: true });
+
+  const content = await readFile(corePath, 'utf8');
+  const converted = convertAgent(content, options);
+  await writeFile(path.join(targetDir, filename), converted);
+}

package/bundled/adapters/claude/command-adapter.js

@@ -0,0 +1,104 @@
+/**
+ * Claude Code Command Adapter
+ * Converts core/ skill content to .claude/commands/ format.
+ *
+ * Key differences from CodeBuddy SKILL.md:
+ *   - Claude Code commands omit the `name` field (filename is the name)
+ *   - Only `description` in frontmatter
+ *   - `${SKILL_DIR}` references rewritten to relative paths
+ *   - Skills with assets/scripts use directory structure
+ */
+
+import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
+import { COMMANDS_DIR } from './paths.js';
+import { existsSync, mkdirSync, cpSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'path';
+
+/**
+ * Convert a core SKILL.md to Claude Code command.md format.
+ * @param {string} skillContent - Content of the core SKILL.md
+ * @param {string} skillName - Skill directory name
+ * @returns {string} - Claude Code formatted command.md content
+ */
+export function convertSkillToCommand(skillContent, skillName) {
+  const { frontmatter, body } = parseFrontmatter(skillContent);
+
+  // Claude Code command frontmatter only uses description
+  const claudeFrontmatter = {
+    description: frontmatter.description || `PrizmKit ${skillName} command`,
+  };
+
+  // Rewrite ${SKILL_DIR} references to use relative path from .claude/commands/<name>/
+  let convertedBody = body;
+
+  // Replace ${SKILL_DIR} with a Claude Code compatible path
+  // In Claude Code, commands in a directory can reference sibling files
+  // Use project-root-relative paths as fallback
+  convertedBody = convertedBody.replace(
+    /\$\{SKILL_DIR\}/g,
+    `.claude/commands/${skillName}`
+  );
+
+  // Replace "invoke the X skill" or "prizmkit.X" patterns with /X slash command
+  convertedBody = convertedBody.replace(
+    /invoke\s+(?:the\s+)?[`"]?(\w[\w-]*)[`"]?\s+skill/gi,
+    'run the `/$1` command'
+  );
+
+  // Replace prizmkit.xxx with /prizmkit-xxx for Claude Code
+  convertedBody = convertedBody.replace(
+    /prizmkit\.(\w+)/g,
+    (match, sub) => {
+      // Map common shorthand: prizmkit.init -> /prizmkit-init
+      const commandName = `prizmkit-${sub.replace(/_/g, '-')}`;
+      return `\`/${commandName}\``;
+    }
+  );
+
+  return buildMarkdown(claudeFrontmatter, convertedBody);
+}
+
+/**
+ * Install a skill as a Claude Code command in the target project.
+ * @param {string} corePath - Path to core/skills/<skill-name>/
+ * @param {string} targetRoot - Target project root
+ */
+export async function installCommand(corePath, targetRoot) {
+  const skillName = path.basename(corePath);
+  const hasAssets = existsSync(path.join(corePath, 'assets'));
+  const hasScripts = existsSync(path.join(corePath, 'scripts'));
+
+  if (hasAssets || hasScripts) {
+    // Use directory structure for commands with resources
+    const targetDir = path.join(targetRoot, COMMANDS_DIR, skillName);
+    mkdirSync(targetDir, { recursive: true });
+
+    // Convert and write command.md
+    const skillMdPath = path.join(corePath, 'SKILL.md');
+    if (existsSync(skillMdPath)) {
+      const content = await readFile(skillMdPath, 'utf8');
+      const converted = convertSkillToCommand(content, skillName);
+      await writeFile(path.join(targetDir, `${skillName}.md`), converted);
+    }
+
+    // Copy assets and scripts
+    for (const subdir of ['scripts', 'assets']) {
+      const srcSubdir = path.join(corePath, subdir);
+      if (existsSync(srcSubdir)) {
+        cpSync(srcSubdir, path.join(targetDir, subdir), { recursive: true });
+      }
+    }
+  } else {
+    // Single file command
+    const targetDir = path.join(targetRoot, COMMANDS_DIR);
+    mkdirSync(targetDir, { recursive: true });
+
+    const skillMdPath = path.join(corePath, 'SKILL.md');
+    if (existsSync(skillMdPath)) {
+      const content = await readFile(skillMdPath, 'utf8');
+      const converted = convertSkillToCommand(content, skillName);
+      await writeFile(path.join(targetDir, `${skillName}.md`), converted);
+    }
+  }
+}

package/bundled/adapters/claude/paths.js

@@ -0,0 +1,35 @@
+/**
+ * Claude Code platform path constants and conventions.
+ */
+
+export const PLATFORM_ID = 'claude';
+export const CLI_COMMAND = 'claude';
+
+// Project-level paths (relative to project root)
+export const COMMANDS_DIR = '.claude/commands';
+export const AGENTS_DIR = '.claude/agents';
+export const SETTINGS_FILE = '.claude/settings.json';
+export const RULES_DIR = '.claude/rules';
+export const PROJECT_MEMORY_FILE = 'CLAUDE.md';
+export const MCP_CONFIG_FILE = '.mcp.json';
+
+// Global paths (relative to home directory)
+export const GLOBAL_CONFIG_DIR = '.claude';
+export const GLOBAL_AGENTS_DIR = '.claude/agents';
+
+// Command file conventions (equivalent to skills)
+// Note: Actual command files are named <skill-name>.md (e.g. prizmkit-specify.md)
+// Directory-based commands with assets also use <skill-name>.md inside the directory.
+export const COMMAND_DEFINITION_FILE = '<skill-name>.md';
+export const COMMAND_DIR_VAR = '${COMMAND_DIR}';     // May not be natively supported
+
+// Agent definition format
+export const AGENT_FILE_EXT = '.md';
+
+// CLI flags
+export const CLI_FLAGS = {
+  nonInteractive: '-p',
+  autoAccept: '--yes',
+  verbose: '--verbose',
+  print: '--print',
+};

package/bundled/adapters/claude/rules-adapter.js

@@ -0,0 +1,77 @@
+/**
+ * Claude Code Rules Adapter
+ * Generates .claude/rules/ files for PrizmKit-enabled projects.
+ * Rules provide modular, path-scoped instructions for Claude Code.
+ */
+
+import { mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import path from 'path';
+
+const RULES = [
+  {
+    filename: 'prizm-documentation.md',
+    content: `---
+description: "PrizmKit documentation rules"
+globs:
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/*.js"
+  - "**/*.jsx"
+  - "**/*.py"
+  - "**/*.go"
+  - "**/*.rs"
+  - "**/*.java"
+---
+
+When modifying source files in this project:
+1. Check if \`.prizm-docs/root.prizm\` exists
+2. If it does, read it before making changes to understand project structure
+3. After making changes, update affected \`.prizm-docs/\` files
+4. Follow the Prizm doc format (KEY: value, not prose)
+5. Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB
+`,
+  },
+  {
+    filename: 'prizm-commit-workflow.md',
+    content: `---
+description: "PrizmKit commit workflow rules"
+---
+
+Before any git commit in this project:
+1. Update \`.prizm-docs/\` for affected modules
+2. Use Conventional Commits format: type(scope): description
+3. Bug fixes use \`fix()\` prefix, not \`feat()\`
+4. Do NOT create REGISTRY.md entries for bug fixes
+5. Use \`/prizmkit-committer\` command for the complete commit workflow
+`,
+  },
+  {
+    filename: 'prizm-progressive-loading.md',
+    content: `---
+description: "PrizmKit progressive context loading protocol"
+---
+
+This project uses PrizmKit's progressive loading protocol:
+- ON SESSION START: Read \`.prizm-docs/root.prizm\` (L0 — project map)
+- ON TASK: Read L1 (\`.prizm-docs/<module>.prizm\`) for relevant modules
+- ON FILE EDIT: Read L2 (\`.prizm-docs/<module>/<submodule>.prizm\`) before modifying
+- NEVER load all .prizm docs at once
+- Arrow notation (->) in .prizm files indicates load pointers
+- DECISIONS and CHANGELOG in .prizm files are append-only
+`,
+  },
+];
+
+/**
+ * Install PrizmKit rules to the target project's .claude/rules/ directory.
+ * @param {string} targetRoot - Target project root
+ */
+export async function installRules(targetRoot) {
+  const rulesDir = path.join(targetRoot, '.claude', 'rules');
+  mkdirSync(rulesDir, { recursive: true });
+
+  for (const rule of RULES) {
+    await writeFile(path.join(rulesDir, rule.filename), rule.content);
+  }
+}

package/bundled/adapters/claude/settings-adapter.js

@@ -0,0 +1,73 @@
+/**
+ * Claude Code Settings Adapter
+ * Generates .claude/settings.json with PrizmKit hooks and permissions.
+ */
+
+import { existsSync, mkdirSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import path from 'path';
+
+/**
+ * Generate Claude Code settings.json for a PrizmKit-enabled project.
+ * @param {string} targetRoot - Target project root
+ * @param {Object} options - { hooks: boolean, pipeline: boolean }
+ */
+export async function generateSettings(targetRoot, options = {}) {
+  const settingsPath = path.join(targetRoot, '.claude', 'settings.json');
+  mkdirSync(path.dirname(settingsPath), { recursive: true });
+
+  let existing = {};
+  if (existsSync(settingsPath)) {
+    try {
+      existing = JSON.parse(await readFile(settingsPath, 'utf8'));
+    } catch {
+      existing = {};
+    }
+  }
+
+  // Permissions for pipeline and PrizmKit operations
+  if (!existing.permissions) existing.permissions = {};
+  if (!existing.permissions.allow) existing.permissions.allow = [];
+
+  const prizmkitPermissions = [
+    'Bash(python3 *)',
+    'Bash(git *)',
+    'Bash(jq *)',
+  ];
+
+  if (options.pipeline) {
+    prizmkitPermissions.push(
+      'Bash(./dev-pipeline/*)',
+      'Bash(python3 dev-pipeline/*)',
+    );
+  }
+
+  // Merge without duplicates
+  for (const perm of prizmkitPermissions) {
+    if (!existing.permissions.allow.includes(perm)) {
+      existing.permissions.allow.push(perm);
+    }
+  }
+
+  // Hooks for PrizmKit commit workflow
+  if (options.hooks !== false) {
+    if (!existing.hooks) existing.hooks = {};
+
+    // SessionStart hook: remind about .prizm-docs
+    if (!existing.hooks.SessionStart) {
+      existing.hooks.SessionStart = [
+        {
+          matcher: 'startup',
+          hooks: [
+            {
+              type: 'command',
+              command: 'test -f .prizm-docs/root.prizm && echo "PrizmKit: .prizm-docs found. Read root.prizm for project context." || echo "PrizmKit: No .prizm-docs found. Run /prizmkit-init to bootstrap."',
+            },
+          ],
+        },
+      ];
+    }
+  }
+
+  await writeFile(settingsPath, JSON.stringify(existing, null, 2));
+}

package/bundled/adapters/claude/team-adapter.js

@@ -0,0 +1,183 @@
+/**
+ * Claude Code Team Adapter
+ *
+ * 支持 Claude Code 原生 Agent Teams 系统。
+ * 通过环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 启用原生团队模式。
+ *
+ * 两种模式:
+ *   1. 原生 Agent Teams 模式 (推荐): 使用 SendMessage 实现 teammate 间多向通信
+ *   2. Subagent 模式 (兜底): 通过 Task 工具由 Coordinator 单向编排
+ *
+ * 原生 Agent Teams 的核心机制:
+ *   - 每个 agent 作为 teammate 持续运行
+ *   - 通过 SendMessage 工具实现点对点、广播通信
+ *   - 共享任务目录 ~/.claude/tasks/{team-name}/
+ *   - 支持 shutdown 消息终止 teammate
+ */
+
+import { mkdirSync, existsSync } from 'node:fs';
+import { writeFile, readFile } from 'node:fs/promises';
+import path from 'path';
+
+/**
+ * 检测是否启用了原生 Agent Teams 模式
+ * @returns {boolean}
+ */
+export function isNativeTeamsEnabled() {
+  return process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === '1';
+}
+
+/**
+ * 生成原生 Agent Teams 配置
+ * 当 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 时使用此模式
+ *
+ * @param {Object} teamDef - 平台无关的团队定义 (core/team/*.json)
+ * @param {string} targetRoot - 目标项目根目录
+ */
+async function installNativeTeam(teamDef, targetRoot) {
+  const claudeDir = path.join(targetRoot, '.claude');
+  mkdirSync(claudeDir, { recursive: true });
+
+  // 构建原生 Agent Teams 配置
+  const teamConfig = {
+    name: teamDef.name,
+    description: teamDef.description,
+    platform: 'claude',
+    orchestrationMode: 'native-agent-teams',
+    envVar: 'CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1',
+    teammates: teamDef.members.map(m => ({
+      name: m.name,
+      role: m.role,
+      agentFile: `.claude/agents/${m.agentDefinition}.md`,
+      prompt: m.prompt || '',
+      subscriptions: m.subscriptions || [],
+    })),
+    communication: {
+      protocol: 'SendMessage',
+      modes: ['point-to-point', 'broadcast', 'shutdown'],
+      messageTypes: [
+        'STATUS_UPDATE',
+        'COMPLETION_SIGNAL',
+        'ISSUE_REPORT',
+        'ESCALATION',
+        'HEARTBEAT_CHECK',
+        'TASK_ASSIGNMENT',
+      ],
+      routing: 'mesh',
+      note: 'Teammates 之间可直接通信 (SendMessage)，关键消息同时通知 Coordinator。',
+    },
+    sharedTaskDir: `~/.claude/tasks/${teamDef.name}/`,
+  };
+
+  await writeFile(
+    path.join(claudeDir, 'team-info.json'),
+    JSON.stringify(teamConfig, null, 2)
+  );
+
+  // 生成 Agent Teams 使用说明
+  const teamGuide = `# ${teamDef.name} — Agent Teams 配置
+
+## 启用方式
+
+\`\`\`bash
+export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
+\`\`\`
+
+## 团队成员
+
+| 名称 | 角色 | Agent 文件 |
+|------|------|-----------|
+${teamDef.members.map(m => `| ${m.name} | ${m.role} | \`.claude/agents/${m.agentDefinition}.md\` |`).join('\n')}
+
+## 通信机制
+
+原生 Agent Teams 使用 **SendMessage** 工具实现 teammate 间通信：
+
+- **点对点**: \`SendMessage(to: "pm", message: "...")\`
+- **广播**: \`SendMessage(to: "*", message: "...")\`
+- **终止**: \`SendMessage(to: "dev", type: "shutdown")\`
+
+## 消息类型
+
+- \`STATUS_UPDATE\` — Agent 汇报状态变化
+- \`COMPLETION_SIGNAL\` — Agent 完成任务通知
+- \`ISSUE_REPORT\` — Agent 报告问题
+- \`ESCALATION\` — Agent 请求升级处理
+- \`HEARTBEAT_CHECK\` — 检查 Agent 存活
+- \`TASK_ASSIGNMENT\` — 任务分配指令
+
+## 与 Subagent 模式的区别
+
+| 维度 | Subagent 模式 | 原生 Agent Teams |
+|------|---------------|-----------------|
+| 通信方式 | Coordinator 通过 Task 单向 spawn | SendMessage 多向通信 |
+| Agent 生命周期 | 完成即消亡 | 持续运行 |
+| 协作模式 | 星型 (Coordinator 中心) | 网状 (任意 teammate 间) |
+| 共享状态 | 无 | ~/.claude/tasks/${teamDef.name}/ |
+`;
+
+  await writeFile(
+    path.join(claudeDir, 'team-guide.md'),
+    teamGuide
+  );
+}
+
+/**
+ * 生成 Subagent 模式配置 (兜底)
+ * 当未启用 Agent Teams 时使用此模式
+ *
+ * @param {Object} teamDef - 平台无关的团队定义
+ * @param {string} targetRoot - 目标项目根目录
+ */
+async function installSubagentTeam(teamDef, targetRoot) {
+  const claudeDir = path.join(targetRoot, '.claude');
+  mkdirSync(claudeDir, { recursive: true });
+
+  const teamInfo = {
+    name: teamDef.name,
+    description: teamDef.description,
+    platform: 'claude',
+    orchestrationMode: 'subagent',
+    note: 'Subagent 兜底模式。如需启用原生 Agent Teams，设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 后重新安装。',
+    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: 'npx prizmkit init  # 重新安装以启用原生 Agent Teams',
+    },
+  };
+
+  await writeFile(
+    path.join(claudeDir, 'team-info.json'),
+    JSON.stringify(teamInfo, null, 2)
+  );
+}
+
+/**
+ * 安装团队配置到目标项目。
+ * 自动检测环境变量决定使用原生 Agent Teams 或 Subagent 模式。
+ *
+ * @param {Object} teamDef - 平台无关的团队定义
+ * @param {string} targetRoot - 目标项目根目录
+ * @returns {Promise<{ mode: string }>} - 安装的模式
+ */
+export async function installTeam(teamDef, targetRoot) {
+  const nativeMode = isNativeTeamsEnabled();
+
+  if (nativeMode) {
+    console.log('  ✓ Agent Teams 模式: 原生 (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)');
+    await installNativeTeam(teamDef, targetRoot);
+    return { mode: 'native-agent-teams' };
+  } else {
+    console.log('  ✓ Agent Teams 模式: Subagent (兜底模式)');
+    console.log('    提示: 设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 可启用原生 Agent Teams');
+    await installSubagentTeam(teamDef, targetRoot);
+    return { mode: 'subagent' };
+  }
+}

package/bundled/adapters/codebuddy/agent-adapter.js

@@ -0,0 +1,43 @@
+/**
+ * CodeBuddy Agent Adapter
+ * Converts core/ agent definitions to .codebuddy/agents/ format.
+ * For CodeBuddy, this is mostly pass-through as the core format matches.
+ */
+
+import { parseFrontmatter, buildMarkdown } from '../shared/frontmatter.js';
+import { existsSync, mkdirSync } from 'node:fs';
+import { readFile, writeFile, symlink } from 'node:fs/promises';
+import path from 'path';
+
+/**
+ * Convert a core agent definition to CodeBuddy format.
+ * @param {string} agentContent - Content of the core agent .md
+ * @returns {string} - CodeBuddy-formatted agent .md content
+ */
+export function convertAgent(agentContent) {
+  // CodeBuddy format is already the native core format
+  return agentContent;
+}
+
+/**
+ * Install an agent definition to the target project.
+ * @param {string} corePath - Path to core/agents/<name>.md
+ * @param {string} targetRoot - Target project root
+ * @param {Object} options - { useSymlinks: boolean }
+ */
+export async function installAgent(corePath, targetRoot, options = {}) {
+  const filename = path.basename(corePath);
+  const targetDir = path.join(targetRoot, '.codebuddy', 'agents');
+  mkdirSync(targetDir, { recursive: true });
+
+  if (options.useSymlinks) {
+    const targetPath = path.join(targetDir, filename);
+    if (!existsSync(targetPath)) {
+      await symlink(corePath, targetPath);
+    }
+  } else {
+    const content = await readFile(corePath, 'utf8');
+    const converted = convertAgent(content);
+    await writeFile(path.join(targetDir, filename), converted);
+  }
+}

package/bundled/adapters/codebuddy/paths.js

@@ -0,0 +1,29 @@
+/**
+ * CodeBuddy platform path constants and conventions.
+ */
+
+export const PLATFORM_ID = 'codebuddy';
+export const CLI_COMMAND = 'cbc';
+
+// Project-level paths (relative to project root)
+export const SKILLS_DIR = '.codebuddy/skills';
+export const AGENTS_DIR = '.codebuddy/agents';
+export const SETTINGS_FILE = '.codebuddy/settings.json';
+export const PROJECT_MEMORY_FILE = 'CODEBUDDY.md';
+
+// Global paths (relative to home directory)
+export const GLOBAL_TEAMS_DIR = '.codebuddy/teams';
+export const GLOBAL_CONFIG_DIR = '.codebuddy';
+
+// Skill file conventions
+export const SKILL_DEFINITION_FILE = 'SKILL.md';
+export const SKILL_DIR_VAR = '${SKILL_DIR}';
+
+// Agent definition format
+export const AGENT_FILE_EXT = '.md';
+
+// CLI flags
+export const CLI_FLAGS = {
+  nonInteractive: '--print -y',
+  verbose: '--verbose',
+};