Squad System

./squads/my-squad/
├── squad.yaml              # Manifest (required)
├── README.md               # Documentation
├── LICENSE                 # License file
├── config/
│   ├── coding-standards.md # Code style rules
│   ├── tech-stack.md       # Technologies used
│   └── source-tree.md      # Directory structure
├── agents/
│   └── specialist.md       # Agent definitions
├── tasks/
│   └── workflow-task.md    # Task definitions
├── workflows/
│   └── process.yaml        # Multi-step workflows
├── checklists/
│   └── quality.md          # Validation checklists
├── templates/
│   └── report.md           # Document templates
├── tools/
│   └── custom-tool.js      # Custom integrations
├── scripts/
│   └── setup.js            # Utility scripts
└── data/
    └── reference.json      # Static data files

# Required fields
name: my-squad                    # kebab-case, unique identifier
version: 1.0.0                    # Semantic versioning
description: What this squad does

# Metadata
author: Your Name <[email protected]>
license: MIT
slashPrefix: my                   # Command prefix for IDE

# AIOX compatibility
aiox:
  minVersion: "2.1.0"
  type: squad

# Components declaration
components:
  agents:
    - specialist.md
  tasks:
    - workflow-task.md
  workflows: []
  checklists: []
  templates: []
  tools: []
  scripts: []

# Configuration inheritance
config:
  extends: extend                 # extend | override | none
  coding-standards: config/coding-standards.md
  tech-stack: config/tech-stack.md
  source-tree: config/source-tree.md

# Dependencies
dependencies:
  node: []                        # npm packages
  python: []                      # pip packages
  squads: []                      # Other squads

# Discovery tags
tags:
  - domain-specific
  - automation

# .squad-design.yaml
metadata:
  domain: casting
  created: 2025-12-26T10:00:00Z
  source_docs:
    - ./docs/prd/casting-system.md

recommended_agents:
  - name: casting-coordinator
    role: Coordinates casting workflows
    confidence: 0.92

recommended_tasks:
  - name: process-submission
    description: Process actor submission
    agent: casting-coordinator
    confidence: 0.88

@squad-creator

# Basic analysis
*analyze-squad my-squad

# Verbose output
*analyze-squad my-squad --verbose

# Export as markdown
*analyze-squad my-squad --format markdown

=== Squad Analysis: my-squad ===

Overview
  Name: my-squad
  Version: 1.0.0
  Author: Your Name

Components
  agents/ (2)
    - lead-agent.md
    - helper-agent.md
  tasks/ (3)
    - lead-agent-task1.md
    - lead-agent-task2.md
    - helper-agent-task1.md
  workflows/ (0) <- Empty

Coverage
  Agents: [#####-----] 50% (1/2 with tasks)
  Tasks: [########--] 80% (3 tasks)
  Directories: [##--------] 25% (2/8 populated)

Suggestions
  1. [!] Add tasks for helper-agent
  2. [*] Create workflows for common sequences
  3. [-] Add checklists for validation

@squad-creator
*validate-squad my-squad

*validate-squad my-squad --strict

*list-squads

@squad-creator

# Validate first
*validate-squad my-squad --strict

# Publish to GitHub
*publish-squad ./squads/my-squad

# Set up authentication
export SYNKRA_API_TOKEN="your-token"

# Sync to marketplace
*sync-squad-synkra ./squads/my-squad --public

@squad-creator

# List available squads
*download-squad --list

# Download specific squad
*download-squad etl-squad

# Download specific version
*download-squad [email protected]

# Restore from backup
cp -r ./squads/my-squad/.backup/pre-migration-*/. ./squads/my-squad/

const { SquadLoader, SquadValidator, SquadAnalyzer, SquadExtender } = 
  require('./.aiox-core/development/scripts/squad');

// Load squad
const loader = new SquadLoader({ squadsPath: './squads' });
const { path, manifestPath } = await loader.resolve('my-squad');
const manifest = await loader.loadManifest(path);

// Validate squad
const validator = new SquadValidator({ strict: false });
const result = await validator.validate('./squads/my-squad');
console.log(result); // { valid: true, errors: [], warnings: [] }

// Analyze squad
const analyzer = new SquadAnalyzer({ squadsPath: './squads' });
const analysis = await analyzer.analyze('my-squad');
console.log('Coverage:', analysis.coverage);

// Extend squad
const extender = new SquadExtender({ squadsPath: './squads' });
const added = await extender.addComponent('my-squad', {
  type: 'task',
  name: 'new-task',
  agentId: 'lead-agent',
  description: 'A new task'
});
console.log('Created:', added.filePath);