@cregis-dev/cckit 0.2.0

package/src/core/upstream.js

@@ -0,0 +1,357 @@
+/**
+ * Upstream source fetching, path mapping, and file copying for sync.
+ *
+ * Handles pulling content from BMAD (npm), ECC (git), plugins (git),
+ * and external skills (git) upstreams, then copying files to the local
+ * templates/ directory via configurable path mappings with optional
+ * filters, excludes, and post-processing.
+ */
+
+import path from 'node:path'
+import fse from 'fs-extra'
+import os from 'node:os'
+import { execFile as execFileCb } from 'node:child_process'
+import { promisify } from 'node:util'
+import { mkdtemp } from 'node:fs/promises'
+import { listFiles, TEXT_EXTENSIONS } from '../utils/fs.js'
+
+const execFile = promisify(execFileCb)
+
+// ─── Path Mappings ──────────────────────────────────────────────────────────
+
+export const BMAD_PATH_MAPPINGS = [
+  { src: '_bmad/core', dest: 'bmad/core' },
+  { src: '_bmad/bmm', dest: 'bmad/bmm' },
+  { src: '_bmad/tea', dest: 'bmad/tea' },
+  { src: '_bmad/_config', dest: 'bmad/_config', exclude: ['manifest.yaml'] },
+  { src: '.claude/commands', dest: 'bmad/commands', filter: /^bmad-/ },
+  { src: '.trae/rules', dest: 'trae-bmad/rules', filter: /^bmad-/ },
+]
+
+export const ECC_REPO_URL = 'https://github.com/affaan-m/everything-claude-code'
+
+export const ECC_PATH_MAPPINGS = [
+  { src: 'rules', dest: 'ecc/rules' },
+  { src: 'agents', dest: 'ecc/agents' },
+  { src: 'skills', dest: 'ecc/skills' },
+  { src: 'commands', dest: 'ecc/commands' },
+]
+
+// ─── Fetch Functions ────────────────────────────────────────────────────────
+
+/**
+ * Fetch BMAD content by running `npx bmad-method install` in a temp directory.
+ * BMAD v6+ uses a CLI with `install` subcommand and module selection.
+ *
+ * @param {{ tmpDir: string, logger: object }} opts
+ * @returns {Promise<{ version: string, dir: string }>} Extracted npm package version and install dir
+ */
+export async function fetchBmad({ tmpDir, logger }) {
+  logger.debug('Fetching BMAD via npx bmad-method install...')
+
+  const bmadDir = path.join(tmpDir, 'bmad')
+  await fse.ensureDir(bmadDir)
+
+  // BMAD v6 CLI: install --yes --modules bmm,tea --tools claude-code,trae
+  await execFile('npx', [
+    '-y', 'bmad-method@latest', 'install',
+    '--yes',
+    '--directory', bmadDir,
+    '--modules', 'bmm,tea',
+    '--tools', 'claude-code,trae',
+    '--user-name', 'User',
+    '--communication-language', 'English',
+    '--document-output-language', 'English',
+  ], {
+    cwd: bmadDir,
+    timeout: 120_000,
+    shell: process.platform === 'win32',
+  })
+
+  // Extract version from the installed manifest
+  let version = 'unknown'
+  try {
+    const manifestPath = path.join(bmadDir, '_bmad', '_config', 'manifest.yaml')
+    if (await fse.pathExists(manifestPath)) {
+      const content = await fse.readFile(manifestPath, 'utf8')
+      const match = content.match(/version:\s*['"]?([^\s'"]+)/)
+      if (match) version = match[1]
+    }
+  } catch {
+    // Fallback: try package.json in npm cache
+  }
+
+  if (version === 'unknown') {
+    try {
+      const { stdout } = await execFile('npx', ['-y', 'bmad-method@latest', '--version'], {
+        timeout: 30_000,
+        shell: process.platform === 'win32',
+      })
+      version = stdout.trim() || 'unknown'
+    } catch {
+      logger.warn('Could not determine BMAD package version')
+    }
+  }
+
+  logger.debug(`BMAD fetched, version: ${version}`)
+  return { version, dir: bmadDir }
+}
+
+/**
+ * Fetch ECC content by cloning the git repository.
+ *
+ * @param {{ tmpDir: string, logger: object }} opts
+ * @returns {Promise<{ sha: string }>} HEAD commit SHA
+ */
+export async function fetchEcc({ tmpDir, logger }) {
+  const repo = `${ECC_REPO_URL}.git`
+  const eccDir = path.join(tmpDir, 'ecc')
+
+  logger.debug(`Cloning ECC from ${repo}...`)
+
+  await execFile('git', ['clone', '--depth', '1', repo, eccDir], {
+    timeout: 120_000,
+    shell: process.platform === 'win32',
+  })
+
+  // Get HEAD SHA
+  let sha = 'unknown'
+  try {
+    const { stdout } = await execFile('git', ['rev-parse', 'HEAD'], {
+      cwd: eccDir,
+      shell: process.platform === 'win32',
+    })
+    sha = stdout.trim()
+  } catch {
+    logger.warn('Could not determine ECC commit SHA')
+  }
+
+  logger.debug(`ECC cloned, SHA: ${sha}`)
+  return { sha, dir: eccDir }
+}
+
+// ─── Mapping & Copy ─────────────────────────────────────────────────────────
+
+/**
+ * Apply path mappings to copy files from source to destination.
+ *
+ * @param {{
+ *   srcBase: string,
+ *   destBase: string,
+ *   mappings: Array<{ src: string, dest: string, exclude?: string[], filter?: RegExp }>,
+ *   postProcess?: (content: string, relPath: string) => string,
+ *   logger: object
+ * }} opts
+ * @returns {Promise<number>} Total number of files copied
+ */
+export async function applyMappings({ srcBase, destBase, mappings, postProcess, logger }) {
+  let totalFiles = 0
+
+  for (const mapping of mappings) {
+    const srcDir = path.join(srcBase, mapping.src)
+    const destDir = path.join(destBase, mapping.dest)
+
+    if (!await fse.pathExists(srcDir)) {
+      logger.warn(`Source directory not found, skipping: ${mapping.src}`)
+      continue
+    }
+
+    const files = await listFiles(srcDir)
+
+    for (const relPath of files) {
+      const fileName = path.basename(relPath)
+
+      // Apply exclude list
+      if (mapping.exclude && mapping.exclude.includes(fileName)) {
+        logger.debug(`  Excluded: ${mapping.src}/${relPath}`)
+        continue
+      }
+
+      // Apply filename filter (regex must match basename)
+      if (mapping.filter && !mapping.filter.test(fileName)) {
+        continue
+      }
+
+      const srcFile = path.join(srcDir, relPath)
+      const destFile = path.join(destDir, relPath)
+
+      await fse.ensureDir(path.dirname(destFile))
+
+      // Read, optionally post-process, then write
+      const ext = path.extname(relPath).toLowerCase()
+      const isText = TEXT_EXTENSIONS.has(ext)
+
+      if (isText && postProcess) {
+        let content = await fse.readFile(srcFile, 'utf8')
+        const destRelPath = path.join(mapping.dest, relPath).replace(/\\/g, '/')
+        content = postProcess(content, destRelPath)
+        await fse.writeFile(destFile, content, 'utf8')
+      } else {
+        await fse.copy(srcFile, destFile)
+      }
+
+      totalFiles++
+    }
+
+    logger.debug(`  Mapped ${mapping.src} → ${mapping.dest}`)
+  }
+
+  return totalFiles
+}
+
+// ─── Plugin Fetch ───────────────────────────────────────────────────────────
+
+/**
+ * Fetch plugin content by cloning a marketplace GitHub repository.
+ *
+ * @param {{ tmpDir: string, logger: object, registry: object }} opts
+ * @returns {Promise<{ sha: string, dir: string }>} HEAD commit SHA and clone directory
+ */
+export async function fetchPlugins({ tmpDir, logger, registry }) {
+  const upstream = registry.upstream?.plugins
+  if (!upstream?.repo) {
+    throw new Error('No plugins upstream configured in registry.json')
+  }
+
+  const repo = upstream.repo.endsWith('.git') ? upstream.repo : `${upstream.repo}.git`
+  const pluginsDir = path.join(tmpDir, 'plugins')
+
+  logger.debug(`Cloning plugins from ${repo}...`)
+
+  await execFile('git', ['clone', '--depth', '1', repo, pluginsDir], {
+    timeout: 120_000,
+    shell: process.platform === 'win32',
+  })
+
+  // Get HEAD SHA
+  let sha = 'unknown'
+  try {
+    const { stdout } = await execFile('git', ['rev-parse', 'HEAD'], {
+      cwd: pluginsDir,
+      shell: process.platform === 'win32',
+    })
+    sha = stdout.trim()
+  } catch {
+    logger.warn('Could not determine plugins commit SHA')
+  }
+
+  logger.debug(`Plugins cloned, SHA: ${sha}`)
+  return { sha, dir: pluginsDir }
+}
+
+/**
+ * Build path mappings for plugins based on registry.plugins entries.
+ * Each plugin maps from its source directory in the marketplace repo
+ * to its destination in templates/plugins/.
+ *
+ * @param {object} registry - Registry object with plugins section
+ * @returns {Array<{ src: string, dest: string }>} Path mappings
+ */
+export function buildPluginMappings(registry) {
+  const pluginsPath = registry.upstream?.plugins?.pluginsPath || 'plugins'
+  const plugins = registry.plugins || {}
+
+  return Object.keys(plugins).map(id => ({
+    src: `${pluginsPath}/${id}`,
+    dest: `plugins/${id}`,
+  }))
+}
+
+// ─── External Skills Fetch ─────────────────────────────────────────────────
+
+/**
+ * Fetch external skills by cloning each registered repo and extracting
+ * the configured skillPath into a unified output directory.
+ *
+ * Each skill entry in `registry.upstream['ext-skills']` is cloned
+ * independently, allowing skills from different repos to coexist.
+ *
+ * @param {{ tmpDir: string, logger: object, registry: object }} opts
+ * @returns {Promise<{ skills: Record<string, { sha: string }>, dir: string }>}
+ */
+export async function fetchExtSkills({ tmpDir, logger, registry }) {
+  const entries = registry.upstream?.['ext-skills'] || {}
+  const ids = Object.keys(entries)
+
+  if (ids.length === 0) {
+    throw new Error('No ext-skills upstream configured in registry.json')
+  }
+
+  const outputDir = path.join(tmpDir, 'ext-skills')
+  await fse.ensureDir(outputDir)
+
+  const skills = {}
+
+  for (const id of ids) {
+    const entry = entries[id]
+    if (entry.type !== 'git' || !entry.repo) {
+      logger.warn(`ext-skill "${id}" has invalid config, skipping`)
+      continue
+    }
+
+    const repo = entry.repo.endsWith('.git') ? entry.repo : `${entry.repo}.git`
+    const cloneDir = path.join(tmpDir, `ext-skill-${id}`)
+
+    logger.debug(`Cloning ext-skill "${id}" from ${repo}...`)
+
+    await execFile('git', ['clone', '--depth', '1', repo, cloneDir], {
+      timeout: 120_000,
+      shell: process.platform === 'win32',
+    })
+
+    // Get HEAD SHA
+    let sha = 'unknown'
+    try {
+      const { stdout } = await execFile('git', ['rev-parse', 'HEAD'], {
+        cwd: cloneDir,
+        shell: process.platform === 'win32',
+      })
+      sha = stdout.trim()
+    } catch {
+      logger.warn(`Could not determine commit SHA for ext-skill "${id}"`)
+    }
+
+    // Copy skillPath contents to output/<id>/
+    const skillSrc = path.join(cloneDir, entry.skillPath || id)
+    const skillDest = path.join(outputDir, id)
+
+    if (await fse.pathExists(skillSrc)) {
+      await fse.copy(skillSrc, skillDest)
+      logger.debug(`ext-skill "${id}": copied ${entry.skillPath} → ${id}/, SHA: ${sha}`)
+    } else {
+      logger.warn(`ext-skill "${id}": skillPath "${entry.skillPath}" not found in repo`)
+    }
+
+    skills[id] = { sha }
+  }
+
+  return { skills, dir: outputDir }
+}
+
+/**
+ * Build path mappings for external skills based on registry.upstream['ext-skills'].
+ * Each skill maps from its ID subdirectory to templates/ext-skills/<id>.
+ *
+ * @param {object} registry - Registry object
+ * @returns {Array<{ src: string, dest: string }>} Path mappings
+ */
+export function buildExtSkillMappings(registry) {
+  const entries = registry.upstream?.['ext-skills'] || {}
+
+  return Object.keys(entries).map(id => ({
+    src: id,
+    dest: `ext-skills/${id}`,
+  }))
+}
+
+// ─── Temp Directory Helper ──────────────────────────────────────────────────
+
+/**
+ * Create a uniquely-named temporary directory.
+ *
+ * @param {string} prefix - Prefix for the temp directory name
+ * @returns {Promise<string>} Absolute path to the created directory
+ */
+export async function createTempDir(prefix = 'cckit-sync') {
+  return mkdtemp(path.join(os.tmpdir(), `${prefix}-`))
+}

package/src/utils/fs.js

@@ -0,0 +1,50 @@
+import fse from 'fs-extra'
+import path from 'node:path'
+import crypto from 'node:crypto'
+import { glob } from 'glob'
+
+const INTERPOLATE_EXTENSIONS = new Set(['.md', '.yaml', '.yml', '.json', '.csv', '.txt'])
+
+export { INTERPOLATE_EXTENSIONS as TEXT_EXTENSIONS }
+
+export async function copyWithInterpolation(srcDir, destDir, variables) {
+  const files = await listFiles(srcDir)
+  let count = 0
+
+  for (const relPath of files) {
+    const srcFile = path.join(srcDir, relPath)
+    const destFile = path.join(destDir, relPath)
+    const ext = path.extname(relPath).toLowerCase()
+
+    await fse.ensureDir(path.dirname(destFile))
+
+    if (INTERPOLATE_EXTENSIONS.has(ext)) {
+      let content = await fse.readFile(srcFile, 'utf8')
+      content = interpolate(content, variables)
+      await fse.writeFile(destFile, content, 'utf8')
+    } else {
+      await fse.copy(srcFile, destFile)
+    }
+    count++
+  }
+
+  return count
+}
+
+export function interpolate(content, variables) {
+  return content.replace(/\{(\w+)\}/g, (match, key) => {
+    return key in variables ? variables[key] : match
+  })
+}
+
+export async function computeFileHash(filePath) {
+  const content = await fse.readFile(filePath)
+  const hash = crypto.createHash('sha256').update(content).digest('hex')
+  return `sha256:${hash}`
+}
+
+export async function listFiles(dir) {
+  const pattern = '**/*'
+  const files = await glob(pattern, { cwd: dir, nodir: true, dot: true })
+  return files
+}

package/src/utils/logger.js

@@ -0,0 +1,16 @@
+import chalk from 'chalk'
+
+export function createLogger(options = {}) {
+  const { write = (msg) => console.log(msg), debug: debugEnabled = false } = options
+
+  return {
+    info: (msg) => write(msg),
+    success: (msg) => write(chalk.green(`  \u2713 ${msg}`)),
+    error: (msg) => write(chalk.red(`  \u2717 ${msg}`)),
+    warn: (msg) => write(chalk.yellow(`  \u26A0 ${msg}`)),
+    debug: (msg) => { if (debugEnabled) write(chalk.gray(`  [debug] ${msg}`)) },
+    step: (current, total, msg) => write(chalk.blue(`  [${current}/${total}] ${msg}`)),
+    banner: (msg) => write(chalk.bold.green(`\n${msg}\n`)),
+    newline: () => write('')
+  }
+}

package/templates/bmad/_config/agent-manifest.csv

@@ -0,0 +1,12 @@
+name,displayName,title,icon,capabilities,role,identity,communicationStyle,principles,module,path
+"bmad-master","BMad Master","BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator","🧙","runtime resource management, workflow orchestration, task execution, knowledge custodian","Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator","Master-level expert in the BMAD Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. Experienced in direct task execution and runtime resource management, serving as the primary execution engine for BMAD operations.","Direct and comprehensive, refers to himself in the 3rd person. Expert-level communication focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.","- Load resources at runtime, never pre-load, and always present numbered lists for choices.","core","_bmad/core/agents/bmad-master.md"
+"analyst","Mary","Business Analyst","📊","market research, competitive analysis, requirements elicitation, domain expertise","Strategic Business Analyst + Requirements Expert","Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague needs into actionable specs.","Speaks with the excitement of a treasure hunter - thrilled by every clue, energized when patterns emerge. Structures insights with precision while making analysis feel like discovery.","- Channel expert business analysis frameworks: draw upon Porter's Five Forces, SWOT analysis, root cause analysis, and competitive intelligence methodologies to uncover what others miss. Every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence. - Articulate requirements with absolute precision. Ensure all stakeholder voices heard.","bmm","_bmad/bmm/agents/analyst.md"
+"architect","Winston","Architect","🏗️","distributed systems, cloud infrastructure, API design, scalable patterns","System Architect + Technical Design Leader","Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Specializes in scalable patterns and technology selection.","Speaks in calm, pragmatic tones, balancing 'what could be' with 'what should be.'","- Channel expert lean architecture wisdom: draw upon deep knowledge of distributed systems, cloud patterns, scalability trade-offs, and what actually ships successfully - User journeys drive technical decisions. Embrace boring technology for stability. - Design simple solutions that scale when needed. Developer productivity is architecture. Connect every decision to business value and user impact.","bmm","_bmad/bmm/agents/architect.md"
+"dev","Amelia","Developer Agent","💻","story execution, test-driven development, code implementation","Senior Software Engineer","Executes approved stories with strict adherence to story details and team standards and practices.","Ultra-succinct. Speaks in file paths and AC IDs - every statement citable. No fluff, all precision.","- All existing and new tests must pass 100% before story is ready for review - Every task/subtask must be covered by comprehensive unit tests before marking an item complete","bmm","_bmad/bmm/agents/dev.md"
+"pm","John","Product Manager","📋","PRD creation, requirements discovery, stakeholder alignment, user interviews","Product Manager specializing in collaborative PRD creation through user interviews, requirement discovery, and stakeholder alignment.","Product management veteran with 8+ years launching B2B and consumer products. Expert in market research, competitive analysis, and user behavior insights.","Asks 'WHY?' relentlessly like a detective on a case. Direct and data-sharp, cuts through fluff to what actually matters.","- Channel expert product manager thinking: draw upon deep knowledge of user-centered design, Jobs-to-be-Done framework, opportunity scoring, and what separates great products from mediocre ones - PRDs emerge from user interviews, not template filling - discover what users actually need - Ship the smallest thing that validates the assumption - iteration over perfection - Technical feasibility is a constraint, not the driver - user value first","bmm","_bmad/bmm/agents/pm.md"
+"qa","Quinn","QA Engineer","🧪","test automation, API testing, E2E testing, coverage analysis","QA Engineer","Pragmatic test automation engineer focused on rapid test coverage. Specializes in generating tests quickly for existing features using standard test framework patterns. Simpler, more direct approach than the advanced Test Architect module.","Practical and straightforward. Gets tests written fast without overthinking. 'Ship it and iterate' mentality. Focuses on coverage first, optimization later.","Generate API and E2E tests for implemented code Tests should pass on first run","bmm","_bmad/bmm/agents/qa.md"
+"quick-flow-solo-dev","Barry","Quick Flow Solo Dev","🚀","rapid spec creation, lean implementation, minimum ceremony","Elite Full-Stack Developer + Quick Flow Specialist","Barry handles Quick Flow - from tech spec creation through implementation. Minimum ceremony, lean artifacts, ruthless efficiency.","Direct, confident, and implementation-focused. Uses tech slang (e.g., refactor, patch, extract, spike) and gets straight to the point. No fluff, just results. Stays focused on the task at hand.","- Planning and execution are two sides of the same coin. - Specs are for building, not bureaucracy. Code that ships is better than perfect code that doesn't.","bmm","_bmad/bmm/agents/quick-flow-solo-dev.md"
+"sm","Bob","Scrum Master","🏃","sprint planning, story preparation, agile ceremonies, backlog management","Technical Scrum Master + Story Preparation Specialist","Certified Scrum Master with deep technical background. Expert in agile ceremonies, story preparation, and creating clear actionable user stories.","Crisp and checklist-driven. Every word has a purpose, every requirement crystal clear. Zero tolerance for ambiguity.","- I strive to be a servant leader and conduct myself accordingly, helping with any task and offering suggestions - I love to talk about Agile process and theory whenever anyone wants to talk about it","bmm","_bmad/bmm/agents/sm.md"
+"tech-writer","Paige","Technical Writer","📚","documentation, Mermaid diagrams, standards compliance, concept explanation","Technical Documentation Specialist + Knowledge Curator","Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.","Patient educator who explains like teaching a friend. Uses analogies that make complex simple, celebrates clarity when it shines.","- Every Technical Document I touch helps someone accomplish a task. Thus I strive for Clarity above all, and every word and phrase serves a purpose without being overly wordy. - I believe a picture/diagram is worth 1000s of words and will include diagrams over drawn out text. - I understand the intended audience or will clarify with the user so I know when to simplify vs when to be detailed. - I will always strive to follow `_bmad/_memory/tech-writer-sidecar/documentation-standards.md` best practices.","bmm","_bmad/bmm/agents/tech-writer/tech-writer.md"
+"ux-designer","Sally","UX Designer","🎨","user research, interaction design, UI patterns, experience strategy","User Experience Designer + UI Specialist","Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.","Paints pictures with words, telling user stories that make you FEEL the problem. Empathetic advocate with creative storytelling flair.","- Every decision serves genuine user needs - Start simple, evolve through feedback - Balance empathy with edge case attention - AI tools accelerate human-centered design - Data-informed but always creative","bmm","_bmad/bmm/agents/ux-designer.md"
+"tea","Murat","Master Test Architect and Quality Advisor","🧪","","Master Test Architect","Test architect specializing in risk-based testing, fixture architecture, ATDD, API testing, backend services, UI automation, CI/CD governance, and scalable quality gates. Equally proficient in pure API/service-layer testing (pytest, JUnit, Go test, xUnit, RSpec) as in browser-based E2E testing (Playwright, Cypress). Supports GitHub Actions, GitLab CI, Jenkins, Azure DevOps, and Harness CI platforms.","Blends data with gut instinct. 'Strong opinions, weakly held' is their mantra. Speaks in risk calculations and impact assessments.","- Risk-based testing - depth scales with impact - Quality gates backed by data - Tests mirror usage patterns (API, UI, or both) - Flakiness is critical technical debt - Tests first AI implements suite validates - Calculate risk vs value for every testing decision - Prefer lower test levels (unit > integration > E2E) when possible - API tests are first-class citizens, not just UI support","tea","_bmad/tea/agents/tea.md"

package/templates/bmad/_config/agents/bmm-analyst.customize.yaml

@@ -0,0 +1,41 @@
+# Agent Customization
+# Customize any section below - all are optional
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/templates/bmad/_config/agents/bmm-architect.customize.yaml

@@ -0,0 +1,41 @@
+# Agent Customization
+# Customize any section below - all are optional
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/templates/bmad/_config/agents/bmm-dev.customize.yaml

@@ -0,0 +1,41 @@
+# Agent Customization
+# Customize any section below - all are optional
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/templates/bmad/_config/agents/bmm-pm.customize.yaml

@@ -0,0 +1,41 @@
+# Agent Customization
+# Customize any section below - all are optional
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here

package/templates/bmad/_config/agents/bmm-qa.customize.yaml

@@ -0,0 +1,41 @@
+# Agent Customization
+# Customize any section below - all are optional
+
+# Override agent name
+agent:
+  metadata:
+    name: ""
+
+# Replace entire persona (not merged)
+persona:
+  role: ""
+  identity: ""
+  communication_style: ""
+  principles: []
+
+# Add custom critical actions (appended after standard config loading)
+critical_actions: []
+
+# Add persistent memories for the agent
+memories: []
+# Example:
+# memories:
+#   - "User prefers detailed technical explanations"
+#   - "Current project uses React and TypeScript"
+
+# Add custom menu items (appended to base menu)
+# Don't include * prefix or help/exit - auto-injected
+menu: []
+# Example:
+# menu:
+#   - trigger: my-workflow
+#     workflow: "{project-root}/custom/my.yaml"
+#     description: My custom workflow
+
+# Add custom prompts (for action="#id" handlers)
+prompts: []
+# Example:
+# prompts:
+# - id: my-prompt
+#   content: |
+#     Prompt instructions here