@defai.digital/automatosx 12.8.7 → 13.1.3

package/examples/providers/claude/CLAUDE_INTEGRATION.md

@@ -1,302 +0,0 @@
-# AutomatosX Integration for Claude Code
-
-**IMPORTANT**: For the complete AutomatosX integration guide, **please read [AX-Integration.md](../AX-Integration.md)**.
-
-This file provides Claude Code-specific tips and quick reference. For comprehensive documentation including all agents, commands, memory features, workflows, and troubleshooting, see [AX-Integration.md](../AX-Integration.md).
-
----
-
-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:
-
-**Natural Language Examples**:
-```
-"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"
-"Use ax agent product to design this new feature"
-"Work with ax agent devops to set up the deployment pipeline"
-```
-
-Claude Code will understand your intent and invoke the appropriate AutomatosX agent for you. Just describe what you need in natural language - no special commands required!
-
-### Available Agents
-
-This project includes the following specialized agents:
-
-- **backend** (Bob) - Backend development (Go/Rust systems)
-- **frontend** (Frank) - Frontend development (React/Next.js/Swift)
-- **architecture** (Avery) - System architecture and ADR management
-- **fullstack** (Felix) - Full-stack development (Node.js/TypeScript)
-- **mobile** (Maya) - Mobile development (iOS/Android, Swift/Kotlin/Flutter)
-- **devops** (Oliver) - DevOps and infrastructure
-- **security** (Steve) - Security auditing and threat modeling
-- **data** (Daisy) - Data engineering and ETL
-- **quality** (Queenie) - QA and testing
-- **design** (Debbee) - UX/UI design
-- **writer** (Wendy) - Technical writing
-- **product** (Paris) - Product management
-- **cto** (Tony) - Technical strategy
-- **ceo** (Eric) - Business leadership
-- **researcher** (Rodman) - Research and analysis
-- **data-scientist** (Dana) - Machine learning and data science
-- **aerospace-scientist** (Astrid) - Aerospace engineering and mission design
-- **quantum-engineer** (Quinn) - Quantum computing and algorithms
-- **creative-marketer** (Candy) - Creative marketing and content strategy
-- **standard** (Stan) - Standards and best practices expert
-
-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) - Primary provider for Claude Code users
-- **Gemini** (Google) - Alternative provider
-- **OpenAI** (GPT) - Alternative provider
-
-Configuration is in `ax.config.json`.
-
-## Configuration
-
-### Project Configuration
-
-Edit `ax.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
-```
-
-### Workspace Conventions
-
-**IMPORTANT**: AutomatosX uses specific directories for organized file management. Please follow these conventions when working with agents:
-
-- **`automatosx/PRD/`** - Product Requirements Documents, design specs, and planning documents
-  - Use for: Architecture designs, feature specs, technical requirements
-  - Example: `automatosx/PRD/auth-system-design.md`
-
-- **`automatosx/tmp/`** - Temporary files, scratch work, and intermediate outputs
-  - Use for: Draft code, test outputs, temporary analysis
-  - Auto-cleaned periodically
-  - Example: `automatosx/tmp/draft-api-endpoints.ts`
-
-**Usage in Claude Code**:
-```
-"Please save the architecture design to automatosx/PRD/user-auth-design.md"
-"Put the draft implementation in automatosx/tmp/auth-draft.ts for review"
-"Work with ax agent backend to implement the spec in automatosx/PRD/api-spec.md"
-```
-
-These directories are automatically created by `ax setup` and included in `.gitignore` appropriately.
-
-## 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
-
-Run multiple agents in parallel for faster workflows:
-
-```bash
-ax run product "Design authentication system" --parallel
-```
-
-### Resumable Runs
-
-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
-
-See real-time output from AI providers:
-
-```bash
-ax run backend "Explain this codebase" --streaming
-```
-
-### Spec-Driven Development
-
-For complex projects, use spec-driven workflows:
-
-```bash
-# Create spec from natural language
-ax spec create "Build authentication with database, API, JWT, and tests"
-
-# Or manually define in .specify/tasks.md
-ax spec run --parallel
-
-# Check progress
-ax spec status
-```
-
-## 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 `ax.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**: `ax.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/examples/providers/claude/mcp/automatosx.json

@@ -1,244 +0,0 @@
-{
-  "mcpServers": {
-    "automatosx": {
-      "command": "automatosx",
-      "args": ["mcp"],
-      "description": "AutomatosX AI Agent Orchestration Platform with persistent memory and multi-agent coordination",
-      "tools": [
-        {
-          "name": "run_agent",
-          "description": "Execute an AutomatosX agent with a specific task",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "agent": {
-                "type": "string",
-                "description": "The name of the agent to run (e.g., backend, Paris, Bob)"
-              },
-              "task": {
-                "type": "string",
-                "description": "The task for the agent to perform"
-              },
-              "provider": {
-                "type": "string",
-                "description": "Optional: Override the AI provider",
-                "enum": ["claude", "gemini", "openai"]
-              },
-              "no_memory": {
-                "type": "boolean",
-                "description": "Optional: Skip memory injection",
-                "default": false
-              }
-            },
-            "required": ["agent", "task"]
-          }
-        },
-        {
-          "name": "list_agents",
-          "description": "List all available AutomatosX agents",
-          "inputSchema": {
-            "type": "object",
-            "properties": {}
-          }
-        },
-        {
-          "name": "search_memory",
-          "description": "Search AutomatosX memory for relevant information",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "query": {
-                "type": "string",
-                "description": "Search query"
-              },
-              "limit": {
-                "type": "number",
-                "description": "Maximum number of results",
-                "default": 10
-              }
-            },
-            "required": ["query"]
-          }
-        },
-        {
-          "name": "get_status",
-          "description": "Get AutomatosX system status and configuration",
-          "inputSchema": {
-            "type": "object",
-            "properties": {}
-          }
-        },
-        {
-          "name": "session_create",
-          "description": "Create a new multi-agent session",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "type": "string",
-                "description": "Session name/task description"
-              },
-              "agent": {
-                "type": "string",
-                "description": "Initiating agent name"
-              }
-            },
-            "required": ["name", "agent"]
-          }
-        },
-        {
-          "name": "session_list",
-          "description": "List all active sessions",
-          "inputSchema": {
-            "type": "object",
-            "properties": {}
-          }
-        },
-        {
-          "name": "session_status",
-          "description": "Get detailed status of a specific session",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Session ID"
-              }
-            },
-            "required": ["id"]
-          }
-        },
-        {
-          "name": "session_complete",
-          "description": "Mark a session as completed",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Session ID"
-              }
-            },
-            "required": ["id"]
-          }
-        },
-        {
-          "name": "session_fail",
-          "description": "Mark a session as failed with an error reason",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "string",
-                "description": "Session ID"
-              },
-              "reason": {
-                "type": "string",
-                "description": "Failure reason"
-              }
-            },
-            "required": ["id", "reason"]
-          }
-        },
-        {
-          "name": "memory_add",
-          "description": "Add a new memory entry to the system",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "content": {
-                "type": "string",
-                "description": "Memory content"
-              },
-              "metadata": {
-                "type": "object",
-                "description": "Optional metadata (agent, timestamp, etc.)",
-                "properties": {
-                  "agent": { "type": "string" },
-                  "timestamp": { "type": "string" }
-                }
-              }
-            },
-            "required": ["content"]
-          }
-        },
-        {
-          "name": "memory_list",
-          "description": "List memory entries with optional filtering",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "agent": {
-                "type": "string",
-                "description": "Filter by agent name"
-              },
-              "limit": {
-                "type": "number",
-                "description": "Maximum number of entries",
-                "default": 50
-              }
-            }
-          }
-        },
-        {
-          "name": "memory_delete",
-          "description": "Delete a specific memory entry by ID",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "id": {
-                "type": "number",
-                "description": "Memory entry ID"
-              }
-            },
-            "required": ["id"]
-          }
-        },
-        {
-          "name": "memory_export",
-          "description": "Export all memory entries to a JSON file",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "path": {
-                "type": "string",
-                "description": "Export file path (relative to .automatosx/memory/exports/)"
-              }
-            },
-            "required": ["path"]
-          }
-        },
-        {
-          "name": "memory_import",
-          "description": "Import memory entries from a JSON file",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "path": {
-                "type": "string",
-                "description": "Import file path"
-              }
-            },
-            "required": ["path"]
-          }
-        },
-        {
-          "name": "memory_stats",
-          "description": "Get detailed memory statistics",
-          "inputSchema": {
-            "type": "object",
-            "properties": {}
-          }
-        },
-        {
-          "name": "memory_clear",
-          "description": "Clear all memory entries from the database",
-          "inputSchema": {
-            "type": "object",
-            "properties": {}
-          }
-        }
-      ]
-    }
-  }
-}