Trilhas por Papel

Caminhos de aprendizado organizados com base no seu papel na equipe. Cada trilha contém links para conteúdo verificado — sem documentação duplicada.

Trilha do Novo Usuário

Para: Qualquer pessoa nova no Synkra AIOS | Tempo: 1-2 horas

Comece aqui se você nunca usou o AIOS antes.

1. Guia de Início Rápido — Instale o AIOS e execute seu primeiro comando (5 passos, menos de 10 min)
2. Onboarding em 60 Minutos — Passo a passo completo: todos os 12 agentes, SDC, quality gates
3. Agentes — Conheça todos os agentes, seus nomes e comandos
4. Cheat Sheet — Sequências para copiar e colar no dia a dia

Após completar esta trilha, escolha uma trilha específica por papel abaixo.

Trilha do Desenvolvedor

Para: Desenvolvedores de software | Foco no agente: @dev (Dex)

Aprenda o desenvolvimento diário com AIOS: ativando agentes, implementando stories, executando verificações de qualidade e entregando código.

1. Agentes — Foco em Dex (@dev), Gage (@devops), Quinn (@qa)
2. Story Development Cycle — O workflow principal de 4 fases
3. Comandos Especializados — Comandos de @dev, @qa e @devops
4. QA Loop — Ciclo automatizado de revisão-correção
5. Checklists de Validação — Padrões de qualidade que seu código deve atender
6. Cheat Sheet — Sequências de comandos do dia a dia

Comandos principais a aprender:

• @dev *develop {story-id} — Iniciar implementação (modo Interactive, YOLO ou Pre-Flight)
• @qa *qa-gate — Executar o quality gate de 7 pontos
• @devops *push — Entregar (delegado, apenas Gage pode fazer push)

Trilha do Gerente de Projetos

Para: Gerentes de projeto e de produto | Foco no agente: @pm (Morgan)

Aprenda a gerenciar epics, executar o spec pipeline e coordenar sprints.

1. Agentes — Foco em Morgan (@pm), River (@sm), Pax (@po)
2. Spec Pipeline — Transforme requisitos em specs executáveis
3. Comandos Especializados — Comandos de @pm e @sm
4. Checklists de Validação — Checklist de PM/Gestão de Mudanças e pontuação de complexidade
5. Templates — Templates de PRD e documentação

Comandos principais a aprender:

• @pm *create-epic — Criar um novo epic
• @pm *execute-epic — Executar um plano de epic
• @pm *create-doc prd — Gerar um PRD

Classes de complexidade do Spec Pipeline: SIMPLE (≤ 8 pts), STANDARD (9-15), COMPLEX (≥ 16)

Trilha do Engenheiro de QA

Para: Engenheiros de qualidade | Foco no agente: @qa (Quinn)

Aprenda quality gates, o QA loop e a integração com CodeRabbit.

1. Agentes — Foco em Quinn (@qa)
2. Story Development Cycle — Foco na Fase 4: QA Gate
3. QA Loop — Ciclo automatizado de revisão-correção (até 5 iterações)
4. Checklists de Validação — Checklist de 7 pontos do QA gate, critérios de veredicto, severidade CodeRabbit
5. Comandos Especializados — Comandos de @qa

Comandos principais a aprender:

• @qa *qa-gate — Quality gate de 7 pontos
• *qa-loop {storyId} — Ciclo automatizado de revisão-correção
• *stop-qa-loop / *resume-qa-loop — Pausar e retomar
• *escalate-qa-loop — Forçar escalação manual

Veredictos do gate: PASS, CONCERNS, FAIL, WAIVED

Trilha do Arquiteto

Para: Tech leads e arquitetos de software | Foco no agente: @architect (Aria)

Aprenda design de sistemas, avaliação de brownfield e orientação técnica usando o AIOS.

1. Agentes — Foco em Aria (@architect), Dara (@data-engineer), Atlas (@analyst)
2. Spec Pipeline — Avaliação de complexidade e planejamento de implementação
3. Checklists de Validação — Checklist de revisão de arquitetura
4. Comandos do Master Agent — Comandos IDS para decisões REUSE/ADAPT/CREATE

Comandos principais a aprender:

• @architect *create-full-stack-architecture — Gerar documentação completa de arquitetura
• @architect *execute-checklist architect-checklist — Revisão de arquitetura
• *ids check {intent} — Deve ser REUSE, ADAPT ou CREATE?

Fases do Brownfield Discovery: Coleta de Dados (1-3), Rascunho e Validação (4-7), Finalização (8-10)

Trilha do Product Owner

Para: Product owners responsáveis pela qualidade das stories | Foco no agente: @po (Pax)

Aprenda a validar stories, gerenciar prioridades do backlog e garantir alinhamento com os objetivos de negócio.

1. Agentes — Foco em Pax (@po)
2. Story Development Cycle — Foco na Fase 2: Validação
3. Checklists de Validação — O checklist de validação de story de 10 pontos
4. Templates — Templates de stories e padrões de documentação

Comandos principais a aprender:

• @po *validate-story-draft — Executar o checklist de validação de 10 pontos
• Decisão: GO (≥ 7/10) → story vai para Ready; NO-GO → correções necessárias

Trilha do Scrum Master

Para: Scrum masters e facilitadores de equipe | Foco no agente: @sm (River)

Aprenda a criar stories, facilitar o planejamento de sprints e coordenar o workflow de desenvolvimento.

1. Agentes — Foco em River (@sm)
2. Story Development Cycle — Foco na Fase 1: Criação de Story
3. Comandos Especializados — Comandos de @sm
4. Checklists de Validação — Ciclo de vida e transições de status da story

Comandos principais a aprender:

• @sm *draft — Criar uma nova story a partir de epic/PRD
• @sm *create-story — Comando alternativo de criação de story

Escolhendo sua Trilha