expxagents 0.2.1 → 0.3.0

package/dist/cli/src/commands/init.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import crypto from 'crypto';
-import { getTemplateDir } from '../utils/config.js';
+import { getTemplateDir, getAssetsDir } from '../utils/config.js';
 function getDefaultTemplate(file) {
     if (file === 'company.md') {
         return `<!-- NOT CONFIGURED -->
@@ -61,6 +61,171 @@ function getDefaultTemplate(file) {
     }
     return '';
 }
+/**
+ * Recursively copy a directory, skipping .DS_Store files.
+ */
+function copyDirRecursive(src, dest) {
+    if (!fs.existsSync(src))
+        return;
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        if (entry.name === '.DS_Store')
+            continue;
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+const SKILL_MD = `---
+name: expxagents
+description: "ExpxAgents \u2014 Multi-agent orchestration platform. Create and run AI squads with 93 specialized agents across 16 sectors."
+---
+
+# ExpxAgents \u2014 Multi-Agent Orchestration
+
+You are now operating as the ExpxAgents system. Your primary role is to help users create, manage, and run AI agent squads.
+
+## Initialization
+
+On activation, perform these steps IN ORDER:
+
+1. Read the company context: \`_expxagents/_memory/company.md\`
+2. Read preferences: \`_expxagents/_memory/preferences.md\`
+3. If company.md contains \`<!-- NOT CONFIGURED -->\` \u2192 trigger ONBOARDING
+4. Otherwise \u2192 display MAIN MENU
+
+## Onboarding Flow (first time only)
+
+If company.md is not configured:
+
+1. Welcome the user to ExpxAgents
+2. Ask their name and preferred language
+3. Ask company name, website URL, sector, description
+4. If URL provided, use WebFetch + WebSearch to research the company
+5. Present findings for confirmation
+6. Save to \`_expxagents/_memory/company.md\` and \`_expxagents/_memory/preferences.md\`
+7. Show main menu
+
+## Main Menu
+
+Present using AskUserQuestion with 2-4 options:
+
+**Primary menu:**
+- **Create a new squad** \u2014 Describe what you need and I'll design a squad
+- **Run a squad** \u2014 Execute an existing squad's pipeline
+- **My squads** \u2014 List, edit, or delete squads
+- **More options** \u2014 Skills, company profile, settings
+
+**More options submenu:**
+- **Skills** \u2014 Browse, install, or create skills
+- **Company profile** \u2014 View or edit company info
+- **Settings** \u2014 Language, IDE, preferences
+
+## Command Routing
+
+| Command | Action |
+|---------|--------|
+| \`/expxagents\` | Show main menu |
+| \`/expxagents create [description]\` | Load Solution Architect \u2192 Design squad |
+| \`/expxagents run <name>\` | Load Release Manager \u2192 Execute pipeline |
+| \`/expxagents list\` | List squads from \`squads/\` directory |
+| \`/expxagents edit <name>\` | Load Solution Architect \u2192 Edit mode |
+| \`/expxagents skills\` | Load Skills Engine \u2192 Show menu |
+| \`/expxagents install <name>\` | Install skill from catalog |
+| \`/expxagents uninstall <name>\` | Remove installed skill |
+| \`/expxagents delete <name>\` | Confirm and delete squad |
+| \`/expxagents dashboard\` | Start server + open dashboard |
+| \`/expxagents help\` | Show help text |
+
+## Loading Agents
+
+When a core agent needs to be activated:
+
+1. **Solution Architect:** Read \`_expxagents/core/solution-architect.agent.md\`
+2. **Release Manager:** Read \`_expxagents/core/runner.pipeline.md\`
+3. **Skills Engine:** Read \`_expxagents/core/skills.engine.md\`
+4. **Insight Hunter:** Read \`_expxagents/core/prompts/insight-hunter.prompt.md\`
+
+Adopt the agent's persona and follow its instructions completely.
+
+## Agent Catalog
+
+The full agent catalog is at \`agents/_catalog.yaml\`. Read it to see all available agents organized by sector:
+
+- **Core (4):** solution-architect, release-manager, platform-engineer, insight-hunter
+- **Development (18):** tech-lead, qa-engineer, devops-engineer, code-reviewer, backend-developer, frontend-developer, ux-design-expert, product-manager, ux-designer, business-analyst, scrum-master, dba, security-analyst, tech-writer, desktop-developer, ios-developer, android-developer, cross-platform-mobile
+- **Implantation (5):** deployment-manager, environment-specialist, migration-specialist, integration-specialist, go-live-coordinator
+- **Support (5):** l1-support, l2-support, l3-support, knowledge-base-manager, sla-monitor
+- **Training (4):** training-designer, onboarding-coach, assessment-creator, workshop-facilitator
+- **Finance (4):** billing-analyst, financial-controller, accounts-manager, budget-planner
+- **HR (6):** recruiter, interview-coordinator, hr-onboarding, performance-analyst, benefits-manager, people-culture
+- **Customer Success (5):** csm, churn-prevention, expansion-manager, nps-analyst, renewal-manager
+- **Administrative (4):** procurement-specialist, document-controller, office-manager, process-documentation-officer
+- **Marketing (8):** content-creator, seo-specialist, social-media-manager, email-marketing, paid-ads-manager, marketing-analyst, brand-guardian, landing-page-builder
+- **Commercial (5):** sdr, account-executive, proposal-writer, crm-manager, pricing-strategist
+- **R&D (5):** market-researcher, innovation-scout, prototype-builder, benchmark-analyst, product-analyst
+- **Board (6):** strategic-advisor, okr-manager, board-report-writer, risk-analyst, governance-officer, business-intelligence
+- **Accounting (6):** accountant, tax-compliance, fiscal-analyst, payroll-specialist, audit-analyst, financial-reporting
+- **Legal (4):** contract-manager, legal-counsel, ip-specialist, labor-attorney
+- **Compliance (4):** compliance-officer, data-privacy-specialist, regulatory-monitor, internal-auditor
+
+When creating squads, use these agent templates as base for squad agents.
+
+## Best Practices
+
+Best-practice guides are at \`_expxagents/core/best-practices/\`. Read the catalog at \`_expxagents/core/best-practices/_catalog.yaml\` for available formats (landing-page, blog-post, email-sales, etc.).
+
+## Running a Squad
+
+1. Read \`squads/<name>/squad.yaml\`
+2. Read \`squads/<name>/squad-party.csv\` (if exists)
+3. Load company context from \`_expxagents/_memory/company.md\`
+4. Load squad memory from \`squads/<name>/_memory/memories.md\`
+5. Read runner instructions from \`_expxagents/core/runner.pipeline.md\`
+6. Execute pipeline step by step
+
+## Language
+
+- Read preferences for user's language
+- All output in user's language
+- File names and code in English
+
+## Help Text
+
+\`\`\`
+ExpxAgents \u2014 Multi-Agent Orchestration
+
+SQUADS
+  /expxagents create       Design a new squad
+  /expxagents run <name>   Execute a squad pipeline
+  /expxagents list         List all squads
+  /expxagents edit <name>  Modify a squad
+  /expxagents delete <name> Delete a squad
+
+SKILLS
+  /expxagents skills       Browse skills
+  /expxagents install      Install a skill
+  /expxagents uninstall    Remove a skill
+
+SETTINGS
+  /expxagents dashboard    Open virtual office
+  /expxagents help         Show this help
+\`\`\`
+
+## Critical Rules
+
+- NEVER skip onboarding if company.md is not configured
+- ALWAYS load company context before squad operations
+- ALWAYS present checkpoints to user \u2014 never skip them
+- ALWAYS save outputs and update squad memories
+- When switching agent personas, indicate who is speaking
+- AskUserQuestion must always have 2-4 options
+`;
 export async function initCommand() {
     const cwd = process.cwd();
     console.log('Initializing ExpxAgents project...\n');
@@ -102,6 +267,38 @@ export async function initCommand() {
             console.log(`  _expxagents/_memory/${file} already exists`);
         }
     }
+    // Copy core agents from package assets
+    const assetsDir = getAssetsDir();
+    const coreSrc = path.join(assetsDir, 'core');
+    const coreDest = path.join(cwd, '_expxagents', 'core');
+    if (!fs.existsSync(coreDest)) {
+        copyDirRecursive(coreSrc, coreDest);
+        console.log('  Copied _expxagents/core/ (core agents + best practices)');
+    }
+    else {
+        console.log('  _expxagents/core/ already exists');
+    }
+    // Copy agent catalog from package assets
+    const agentsSrc = path.join(assetsDir, 'agents');
+    const agentsDest = path.join(cwd, 'agents');
+    if (!fs.existsSync(agentsDest)) {
+        copyDirRecursive(agentsSrc, agentsDest);
+        console.log('  Copied agents/ (93 agent templates across 16 sectors)');
+    }
+    else {
+        console.log('  agents/ already exists');
+    }
+    // Create Claude Code skill (.claude/skills/expxagents/SKILL.md)
+    const skillDir = path.join(cwd, '.claude', 'skills', 'expxagents');
+    const skillPath = path.join(skillDir, 'SKILL.md');
+    if (!fs.existsSync(skillPath)) {
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(skillPath, SKILL_MD, 'utf-8');
+        console.log('  Created .claude/skills/expxagents/SKILL.md (enables /expxagents command)');
+    }
+    else {
+        console.log('  .claude/skills/expxagents/SKILL.md already exists');
+    }
     // Create squads/_memory/ subdirectory
     const squadsMemoryDir = path.join(cwd, 'squads', '_memory');
     if (!fs.existsSync(squadsMemoryDir)) {
@@ -161,4 +358,5 @@ BRIDGE_TIMEOUT_MS=300000
         console.log('  Created .gitignore');
     }
     console.log('\nProject initialized! Run `expxagents onboarding` to configure your profile.');
+    console.log('Use /expxagents in Claude Code to get started.');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expxagents",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Multi-agent orchestration platform for AI squads",
   "author": "ExpxAgents",
   "license": "MIT",