@defai.digital/automatosx 5.6.35 → 5.7.2

package/examples/agents/CLAUDE.md

@@ -0,0 +1,262 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+---
+
+# 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.35",
+  "version": "5.7.2",
   "description": "AI Agent Orchestration Platform",
   "type": "module",
   "publishConfig": {