User Guide

# New project (Greenfield)
npx aiox-core init my-project

# Existing project (Brownfield)
cd existing-project
npx aiox-core install

# Navigate to your project
cd my-project

# List available agents
aiox agents list

# Activate an agent
@dev

# Get help
*help

# Activate an agent using @ syntax
@dev                # Activate Dex (Developer)
@qa                 # Activate Quinn (QA)
@architect          # Activate Aria (Architect)
@aiox-master        # Activate Pax (Orchestrator)

# Agent commands use * prefix
*help               # Show available commands
*task <name>        # Execute specific task
*exit               # Deactivate agent

User Request --> Task --> Agent Execution --> Output
                  |
             Workflow (if multi-step)

# Execute a specific task
*task develop-story --story=1.1

# List available tasks
aiox tasks list

# Get task help
*task --help

# Start a workflow
aiox workflow greenfield-fullstack

# With parameters
aiox workflow brownfield-integration --target=./existing-project

Level 1: LOCAL        --> ./squads/           (Private)
Level 2: AIOX-SQUADS  --> github.com/SynkraAI (Public/Free)
Level 3: SYNKRA API   --> api.synkra.dev      (Marketplace)

# List available squads
aiox squads list

# Download a squad
aiox squads download etl-squad

# Create your own squad
@squad-creator
*create-squad my-custom-squad

my-project/
├── .aiox-core/                # Framework configuration
│   ├── development/agents/    # Agent definitions
│   ├── development/tasks/     # Task workflows
│   ├── product/templates/     # Document templates
│   └── product/checklists/    # Validation checklists
├── docs/
│   ├── stories/               # Development stories
│   ├── architecture/          # System architecture
│   └── guides/                # User guides
├── squads/                    # Local squads
└── src/                       # Application source code

# AIOX Master Commands
*help                # Show available commands
*create-story        # Create new story
*task {name}         # Execute specific task
*workflow {name}     # Run workflow

# Development Commands
npm run dev          # Start development
npm test             # Run tests
npm run lint         # Check code style
npm run build        # Build project

# aiox.config.yaml
version: 2.1.0
projectName: my-project

features:
  - agents
  - tasks
  - workflows
  - squads
  - quality-gates

ai:
  provider: anthropic
  model: claude-3-opus

environment: development

# AI Provider Configuration
ANTHROPIC_API_KEY=your-anthropic-api-key
# or
OPENAI_API_KEY=your-openai-api-key

# Framework Settings
NODE_ENV=development
AIOX_DEBUG=false

# Sync agents to your IDE
npm run sync:ide

@aiox-master
*create-story

aiox squads search {keyword}