Skip to Content
PlaybookComeçandoOnboarding em 60 Minutos

Onboarding em 60 Minutos

Um passo a passo estruturado para se tornar produtivo com o Synkra AIOS em uma hora. Ao final, você terá instalado o framework, ativado agentes, criado sua primeira story, executado um workflow e passado por um quality gate.

Minuto 0-10: Instalação e Configuração

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Node.js versão 18.0.0 ou superior
  • npm versão 6.0.0 ou superior
  • Git instalado e configurado
  • GitHub CLI (gh) instalado (para workflows de push/PR)
  • Uma IDE de IA como Claude Code (recomendado), Cursor ou VS Code com extensões de IA

Instale o AIOS

# Criar um novo projeto
npx @synkra/aios-core init meu-primeiro-projeto
 
# Navegar até o projeto
cd meu-primeiro-projeto

Verifique a Instalação

Confirme que o diretório .aios-core/ foi criado com a estrutura esperada:

meu-primeiro-projeto/
  .aios-core/             # Configuração do framework e agentes
  agents/                 # Diretório de agentes de IA
  workflows/              # Workflows automatizados
  tasks/                  # Tasks reutilizáveis
  .env                    # Variáveis de ambiente (configure sua chave de API)

Configure seu Ambiente

Edite o arquivo .env com a chave do seu provedor de IA:

OPENAI_API_KEY=sua-chave-openai
# ou
ANTHROPIC_API_KEY=sua-chave-anthropic

Minuto 10-20: Entendendo o Meta-Agente

Inicie o Meta-Agente

npx @synkra/aios-core

Conceitos Fundamentais

O meta-agente é o coração do AIOS. É uma IA que entende seu próprio código-fonte e orquestra agentes especializados para lidar com diferentes aspectos do desenvolvimento.

Capacidades principais:

  • Auto-Análise — Examina a estrutura de código do projeto
  • Geração de Código — Cria componentes seguindo padrões aprendidos
  • Aprendizado de Padrões — Adapta-se ao estilo de desenvolvimento da equipe
  • Orquestração de Workflows — Coordena agentes através de workflows estruturados

Comandos Essenciais

Experimente estes comandos para se orientar:

*help                    # Mostrar todos os comandos disponíveis
*status                  # Exibir status do sistema
*list-agents             # Mostrar todos os agentes disponíveis
*config                  # Ver configuração atual

Os 13 Agentes

O AIOS vem com 13 agentes especializados. Os mais importantes para conhecer de imediato:

AgentePapelComando Principal
@dev (Dex)Desenvolvimento de software@dev *develop {story-id}
@sm (River)Criação de stories@sm *draft
@po (Pax)Validação de stories@po *validate-story-draft
@qaGarantia de qualidade@qa *qa-gate
@devops (Gage)Push e deploy@devops *push
@architect (Aria)Design de sistemas@architect *create-full-stack-architecture
@pm (Morgan)Gestão de epics e projetos@pm *create-epic

Minuto 20-35: Ativação de Agentes e sua Primeira Story

Ative um Agente

Os agentes são ativados ao endereçá-los diretamente:

@sm *help      # Ativar o Scrum Master e ver comandos disponíveis
@dev *help     # Ativar o agente Desenvolvedor

Entenda os Limites dos Agentes

Um conceito importante no AIOS: agentes têm limites de autoridade.

  • @dev pode fazer git commit mas não pode fazer git push (delegar ao @devops)
  • @po pode validar stories mas não pode editar critérios de aceitação após validação
  • Apenas @devops pode criar PRs e fazer push para o remoto

Crie sua Primeira Story

# Passo 1: Criar um rascunho de story
@sm *draft

O Scrum Master vai guiá-lo na criação de um arquivo de story com título, descrição, critérios de aceitação e escopo.

# Passo 2: Validar a story
@po *validate-story-draft

O Product Owner executa o checklist de 10 pontos. Se a nota for ≥ 7/10, a story muda de Draft para Ready.

# Passo 3: Revise o arquivo de story gerado
# As stories são salvas em docs/stories/

Minuto 35-50: Executando um Workflow (SDC)

O Ciclo de Desenvolvimento de Stories

O SDC é o workflow principal do AIOS, com 4 fases:

FaseAgenteO que Acontece
1. Criar@smStory rascunhada a partir de epic/PRD
2. Validar@poChecklist de 10 pontos, decisão GO/NO-GO
3. Implementar@devCódigo escrito, CodeRabbit self-healing
4. QA Gate@qaVerificação de qualidade em 7 pontos, veredicto

Implemente sua Story

# Iniciar implementação (modo interativo por padrão)
@dev *develop {story-id}

O agente desenvolvedor trabalha em um de três modos:

  • Interactive (padrão) — 5-10 prompts com checkpoints e confirmações
  • YOLO — Execução autônoma com 0-1 prompts; decisões registradas automaticamente
  • Pre-Flight — Todas as perguntas feitas antecipadamente, depois execução sem ambiguidade

Durante a implementação, o CodeRabbit escaneia automaticamente por problemas:

  • Problemas de severidade CRITICAL e HIGH são corrigidos automaticamente (até 2 iterações)
  • Problemas MEDIUM são documentados como débito técnico
  • Problemas LOW são ignorados

Minuto 50-60: Quality Gates e Próximos Passos

Execute o QA Gate

@qa *qa-gate

O agente de QA verifica 7 dimensões de qualidade:

  1. Code review (padrões, legibilidade)
  2. Testes unitários (cobertura, todos passando)
  3. Critérios de aceitação (todos atendidos)
  4. Sem regressões
  5. Performance
  6. Segurança (básicos do OWASP)
  7. Documentação

Veredictos possíveis: PASS, CONCERNS, FAIL, WAIVED

Entregue suas Alterações

Se o QA gate passar:

# Revise suas alterações
git diff
 
# Envie para o remoto (apenas @devops pode fazer isso)
@devops *push

O que Você Conquistou

Em 60 minutos você:

  • Instalou e configurou o Synkra AIOS
  • Aprendeu o conceito de meta-agente e comandos essenciais
  • Ativou agentes e entendeu limites de autoridade
  • Criou e validou sua primeira story
  • Executou o Story Development Cycle com integração CodeRabbit
  • Passou por um quality gate e entregou suas alterações

Próximos Passos

Agora que você domina o básico, explore estes recursos:

Last updated on
Início RápidoVisão Geral