@defai.digital/automatosx 5.6.13 → 5.6.14

package/CHANGELOG.md

@@ -2,6 +2,81 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [5.6.14](https://github.com/defai-digital/automatosx/compare/v5.6.13...v5.6.14) (2025-10-22)
+
+### New Features - Claude Code Integration Enhancement
+
+* **feat(init):** Automatic CLAUDE.md generation with AutomatosX integration guide 📖 NEW
+  - **Problem Solved**: Claude Code didn't know how to use AutomatosX agents in new projects
+  - **Solution**: `ax init` now automatically creates/updates project CLAUDE.md with comprehensive integration guide
+  - **File**: `examples/claude/CLAUDE_INTEGRATION.md` - Complete AutomatosX usage template
+  - **Features**:
+    - Natural language examples: "Please work with ax agent backend to implement authentication"
+    - Slash command examples: `/ax-agent backend, create REST API`
+    - Complete agent directory (24 specialized agents)
+    - Memory system explanation
+    - Multi-agent collaboration examples
+    - Configuration guide
+    - Troubleshooting tips
+  - **Smart Update Behavior**:
+    - New projects: Creates full CLAUDE.md with AutomatosX integration
+    - Existing CLAUDE.md: Appends AutomatosX section without overwriting user content
+    - Force mode (`--force`): Updates existing AutomatosX section
+  - **Impact**: Claude Code now automatically understands how to work with AutomatosX agents in every project
+  - **Files Changed**:
+    - `src/cli/commands/init.ts` - Added `setupProjectClaudeMd()` function
+    - `examples/claude/CLAUDE_INTEGRATION.md` - New integration template (370 lines)
+
+### Documentation Updates
+
+* **docs(quick-start):** Updated Quick Start guide to v5.6.13 specifications
+  - Updated version references: 5.1.0 → 5.6.13
+  - Updated agent count: 12 → 24 specialized agents
+  - Updated ability count: 15 → 56 abilities
+  - Updated team count: 4 → 5 teams
+  - Added new directory structure (templates, .claude, CLAUDE.md)
+  - Added router health check output example
+  - Updated expected output examples
+
+* **docs(claude-md):** Updated CLAUDE.md with v5.6.13 performance improvements
+  - Fixed test timeout documentation: 30s → 60s
+  - Expanded core modules documentation with v5.6.13 additions
+  - Added cache-warmer, adaptive-cache, db-connection-pool modules
+
+### Developer Experience
+
+* **Before this release**:
+  ```
+  User: "Please use ax agent to help me"
+  Claude Code: "I don't have AutomatosX agent. I'll use my Task tool instead..."
+  ```
+
+* **After this release**:
+  ```bash
+  cd new-project
+  ax init
+  # → Creates CLAUDE.md with AutomatosX integration guide
+
+  # Now in Claude Code:
+  User: "Please work with ax agent backend to implement auth API"
+  Claude Code: "I'll execute: ax run backend 'implement auth API'" ✅
+  ```
+
+### Configuration
+
+No configuration changes required. The feature works automatically when running `ax init`.
+
+**Optional customization**:
+```bash
+# Force update existing CLAUDE.md
+ax init --force
+
+# Template location for customization
+examples/claude/CLAUDE_INTEGRATION.md
+```
+
+---
+
 ## [5.6.13](https://github.com/defai-digital/automatosx/compare/v5.6.12...v5.6.13) (2025-10-21)
 
 ### New Features - Phase 3 Advanced Optimizations

package/dist/index.js

@@ -5480,6 +5480,9 @@ var initCommand = {
       await setupClaudeIntegration(projectDir, packageRoot);
       createdResources.push(join(projectDir, ".claude"));
       console.log(chalk27.green("   \u2713 Claude Code integration configured"));
+      console.log(chalk27.cyan("\u{1F4D6} Setting up CLAUDE.md with AutomatosX integration..."));
+      await setupProjectClaudeMd(projectDir, packageRoot, argv2.force ?? false);
+      console.log(chalk27.green("   \u2713 CLAUDE.md configured"));
       console.log(chalk27.cyan("\u{1F527} Initializing git repository..."));
       await initializeGitRepository(projectDir);
       console.log(chalk27.green("   \u2713 Git repository initialized"));
@@ -5777,6 +5780,81 @@ async function updateGitignore(projectDir) {
     logger.warn("Failed to update .gitignore", { error: error.message });
   }
 }
+async function setupProjectClaudeMd(projectDir, packageRoot, force) {
+  const claudeMdPath = join(projectDir, "CLAUDE.md");
+  const templatePath = join(packageRoot, "examples/claude/CLAUDE_INTEGRATION.md");
+  try {
+    const { readFile: readFile9 } = await import('fs/promises');
+    const template = await readFile9(templatePath, "utf-8");
+    const exists = await checkExists2(claudeMdPath);
+    if (!exists) {
+      const content = [
+        "# CLAUDE.md",
+        "",
+        "This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.",
+        "",
+        "---",
+        "",
+        template
+      ].join("\n");
+      await writeFile(claudeMdPath, content, "utf-8");
+      logger.info("Created CLAUDE.md with AutomatosX integration", { path: claudeMdPath });
+    } else {
+      const existingContent = await readFile9(claudeMdPath, "utf-8");
+      if (existingContent.includes("# AutomatosX Integration")) {
+        if (!force) {
+          logger.info("CLAUDE.md already contains AutomatosX integration", { path: claudeMdPath });
+          return;
+        }
+        const updatedContent = replaceAutomatosXSection(existingContent, template);
+        await writeFile(claudeMdPath, updatedContent, "utf-8");
+        logger.info("Updated AutomatosX integration in CLAUDE.md", { path: claudeMdPath });
+      } else {
+        const updatedContent = [
+          existingContent.trimEnd(),
+          "",
+          "---",
+          "",
+          template
+        ].join("\n");
+        await writeFile(claudeMdPath, updatedContent, "utf-8");
+        logger.info("Added AutomatosX integration to existing CLAUDE.md", { path: claudeMdPath });
+      }
+    }
+  } catch (error) {
+    logger.warn("Failed to setup CLAUDE.md", {
+      error: error.message,
+      path: claudeMdPath
+    });
+  }
+}
+function replaceAutomatosXSection(content, newSection) {
+  const sectionStart = content.indexOf("# AutomatosX Integration");
+  if (sectionStart === -1) {
+    return [
+      content.trimEnd(),
+      "",
+      "---",
+      "",
+      newSection
+    ].join("\n");
+  }
+  const afterSection = content.substring(sectionStart + 1);
+  const nextSectionMatch = afterSection.match(/\n#(?!#) /);
+  let sectionEnd;
+  if (nextSectionMatch && nextSectionMatch.index !== void 0) {
+    sectionEnd = sectionStart + 1 + nextSectionMatch.index;
+  } else {
+    sectionEnd = content.length;
+  }
+  const before = content.substring(0, sectionStart);
+  const after = content.substring(sectionEnd);
+  return [
+    before.trimEnd(),
+    newSection,
+    after.trimStart()
+  ].join("\n\n");
+}
 
 // src/cli/commands/list.ts
 init_esm_shims();

package/examples/claude/CLAUDE_INTEGRATION.md

@@ -0,0 +1,256 @@
+# AutomatosX Integration
+
+This project uses [AutomatosX](https://github.com/defai-digital/automatosx) - an AI agent orchestration platform with persistent memory and multi-agent collaboration.
+
+## Quick Start
+
+### Available Commands
+
+```bash
+# List all available agents
+ax list agents
+
+# Run an agent with a task
+ax run <agent-name> "your task description"
+
+# Example: Ask the backend agent to create an API
+ax run backend "create a REST API for user management"
+
+# Search memory for past conversations
+ax memory search "keyword"
+
+# View system status
+ax status
+```
+
+### Using AutomatosX in Claude Code
+
+You can interact with AutomatosX agents directly in Claude Code using natural language or slash commands:
+
+**Natural Language (Recommended)**:
+```
+"Please work with ax agent backend to implement user authentication"
+"Ask the ax security agent to audit this code for vulnerabilities"
+"Have the ax quality agent write tests for this feature"
+```
+
+**Slash Command**:
+```
+/ax-agent backend, create a REST API for user management
+/ax-agent security, audit the authentication flow
+/ax-agent quality, write unit tests for the API
+```
+
+### Available Agents
+
+This project includes the following specialized agents:
+
+- **backend** - Backend development (Go/Rust/Python systems)
+- **frontend** - Frontend development (React/Next.js/Swift)
+- **fullstack** - Full-stack development (Node.js/TypeScript + Python)
+- **mobile** - Mobile development (iOS/Android, Swift/Kotlin/Flutter)
+- **devops** - DevOps and infrastructure
+- **security** - Security auditing and threat modeling
+- **data** - Data engineering and ETL
+- **quality** - QA and testing
+- **design** - UX/UI design
+- **writer** - Technical writing
+- **product** - Product management
+- **cto** - Technical strategy
+- **ceo** - Business leadership
+- **researcher** - Research and analysis
+
+For a complete list with capabilities, run: `ax list agents --format json`
+
+## Key Features
+
+### 1. Persistent Memory
+
+AutomatosX agents remember all previous conversations and decisions:
+
+```bash
+# First task - design is saved to memory
+ax run product "Design a calculator with add/subtract features"
+
+# Later task - automatically retrieves the design from memory
+ax run backend "Implement the calculator API"
+```
+
+### 2. Multi-Agent Collaboration
+
+Agents can delegate tasks to each other automatically:
+
+```bash
+ax run product "Build a complete user authentication feature"
+# → Product agent designs the system
+# → Automatically delegates implementation to backend agent
+# → Automatically delegates security audit to security agent
+```
+
+### 3. Cross-Provider Support
+
+AutomatosX supports multiple AI providers with automatic fallback:
+- Claude (Anthropic)
+- Gemini (Google)
+- OpenAI (GPT)
+
+Configuration is in `automatosx.config.json`.
+
+## Configuration
+
+### Project Configuration
+
+Edit `automatosx.config.json` to customize:
+
+```json
+{
+  "providers": {
+    "claude-code": {
+      "enabled": true,
+      "priority": 1
+    },
+    "gemini-cli": {
+      "enabled": true,
+      "priority": 2
+    }
+  },
+  "execution": {
+    "defaultTimeout": 1500000,  // 25 minutes
+    "maxRetries": 3
+  },
+  "memory": {
+    "enabled": true,
+    "maxEntries": 10000
+  }
+}
+```
+
+### Agent Customization
+
+Create custom agents in `.automatosx/agents/`:
+
+```bash
+ax agent create my-agent --template developer --interactive
+```
+
+## Memory System
+
+### Search Memory
+
+```bash
+# Search for past conversations
+ax memory search "authentication"
+ax memory search "API design"
+
+# List recent memories
+ax memory list --limit 10
+
+# Export memory for backup
+ax memory export > backup.json
+```
+
+### How Memory Works
+
+- **Automatic**: All agent conversations are saved automatically
+- **Fast**: SQLite FTS5 full-text search (< 1ms)
+- **Local**: 100% private, data never leaves your machine
+- **Cost**: $0 (no API calls for memory operations)
+
+## Advanced Usage
+
+### Parallel Execution (v5.6.0+)
+
+Run multiple agents in parallel for faster workflows:
+
+```bash
+ax run product "Design authentication system" --parallel
+```
+
+### Resumable Runs (v5.3.0+)
+
+For long-running tasks, enable checkpoints:
+
+```bash
+ax run backend "Refactor entire codebase" --resumable
+
+# If interrupted, resume with:
+ax resume <run-id>
+
+# List all runs
+ax runs list
+```
+
+### Streaming Output (v5.6.5+)
+
+See real-time output from AI providers:
+
+```bash
+ax run backend "Explain this codebase" --streaming
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**"Agent not found"**
+```bash
+# List available agents
+ax list agents
+
+# Make sure agent name is correct
+ax run backend "task"  # ✓ Correct
+ax run Backend "task"  # ✗ Wrong (case-sensitive)
+```
+
+**"Provider not available"**
+```bash
+# Check system status
+ax status
+
+# View configuration
+ax config show
+```
+
+**"Out of memory"**
+```bash
+# Clear old memories
+ax memory clear --before "2024-01-01"
+
+# View memory stats
+ax cache stats
+```
+
+### Getting Help
+
+```bash
+# View command help
+ax --help
+ax run --help
+
+# Enable debug mode
+ax --debug run backend "task"
+
+# Search memory for similar past tasks
+ax memory search "similar task"
+```
+
+## Best Practices
+
+1. **Use Natural Language in Claude Code**: Let Claude Code coordinate with agents for complex tasks
+2. **Leverage Memory**: Reference past decisions and designs
+3. **Start Simple**: Test with small tasks before complex workflows
+4. **Review Configurations**: Check `automatosx.config.json` for timeouts and retries
+5. **Keep Agents Specialized**: Use the right agent for each task type
+
+## Documentation
+
+- **AutomatosX Docs**: https://github.com/defai-digital/automatosx
+- **Agent Directory**: `.automatosx/agents/`
+- **Configuration**: `automatosx.config.json`
+- **Memory Database**: `.automatosx/memory/memories.db`
+- **Workspace**: `automatosx/PRD/` (planning docs) and `automatosx/tmp/` (temporary files)
+
+## Support
+
+- Issues: https://github.com/defai-digital/automatosx/issues
+- NPM: https://www.npmjs.com/package/@defai.digital/automatosx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defai.digital/automatosx",
-  "version": "5.6.13",
+  "version": "5.6.14",
   "description": "AI Agent Orchestration Platform",
   "type": "module",
   "publishConfig": {