Referência de API do AIOS

┌─────────────────────────────────────────────────────────────┐
│                      Camada de API AIOS                      │
├─────────────────────────────────────────────────────────────┤
│  @agent         →  Ativa a persona do agente                 │
│  *command       →  Executa comando do agente                 │
│  *command args  →  Executa comando com argumentos            │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    Resolução de Agente                       │
├─────────────────────────────────────────────────────────────┤
│  .aios-core/development/agents/{agent-id}.md                 │
│  Dependências: tasks, templates, checklists, scripts         │
└─────────────────────────────────────────────────────────────┘

@{agent-id}
@{agent-id} *{command}
@{agent-id} *{command} {arguments}

# Ativar agente desenvolvedor
@dev
 
# Saída:
# 💻 Dex (Builder) ready. Let's build something great!
#
# **Quick Commands:**
# - *develop {story-id} - Implement story tasks
# - *run-tests - Execute linting and tests
# - *help - Show all commands

@dev *develop story-1.2.3
@qa *review story-1.2.3
@architect *create-full-stack-architecture

*{command}
*{command} {positional-argument}
*{command} {arg1} {arg2}
*{command} --{flag}
*{command} --{option}={value}

*develop story-1.2.3
    │
    ▼
.aios-core/development/tasks/dev-develop-story.md
    │
    ▼
Execução de task com argumentos: { story: "story-1.2.3" }

# Iniciar workflow
@aios-master *workflow greenfield-fullstack
 
# Com parâmetros
*workflow brownfield-service --target=./services/auth

# Exemplo de definição de workflow
name: greenfield-fullstack
phases:
  - name: research
    agent: analyst
    tasks:
      - brainstorm
      - competitive-analysis
  - name: planning
    agent: pm
    tasks:
      - create-prd
  - name: architecture
    agent: architect
    tasks:
      - create-full-stack-architecture
  - name: implementation
    agent: dev
    tasks:
      - develop

{
  "status": "error",
  "code": "VALIDATION_FAILED",
  "message": "Story status must be 'Ready for Dev' to begin implementation",
  "context": {
    "story": "story-1.2.3",
    "currentStatus": "Draft",
    "requiredStatus": "Ready for Dev"
  },
  "suggestions": ["Update story status to 'Ready for Dev'", "Contact @pm to approve story"]
}

# .aios-sync.yaml
version: 1.0.0
active_ides:
  - claude
  - cursor
 
squad_aliases:
  legal: Legal
  copy: Copy
  hr: HR
 
sync_components:
  agents: true
  tasks: true
  workflows: true
  checklists: true

# Sincronizar agente específico
*command agent {agent-name}
 
# Sincronizar task específica
*command task {task-name}
 
# Sincronizar squad inteiro
*command squad {squad-name}
 
# Sincronizar todos os componentes
*command sync-all

/dev          → Ativa agente @dev
/qa           → Ativa agente @qa
/architect    → Ativa agente @architect
/aios-master  → Ativa agente @aios-master

.claude/
├── commands/
│   └── AIOS/
│       └── agents/
│           ├── dev.md
│           ├── qa.md
│           ├── architect.md
│           └── ...
├── rules/
│   └── mcp-usage.md
└── hooks/
    ├── read-protection.py
    └── sql-governance.py

.cursor/
└── rules/
    ├── dev.mdc
    ├── qa.mdc
    └── architect.mdc

---
description: Full Stack Developer - Code implementation
globs: []
alwaysApply: false
---
# Agent content...

└── agents/
    ├── dev.md
    ├── qa.md
    └── architect.md

# 1. Ativar agente desenvolvedor
@dev
 
# 2. Iniciar implementação da story
*develop story-1.2.3
 
# 3. Executar testes
*run-tests
 
# 4. Verificar gotchas
*list-gotchas
 
# 5. Sair do modo desenvolvedor
*exit
 
# 6. Mudar para QA
@qa
 
# 7. Revisar a story
*review story-1.2.3
 
# 8. Criar quality gate
*gate story-1.2.3

# 1. Levantar requisitos
@pm *gather-requirements
 
# 2. Avaliar complexidade
@architect *assess-complexity story-1.2.3
 
# 3. Pesquisar dependências
@analyst *research-deps "authentication libraries"
 
# 4. Escrever especificação
@pm *write-spec
 
# 5. Criticar especificação
@qa *critique-spec story-1.2.3
 
# 6. Criar plano de implementação
@architect *create-plan story-1.2.3
 
# 7. Gerar contexto
@architect *create-context story-1.2.3
 
# 8. Executar subtasks
@dev *execute-subtask 1.1
 
# 9. Revisar build
@qa *review-build story-1.2.3

# Quando a implementação falha
@dev
 
# 1. Rastrear a tentativa falha
*track-attempt subtask-1.1
 
# 2. Verificar gotchas conhecidos
*list-gotchas
 
# 3. Tentar rollback
*rollback
 
# 4. Tentar novamente com abordagem diferente
*execute-subtask 1.1 --approach alternative
 
# 5. Capturar insights para o futuro
*capture-insights

# 1. Criar worktree isolado
@devops *create-worktree STORY-42
 
# 2. Desenvolver em isolamento
@dev *develop STORY-42
 
# 3. Review de QA
@qa *review STORY-42
 
# 4. Fazer merge de volta
@devops *merge-worktree STORY-42
 
# 5. Limpeza
@devops *cleanup-worktrees

# 1. Ativar orquestrador master
@aios-master
 
# 2. Habilitar base de conhecimento
*kb
 
# 3. Criar novo agente
*create agent my-custom-agent
 
# 4. Validar o componente
*validate-component my-custom-agent
 
# 5. Criar task associada
*create task my-custom-task
 
# 6. Testar o workflow
*task my-custom-task

O que você precisa?
│
├─ Pesquisa/Análise?
│  └─ @analyst
│
├─ Requisitos de Produto?
│  ├─ PRD/Epic → @pm
│  └─ User Stories → @sm
│
├─ Arquitetura?
│  ├─ Design de Sistema → @architect
│  └─ Schema de Banco → @data-engineer
│
├─ Implementação?
│  └─ @dev
│
├─ Garantia de Qualidade?
│  └─ @qa
│
├─ Deployment/Git?
│  └─ @devops
│
├─ Design UX/UI?
│  └─ @ux-expert
│
└─ Framework/Orquestração?
   └─ @aios-master