Comandos Especializados por Agente

Cada agente AIOS tem seu próprio conjunto de comandos para seu domínio. Use o handle do agente para endereçá-los diretamente.

Para uma referência rápida em uma página única, veja o Cheat Sheet. Para personas e papéis dos agentes, veja Agentes.

@sm — River (Scrum Master)

Comando	Descrição
`@sm *draft`	Criar uma nova story (criação guiada interativa)
`@sm *create-story`	Comando alternativo de criação de story
`@sm *help`	Mostrar todos os comandos de @sm

Comando	Descrição
`@po *validate-story-draft`	Executar checklist de validação de 10 pontos; decisão GO/NO-GO
`@po *help`	Mostrar todos os comandos de @po

Decisão: GO (≥ 7/10) move a story de Draft para Ready.

Comando	Descrição
`@dev *develop {story-id}`	Iniciar implementação de uma story (modo Interactive)
`@dev *develop {story-id} --yolo`	Modo YOLO — autônomo, 0-1 prompts
`@dev *develop {story-id} --pre-flight`	Pre-Flight — todas as perguntas antecipadas
`@dev *help`	Mostrar todos os comandos de @dev

Autoridade: Pode git add, git commit, git branch, git checkout. Não pode git push — delegar ao @devops.

Comando	Descrição
`@qa *qa-gate`	Executar quality gate de 7 pontos
`*qa-loop {storyId}`	Iniciar ciclo automatizado de revisão-correção (máx. 5 iterações)
`*qa-loop-review`	Retomar o ciclo a partir da etapa de revisão
`*qa-loop-fix`	Retomar o ciclo a partir da etapa de correção
`*stop-qa-loop`	Pausar o ciclo e salvar estado em `qa/loop-status.json`
`*resume-qa-loop`	Retomar do estado salvo
`*escalate-qa-loop`	Forçar escalação manual
`@qa *help`	Mostrar todos os comandos de @qa

Veredictos do QA gate: PASS, CONCERNS, FAIL, WAIVED

Comando	Descrição
`@devops *push`	Fazer push das alterações commitadas para o remoto (EXCLUSIVO do @devops)
`@devops *create-pr`	Criar um pull request
`@devops *help`	Mostrar todos os comandos de @devops

Autoridade exclusiva: Único agente que pode git push, gh pr create e gh pr merge.

Comando	Descrição
`@pm *create-epic`	Criar um novo epic a partir de requisitos
`@pm *execute-epic`	Executar um plano de epic
`@pm *create-doc prd`	Gerar um documento PRD
`@pm *advanced-elicitation`	Executar elicitação avançada de requisitos
`@pm *help`	Mostrar todos os comandos de @pm

Comando	Descrição
`@architect *create-full-stack-architecture`	Gerar documentação completa de arquitetura
`@architect *execute-checklist architect-checklist`	Executar checklist de revisão de arquitetura
`@architect *help`	Mostrar todos os comandos de @architect

Comando	Descrição
`@analyst *research`	Executar tarefa de pesquisa estruturada
`@analyst *help`	Mostrar todos os comandos de @analyst

Usado em: Spec Pipeline Fase 3 para classes de complexidade STANDARD e COMPLEX.

Comando	Descrição
`@data-engineer *audit-db`	Auditar schema do banco de dados e gerar relatório
`@data-engineer *help`	Mostrar todos os comandos de @data-engineer

Comando	Descrição
`@ux-design-expert *design-review`	Executar revisão de design UX
`@ux-design-expert *help`	Mostrar todos os comandos de @ux-design-expert

Comando	Descrição
`@docs *create-doc`	Criar documentação a partir do template
`@docs *document-project`	Gerar docs para o projeto inteiro
`@docs *help`	Mostrar todos os comandos de @docs

O AIOS aplica padrões estritos de delegação. Regras principais:

Qualquer agente que precise fazer push de código DEVE delegar para @devops *push
@architect decide a tecnologia; @data-engineer implementa o DDL
@sm cria stories; @po as valida — nenhum pode fazer o trabalho do outro
@aios-master (Orion) pode sobrepor limites quando necessário para a saúde do framework