agi-farm 1.5.2 → 1.6.0

package/README.md

@@ -36,15 +36,28 @@
 
 ---
 
-## 🆕 What's New in v1.5.0
-
-### 🎯 ECC Integration: Production-Ready AI Coding Framework
+## 🆕 What's New in v1.6.0
+
+### 🎭 Agency-Agents Integration: 59 Specialized Personalities
+- **59 battle-tested agent templates** from [@msitarzewski's Agency-Agents](https://github.com/msitarzewski/agency-agents)
+- **11 specializations**: Engineering, Design, Marketing, Product, PM, Testing, Support, Spatial Computing, Strategy, and more
+- **Production-proven workflows** with 10,000+ lines of personality definitions and code examples
+- **Standout agents**: Agents Orchestrator, Evidence Collector, Reality Checker, Whimsy Injector, Reddit Community Builder
+- **Total library**: **91 agents** (16 AGI Farm + 16 ECC + 59 Agency-Agents)
+- **Zero dependencies** — Pure markdown templates, instantly usable
+- **See:** [Agency-Agents Integration Guide](AGENCY_AGENTS_GUIDE.md)
+
+### 🔄 Enhanced Orchestration Patterns
+- **Pipeline orchestration** for Cooper: PM → Architect → [Dev ↔ QA Loop] → Integration
+- **Quality gate patterns** for Vigil: Evidence Collector + Reality Checker methodologies
+- **4 workflow templates**: Startup MVP, Marketing Campaign, Enterprise Feature, Quality-First teams
+- **Automated update system** for keeping Agency-Agents templates current
+- **See:** [Orchestration Patterns](templates/ORCHESTRATION_PATTERNS.md) | [Quality Gates](templates/QUALITY_GATE_PATTERNS.md) | [Workflow Templates](templates/WORKFLOW_TEMPLATES.md)
+
+### Previous: ECC Integration v1.5.0
 - **69 specialized skills** from Everything Claude Code (Anthropic hackathon winner)
 - **16 ECC agent templates** for domain-specific delegation
 - **33 slash commands** for common workflows
-- **Auto-applied resources** based on agent roles (Sage → @architect, Forge → @tdd-workflow, Vigil → @security-scan)
-- **Zero configuration** — ECC resources automatically injected into SOUL.md files
-- **Framework support** — Python, Django, Spring Boot, Go, Swift, PostgreSQL patterns included
 - **TDD & Security-First** — 80%+ test coverage enforced, comprehensive security scans
 - **See:** [ECC Integration Guide](docs/ECC_INTEGRATION_GUIDE.md)
 
@@ -739,24 +752,51 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## 🙏 Acknowledgments
 
-This plugin integrates production-ready AI coding resources from the following projects:
+This plugin integrates production-ready AI resources from the following exceptional projects:
+
+### Agency-Agents (NEW in v1.6.0)
+- **Repository**: https://github.com/msitarzewski/agency-agents
+- **Author**: [@msitarzewski](https://github.com/msitarzewski)
+- **Achievement**: 50+ requests in first 12 hours on Reddit, months of production iteration
+- **Integration**: 59 specialized agent personalities across 11 categories
+- **Impact**: Battle-tested workflows for Engineering, Design, Marketing, Product, PM, Testing, Support, Spatial Computing, and Strategy
+
+The Agency-Agents collection dramatically expands AGI Farm's agent library with proven personalities including:
+- **Agents Orchestrator** - Meta-agent for pipeline management (PM → Architect → Dev-QA Loop → Integration)
+- **Evidence Collector** - Screenshot-based QA (defaults to finding 3-5 issues minimum)
+- **Reality Checker** - Production readiness certification (defaults to "NEEDS WORK")
+- **Whimsy Injector** - Delightful UX enhancements that serve functional or emotional purpose
+- **Reddit Community Builder** - Authentic community engagement patterns
+
+**Special thanks to @msitarzewski for creating and sharing these exceptional agent personalities with the community.**
 
 ### Everything Claude Code (ECC)
 - **Repository**: https://github.com/affaan-m/everything-claude-code
 - **Author**: [@affaan-m](https://github.com/affaan-m)
 - **Achievement**: Winner of Anthropic's Claude Code hackathon
-- **Integration**: 194 resource files (16 agents, 69 skills, 33 commands, 7 guides)
+- **Integration**: 510 resource files (16 agents, 69 skills, 33 commands, 7 guides)
 - **Impact**: Industry-standard TDD workflows, security scans, API design patterns, and framework templates for Python/Django/Spring Boot/Go/Swift/PostgreSQL
 
 The ECC framework provides the foundation for AGI Farm's production-ready coding capabilities, including:
 - Test-driven development workflows with 80%+ coverage enforcement
-- Comprehensive security scanning and vulnerability detection
+- Comprehensive security scanning and vulnerability detection (via AgentShield)
 - API design patterns and best practices
 - Framework-specific templates and conventions
 - Auto-delegation based on agent roles
 
 **Special thanks to @affaan-m for creating and open-sourcing this exceptional framework.**
 
+### Combined Impact
+
+**Total Integrated Resources**:
+- **91 agent templates** (16 AGI Farm + 16 ECC + 59 Agency-Agents)
+- **69 production skills** (ECC)
+- **33 slash commands** (ECC)
+- **7 quality automation hooks** (AGI Farm)
+- **10,000+ lines** of agent personalities and workflows
+
+AGI Farm is proud to stand on the shoulders of these giants, combining the best of community-driven AI agent development into a single, cohesive plugin.
+
 ---
 
 ## 📝 License

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "agi-farm",
   "kind": "team-orchestration",
   "name": "AGI Farm — Multi-Agent Team Builder",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "Bootstrap complete multi-agent AI teams with auto-dispatcher, live dashboard, and infrastructure. Includes interactive wizard, SOUL.md generation, comms setup, cron registration, and React + SSE ops room.",
   "author": "oabdelmaksoud",
   "homepage": "https://github.com/oabdelmaksoud/AGI-FARM-PLUGIN",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agi-farm",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "Multi-agent AI team builder for OpenClaw — bootstrap complete teams with auto-dispatcher, dashboard, and infrastructure",
   "main": "dist/index.js",
   "type": "module",

package/scripts/convert-agency-agent.js

@@ -0,0 +1,319 @@
+#!/usr/bin/env node
+
+/**
+ * Agency-Agents to SOUL.md Converter
+ *
+ * Converts agency-agents markdown files to AGI Farm SOUL.md format.
+ *
+ * Usage:
+ *   node scripts/convert-agency-agent.js <input-file> <output-file>
+ *   node scripts/convert-agency-agent.js --batch <agency-agents-dir> <templates-dir>
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Category mapping for AGI Farm
+const CATEGORY_MAP = {
+  'engineering': 'engineering',
+  'design': 'design',
+  'marketing': 'marketing',
+  'product': 'product',
+  'project-management': 'project-management',
+  'testing': 'quality-assurance',
+  'support': 'support',
+  'spatial-computing': 'specialized',
+  'specialized': 'specialized',
+  'strategy': 'leadership',
+};
+
+// Role mapping for AGI Farm
+const ROLE_MAP = {
+  'engineering-frontend-developer': 'frontend-developer',
+  'engineering-backend-architect': 'backend-architect',
+  'engineering-mobile-app-builder': 'mobile-developer',
+  'engineering-ai-engineer': 'ai-engineer',
+  'engineering-devops-automator': 'devops-engineer',
+  'engineering-rapid-prototyper': 'prototyper',
+  'engineering-senior-developer': 'senior-developer',
+  'design-ui-designer': 'ui-designer',
+  'design-ux-researcher': 'ux-researcher',
+  'design-ux-architect': 'ux-architect',
+  'design-brand-guardian': 'brand-manager',
+  'design-visual-storyteller': 'visual-designer',
+  'design-whimsy-injector': 'ux-enhancer',
+  'design-image-prompt-engineer': 'image-engineer',
+  'marketing-growth-hacker': 'growth-hacker',
+  'marketing-content-creator': 'content-creator',
+  'marketing-twitter-engager': 'social-media-manager',
+  'marketing-tiktok-strategist': 'tiktok-specialist',
+  'marketing-instagram-curator': 'instagram-specialist',
+  'marketing-reddit-community-builder': 'community-manager',
+  'marketing-app-store-optimizer': 'aso-specialist',
+  'marketing-social-media-strategist': 'social-strategist',
+  'product-sprint-prioritizer': 'product-manager',
+  'product-trend-researcher': 'market-researcher',
+  'product-feedback-synthesizer': 'user-researcher',
+  'project-management-studio-producer': 'studio-producer',
+  'project-management-project-shepherd': 'project-coordinator',
+  'project-manager-senior': 'senior-pm',
+  'project-management-studio-operations': 'operations-manager',
+  'project-management-experiment-tracker': 'experiment-manager',
+  'testing-evidence-collector': 'qa-engineer',
+  'testing-reality-checker': 'qa-lead',
+  'testing-test-results-analyzer': 'test-analyst',
+  'testing-performance-benchmarker': 'performance-engineer',
+  'testing-api-tester': 'api-tester',
+  'testing-tool-evaluator': 'tech-evaluator',
+  'testing-workflow-optimizer': 'process-engineer',
+  'support-support-responder': 'support-engineer',
+  'support-analytics-reporter': 'data-analyst',
+  'support-finance-tracker': 'finance-analyst',
+  'support-infrastructure-maintainer': 'infrastructure-engineer',
+  'support-legal-compliance-checker': 'compliance-officer',
+  'support-executive-summary-generator': 'executive-assistant',
+  'specialized-agents-orchestrator': 'orchestrator',
+  'specialized-data-analytics-reporter': 'business-analyst',
+  'specialized-lsp-index-engineer': 'tooling-engineer',
+  'specialized-sales-data-extraction-agent': 'data-extraction-specialist',
+  'specialized-data-consolidation-agent': 'data-consolidation-specialist',
+  'specialized-report-distribution-agent': 'reporting-specialist',
+  'specialized-agentic-identity-trust': 'identity-specialist',
+};
+
+/**
+ * Parse frontmatter from markdown
+ */
+function parseFrontmatter(content) {
+  const frontmatterRegex = /^---\n([\s\S]*?)\n---\n/;
+  const match = content.match(frontmatterRegex);
+
+  if (!match) {
+    return { frontmatter: {}, content };
+  }
+
+  const frontmatterText = match[1];
+  const frontmatter = {};
+
+  frontmatterText.split('\n').forEach(line => {
+    const [key, ...valueParts] = line.split(':');
+    if (key && valueParts.length > 0) {
+      frontmatter[key.trim()] = valueParts.join(':').trim();
+    }
+  });
+
+  const remainingContent = content.replace(frontmatterRegex, '');
+  return { frontmatter, content: remainingContent };
+}
+
+/**
+ * Convert agency-agent markdown to SOUL.md format
+ */
+function convertToSoulMd(agentContent, filename, category) {
+  const { frontmatter, content } = parseFrontmatter(agentContent);
+
+  const agentName = frontmatter.name || 'Unknown Agent';
+  const description = frontmatter.description || '';
+  const color = frontmatter.color || 'cyan';
+
+  // Determine role from filename
+  const baseFilename = path.basename(filename, '.md');
+  const role = ROLE_MAP[baseFilename] || baseFilename;
+  const agiFarmCategory = CATEGORY_MAP[category] || 'specialized';
+
+  // Build SOUL.md content
+  let soulContent = `# ${agentName}
+
+**Role**: ${role}
+**Category**: ${agiFarmCategory}
+**Source**: Agency-Agents by [@msitarzewski](https://github.com/msitarzewski/agency-agents)
+
+## Overview
+
+${description}
+
+---
+
+${content}
+
+---
+
+## 🔗 Attribution
+
+This agent personality is from the **Agency-Agents** repository by [@msitarzewski](https://github.com/msitarzewski).
+
+**Original Repository**: https://github.com/msitarzewski/agency-agents
+**License**: MIT License
+**Adapted for**: AGI Farm Plugin
+
+## 🎯 Integration Notes
+
+This agent has been converted from Agency-Agents format to AGI Farm SOUL.md format.
+
+**Conversion Details**:
+- Original file: \`${category}/${filename}\`
+- AGI Farm role: \`${role}\`
+- AGI Farm category: \`${agiFarmCategory}\`
+- Color theme: \`${color}\`
+
+**Usage in AGI Farm**:
+\`\`\`bash
+# Create an agent with this personality
+agi-farm setup
+# → Select "Agency-Agents Library"
+# → Choose "${agentName}"
+
+# Or use directly in workspace
+cp templates/agency-agents/${category}/${filename} \\
+   ~/.openclaw/workspace/agents-workspaces/<agent-name>/SOUL.md
+\`\`\`
+
+**Customization**: Feel free to adapt this personality for your specific needs. The original Agency-Agents template provides a strong foundation.
+`;
+
+  return soulContent;
+}
+
+/**
+ * Convert a single agent file
+ */
+async function convertSingleAgent(inputFile, outputFile) {
+  try {
+    console.log(`Converting ${inputFile} → ${outputFile}`);
+
+    const content = await fs.readFile(inputFile, 'utf-8');
+    const category = path.basename(path.dirname(inputFile));
+    const filename = path.basename(inputFile);
+
+    const soulMd = convertToSoulMd(content, filename, category);
+
+    await fs.mkdir(path.dirname(outputFile), { recursive: true });
+    await fs.writeFile(outputFile, soulMd, 'utf-8');
+
+    console.log(`✅ Converted: ${outputFile}`);
+  } catch (error) {
+    console.error(`❌ Error converting ${inputFile}:`, error.message);
+    throw error;
+  }
+}
+
+/**
+ * Batch convert all agents from a directory
+ */
+async function batchConvert(agencyAgentsDir, templatesDir) {
+  console.log(`\n🚀 Batch Converting Agency-Agents\n`);
+  console.log(`Source: ${agencyAgentsDir}`);
+  console.log(`Target: ${templatesDir}\n`);
+
+  const categories = Object.keys(CATEGORY_MAP);
+  let totalConverted = 0;
+  let errors = 0;
+
+  for (const category of categories) {
+    const categoryDir = path.join(agencyAgentsDir, category);
+
+    try {
+      const files = await fs.readdir(categoryDir);
+      const mdFiles = files.filter(f => f.endsWith('.md'));
+
+      console.log(`\n📂 Category: ${category} (${mdFiles.length} agents)`);
+
+      for (const file of mdFiles) {
+        const inputFile = path.join(categoryDir, file);
+        const outputDir = path.join(templatesDir, category);
+        const outputFile = path.join(outputDir, file);
+
+        try {
+          await convertSingleAgent(inputFile, outputFile);
+          totalConverted++;
+        } catch (error) {
+          console.error(`  ❌ Failed: ${file}`);
+          errors++;
+        }
+      }
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        console.log(`  ⚠️  Category directory not found: ${category}`);
+      } else {
+        console.error(`  ❌ Error processing category ${category}:`, error.message);
+        errors++;
+      }
+    }
+  }
+
+  console.log(`\n\n✨ Batch Conversion Complete\n`);
+  console.log(`Total Converted: ${totalConverted}`);
+  console.log(`Errors: ${errors}`);
+  console.log(`\nTemplates created in: ${templatesDir}\n`);
+
+  return { totalConverted, errors };
+}
+
+/**
+ * Main CLI
+ */
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args[0] === '--help') {
+    console.log(`
+Agency-Agents to SOUL.md Converter
+
+Usage:
+  Single file conversion:
+    node scripts/convert-agency-agent.js <input-file> <output-file>
+
+  Batch conversion:
+    node scripts/convert-agency-agent.js --batch <agency-agents-dir> <templates-dir>
+
+Examples:
+  # Convert single agent
+  node scripts/convert-agency-agent.js \\
+    /tmp/agency-agents-review/engineering/engineering-frontend-developer.md \\
+    templates/agency-agents/engineering/engineering-frontend-developer.md
+
+  # Batch convert all agents
+  node scripts/convert-agency-agent.js --batch \\
+    /tmp/agency-agents-review \\
+    templates/agency-agents
+`);
+    process.exit(0);
+  }
+
+  if (args[0] === '--batch') {
+    if (args.length < 3) {
+      console.error('Error: --batch requires <agency-agents-dir> <templates-dir>');
+      process.exit(1);
+    }
+
+    const agencyAgentsDir = path.resolve(args[1]);
+    const templatesDir = path.resolve(args[2]);
+
+    const { totalConverted, errors } = await batchConvert(agencyAgentsDir, templatesDir);
+    process.exit(errors > 0 ? 1 : 0);
+  } else {
+    if (args.length < 2) {
+      console.error('Error: Single conversion requires <input-file> <output-file>');
+      process.exit(1);
+    }
+
+    const inputFile = path.resolve(args[0]);
+    const outputFile = path.resolve(args[1]);
+
+    await convertSingleAgent(inputFile, outputFile);
+  }
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+  });
+}
+
+export { convertToSoulMd, convertSingleAgent, batchConvert };

package/scripts/update-agency-agents.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+/**
+ * Agency-Agents Update Script
+ *
+ * Automatically checks for and applies updates from the Agency-Agents repository.
+ *
+ * Usage:
+ *   node scripts/update-agency-agents.js           # Check and apply updates
+ *   node scripts/update-agency-agents.js --dry-run # Check only, don't apply
+ *   node scripts/update-agency-agents.js --force   # Force update even if no changes
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PLUGIN_ROOT = path.resolve(__dirname, '..');
+const TEMPLATES_DIR = path.join(PLUGIN_ROOT, 'templates', 'agency-agents');
+const VERSION_FILE = path.join(PLUGIN_ROOT, 'agency-agents-resources', 'AGENCY_VERSION');
+const TEMP_DIR = '/tmp/agency-agents-update';
+const REPO_URL = 'https://github.com/msitarzewski/agency-agents.git';
+
+// Parse CLI arguments
+const args = process.argv.slice(2);
+const isDryRun = args.includes('--dry-run');
+const isForce = args.includes('--force');
+
+/**
+ * Get current version from VERSION_FILE
+ */
+async function getCurrentVersion() {
+  try {
+    const content = await fs.readFile(VERSION_FILE, 'utf-8');
+    const match = content.match(/COMMIT:\s*([a-f0-9]+)/);
+    return match ? match[1] : null;
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Clone or update Agency-Agents repository
+ */
+async function cloneOrUpdateRepo() {
+  console.log(chalk.cyan('\n📥 Fetching Agency-Agents repository...\n'));
+
+  try {
+    // Remove old temp directory
+    try {
+      await fs.rm(TEMP_DIR, { recursive: true, force: true });
+    } catch {}
+
+    // Clone fresh copy
+    execSync(`git clone ${REPO_URL} ${TEMP_DIR}`, {
+      stdio: 'inherit',
+    });
+
+    // Get latest commit
+    const commit = execSync('git rev-parse HEAD', {
+      cwd: TEMP_DIR,
+      encoding: 'utf-8',
+    }).trim();
+
+    const commitDate = execSync('git log -1 --format=%cd --date=short', {
+      cwd: TEMP_DIR,
+      encoding: 'utf-8',
+    }).trim();
+
+    return { commit, commitDate };
+  } catch (error) {
+    console.error(chalk.red('❌ Failed to clone repository:'), error.message);
+    process.exit(1);
+  }
+}
+
+/**
+ * Compare versions
+ */
+async function compareVersions(currentCommit, latestCommit) {
+  if (!currentCommit) {
+    console.log(chalk.yellow('⚠️  No version file found - this appears to be a first-time setup'));
+    return { hasUpdates: true, isFirstTime: true };
+  }
+
+  if (currentCommit === latestCommit) {
+    console.log(chalk.green('✅ Already up to date!'));
+    console.log(chalk.dim(`   Current: ${currentCommit.substring(0, 7)}`));
+    return { hasUpdates: false, isFirstTime: false };
+  }
+
+  console.log(chalk.yellow('📊 Updates available:'));
+  console.log(chalk.dim(`   Current:  ${currentCommit.substring(0, 7)}`));
+  console.log(chalk.dim(`   Latest:   ${latestCommit.substring(0, 7)}`));
+
+  // Show commits between versions
+  try {
+    const commits = execSync(
+      `git log --oneline ${currentCommit}..${latestCommit}`,
+      { cwd: TEMP_DIR, encoding: 'utf-8' }
+    ).trim();
+
+    if (commits) {
+      console.log(chalk.cyan('\n📝 Changes since last update:\n'));
+      commits.split('\n').forEach(line => {
+        console.log(chalk.dim(`   ${line}`));
+      });
+    }
+  } catch (error) {
+    console.log(chalk.dim('   (Unable to fetch commit history)'));
+  }
+
+  return { hasUpdates: true, isFirstTime: false };
+}
+
+/**
+ * Run conversion script
+ */
+async function runConversion() {
+  console.log(chalk.cyan('\n🔄 Converting agent templates...\n'));
+
+  try {
+    const conversionScript = path.join(__dirname, 'convert-agency-agent.js');
+    execSync(
+      `node "${conversionScript}" --batch "${TEMP_DIR}" "${TEMPLATES_DIR}"`,
+      { stdio: 'inherit' }
+    );
+    return true;
+  } catch (error) {
+    console.error(chalk.red('❌ Conversion failed:'), error.message);
+    return false;
+  }
+}
+
+/**
+ * Update version file
+ */
+async function updateVersionFile(commit, commitDate) {
+  const versionContent = `# Agency-Agents Version Tracking
+#
+# This file tracks which version of the Agency-Agents repository
+# was last integrated into AGI Farm.
+
+REPOSITORY: https://github.com/msitarzewski/agency-agents
+COMMIT: ${commit}
+DATE: ${commitDate}
+UPDATED: ${new Date().toISOString()}
+
+# To update to latest version:
+#   node scripts/update-agency-agents.js
+#
+# To check for updates without applying:
+#   node scripts/update-agency-agents.js --dry-run
+`;
+
+  try {
+    await fs.mkdir(path.dirname(VERSION_FILE), { recursive: true });
+    await fs.writeFile(VERSION_FILE, versionContent, 'utf-8');
+    console.log(chalk.green(`\n✅ Updated version file: ${commit.substring(0, 7)}`));
+  } catch (error) {
+    console.error(chalk.red('❌ Failed to update version file:'), error.message);
+  }
+}
+
+/**
+ * Main update process
+ */
+async function main() {
+  console.log(chalk.bold.cyan('\n🎭 Agency-Agents Update Script\n'));
+
+  if (isDryRun) {
+    console.log(chalk.yellow('🔍 DRY RUN MODE - No changes will be applied\n'));
+  }
+
+  // Step 1: Get current version
+  const currentCommit = await getCurrentVersion();
+  if (currentCommit) {
+    console.log(chalk.dim(`Current version: ${currentCommit.substring(0, 7)}\n`));
+  }
+
+  // Step 2: Clone/update repository
+  const { commit: latestCommit, commitDate } = await cloneOrUpdateRepo();
+
+  // Step 3: Compare versions
+  const { hasUpdates, isFirstTime } = await compareVersions(currentCommit, latestCommit);
+
+  if (!hasUpdates && !isForce) {
+    console.log(chalk.green('\n✨ No updates needed!\n'));
+    return;
+  }
+
+  if (isForce) {
+    console.log(chalk.yellow('\n⚠️  FORCE mode - updating anyway\n'));
+  }
+
+  if (isDryRun) {
+    console.log(chalk.yellow('\n🔍 DRY RUN - Would have updated to:'));
+    console.log(chalk.dim(`   Commit: ${latestCommit.substring(0, 7)}`));
+    console.log(chalk.dim(`   Date: ${commitDate}`));
+    console.log(chalk.yellow('\nRun without --dry-run to apply updates.\n'));
+    return;
+  }
+
+  // Step 4: Run conversion
+  const success = await runConversion();
+
+  if (!success) {
+    console.error(chalk.red('\n❌ Update failed during conversion\n'));
+    process.exit(1);
+  }
+
+  // Step 5: Update version file
+  await updateVersionFile(latestCommit, commitDate);
+
+  // Step 6: Show summary
+  console.log(chalk.green.bold('\n✅ Update Complete!\n'));
+  console.log(chalk.white('Next steps:'));
+  console.log(chalk.dim('   1. Review changes: git status'));
+  console.log(chalk.dim('   2. Test converted templates'));
+  console.log(chalk.dim('   3. Commit: git add . && git commit -m "chore: Update Agency-Agents templates"'));
+  console.log(chalk.dim('   4. Push: git push origin main\n'));
+
+  // Cleanup
+  try {
+    await fs.rm(TEMP_DIR, { recursive: true, force: true });
+  } catch {}
+}
+
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(error => {
+    console.error(chalk.red('\n💥 Fatal error:'), error);
+    process.exit(1);
+  });
+}
+
+export { main };