AIOX — Fluxos de Desenvolvimento

Guia visual de todos os workflows: epic completo e bugfix/ajustes

FASE EPIC — Preparação e Planejamento Executada uma vez por epic, antes de iniciar qualquer story
1
@pm Criar PRD & Epic

Comandos

  • *create-prd — Documento de requisitos (FR, NFR)
  • *gather-requirements — Levantar requisitos
  • *create-epic — Estrutura do epic + story list

Output

  • PRD com requisitos funcionais e não-funcionais
  • docs/stories/epics/epic-{N}/epic-{N}.md
  • Story breakdown com AC e scope
PRD + Epic criados
2
@analyst Pesquisa & Análise STANDARD / COMPLEX

Comandos

  • *perform-market-research — Análise de mercado
  • *create-competitor-analysis — Competidores
  • *research-deps — Pesquisa de dependências
  • *extract-patterns — Padrões do codebase

Output

  • research.json — Findings documentados
  • Restrições e riscos identificados
  • Validação de assumptions do PRD
  • Skip se complexidade SIMPLE (<=8)
Research concluído, contexto enriquecido
3
@architect Arquitetura & Planeamento

Comandos

  • *assess-complexity — Score 5 dimensões (1-5)
  • *create-full-stack-architecture — Design sistema
  • *create-plan — Plano de implementação
  • *create-context — Contexto para stories

Output

  • complexity.json — SIMPLE / STANDARD / COMPLEX
  • Decisões de tecnologia e padrões
  • implementation.yaml — Fases e subtasks
  • Data architecture delegada a @data-engineer
Arquitetura definida, plano de implementação pronto
4
@ux-design-expert UI/UX Design & Spec SE TEM FRONTEND

Comandos

  • *research — User personas, benchmarks
  • *wireframe {fidelity} — Low/high fidelity
  • *create-front-end-spec — Spec de frontend
  • *tokenize — Design tokens (cores, spacing)

Output

  • frontend-spec.md — Especificação visual
  • Wireframes por fidelidade
  • tokens.yaml — Design tokens
  • Skip se epic não envolve UI
Specs visuais prontas, @pm orquestra execução
5
@pm Iniciar Execução do Epic

Comandos

  • *execute-epic — Lança ciclo de stories

Output

  • EPIC-{ID}-EXECUTION.yaml
  • Orquestra wave checkpoints por story
FASE STORY — Repetida para cada story do epic Etapas 6 a 10 executam-se em ciclo atétodas as stories estarem Done
6
@sm Criar Story Detalhada

Comandos

  • *draft — Criar story a partir do epic
  • *story-checklist — Verificar completude

Output

  • {epic}.{story}.story.md
  • Acceptance criteria, tasks, pre-condições
  • Status: Draft
Story criada, aguarda validação
7
@po Validar Story

Comandos

  • *validate-story-draft — Checklist 10 pontos
  • *backlog-prioritize — Priorizar execução
  • *execute-checklist-po — PO quality checklist

Decisão

  • GO (>=7/10) — Draft → Ready
  • NO-GO (<7) — Devolve a @sm com fixes
Story validada (GO), status Ready
8
@dev Implementar

Comandos

  • *develop {story-id} — Modo interativo
  • *develop-yolo — Modo autônomo
  • *run-tests — Executar testes
  • *apply-qa-fixes — Corrigir issues QA

Output

  • Código + testes implementados
  • CodeRabbit self-healing (max 2 iter.)
  • File List + checkboxes atualizados
  • Status: Ready → InProgress
Implementação completa, ready for review
9
@qa QA Gate

Comandos

  • *gate {story} — QA gate completo (7 checks)
  • *review {story} — Code review
  • *security-check — Auditoria segurança
  • *test-design — Desenho de testes

Decisão

  • PASS — InProgress → InReview
  • CONCERNS — Aprovado com notas
  • FAIL — Devolve a @dev (QA Loop)
  • WAIVED — Risco aceite
🔄
QA Loop (max 5 iterações)
FAIL → @dev *apply-qa-fixes → @qa *gate → re-avaliação. Escalation a @aiox-master após5 falhas.
QA PASS — pronto para deploy
10
@devops Push, PR & Deploy

Comandos

  • *pre-push — Lint + test + build + CodeRabbit
  • *push — Git push (EXCLUSIVO @devops)
  • *create-pr — Pull request
  • *release — Tag semântica + changelog

Output

  • Pre-push: 0 CRITICAL (obrigatório)
  • Código pushed + PR criado/merged
  • Versão semântica + release notes
Deploy concluído, story pronta para fechar
✓
@po Fechar Story

Comandos

  • *close-story {story} — Encerrar story
  • *sync-story — Sincronizar estado do epic

Output

  • Status: InReview → Done
  • Epic progress atualizado
  • Sugere próxima story do backlog
  • Volta a etapa 6 se restam stories

Agentes & Personas

@pm Morgan — Product Manager
@analyst Atlas — Business Analyst
@architect Aria — System Architect
@ux-design-expert Uma — UX Designer
@sm River — Scrum Master
@po Pax — Product Owner
@dev Dex — Developer
@qa Quinn — Quality Architect
@devops Gage — DevOps Specialist

Synkra AIOX v2.0 — Story Development Cycle (SDC) + Spec Pipeline

ETAPA 1 — Triagem com @bugfix-triager Classifica o bug e recomenda qual dos 3 fluxos seguir
T
@bugfix-triager Triagem & Classificação

Comandos

  • *triage — Descrever bug, receber recomendação
  • *classify {descrição} — Classificação rapida
  • *batch — Triar múltiplos bugs de uma vez
  • *escalate {descrição} — Escalar a especialista

Output

  • Severidade: LOW / MEDIUM / HIGH / CRITICAL
  • Fluxo recomendado: Rápido / Normal / Completo
  • Causa provável e arquivos afetados
  • Agente de destino para fix

Fluxo Rápido

< 15 minutos • Sem story
Typos, ajustes visuais, config, texto, CSS pontual
@dev fix direto → @devops *push

Fluxo Normal

15 min — 1 hora • Story recomendada
Bugs conhecidos, lógica simples, ajustes de UI com interação
@sm *draft → @dev *develop → @qa *gate → @devops *push

Fluxo Completo

> 1 hora • Story obrigatória
Regressões, bugs cross-service, problemas de dados, security
@sm *draft → @po *validate → @dev *develop → @qa *gate → @devops *push → @po *close
Fluxo Rápido — Fix direto, sem story Para typos, ajustes visuais, config, texto — causa óbvia e localizada
1
@dev Fix Direto

Comandos

  • *develop-yolo — Fix autônomo sem story
  • *run-tests — Verificar que nada partiu

Critérios

  • Causa óbvia e localizada
  • Sem risco de side-effects
  • Alteração em 1-2 arquivos max
Fix aplicado, testes passam
2
@devops Push

Comandos

  • *pre-push — Lint + test + build
  • *push — Git push

Commit convention

  • fix: descrição curta
  • Sem PR se trivial (push direto)
Fluxo Normal — Story recomendada, sem validação PO Para bugs conhecidos, ajustes de lógica simples — 15 min a 1 hora
1
@sm Criar Bug Story

Comandos

  • *draft — Story tipo bug

Output

  • Story com reprodução e expected behavior
  • Status: Draft → Ready (skip PO)
Story criada, skip validação PO
2
@dev Implementar Fix

Comandos

  • *develop {story-id} — ou *develop-yolo
  • *run-tests — Validar fix

Output

  • Fix implementado + teste de regressão
  • Status: Ready → InProgress
Fix pronto, ready for review
3
@qa QA Gate

Comandos

  • *gate {story} — QA gate
  • *review {story} — Code review

Decisão

  • PASS → @devops push
  • FAIL → @dev fix (QA Loop max 5x)
QA PASS
4
@devops Push & Deploy

Comandos

  • *pre-push — Quality gates
  • *push — Git push
  • *create-pr — Se necessário

Commit convention

  • fix: descrição [BUG-{N}]
Fluxo Completo — SDC formal com validação PO Para regressões, bugs cross-service, problemas de security — > 1 hora
1
@sm Criar Bug Story

Comandos

  • *draft — Story tipo bug detalhada

Output

  • Steps to reproduce, root cause analysis
  • Impact assessment, affected services
  • Status: Draft
Story detalhada, aguarda PO
2
@po Validar Story

Comandos

  • *validate-story-draft — Checklist 10 pontos

Decisão

  • GO — Draft → Ready
  • NO-GO — Volta a @sm
Story validada, ready to develop
3
@architect Análise de Impacto SE CROSS-SERVICE

Comandos

  • *assess-complexity — Avaliar impacto
  • *create-plan — Plano de fix

Output

  • Mapa de dependências afectadas
  • Plano de fix com ordem de servicos
  • Skip se bug localizado a 1 servico
Plano de fix definido
4
@dev Implementar Fix

Comandos

  • *develop {story-id} — Modo interativo
  • *run-tests — Testes + regressão
  • *apply-qa-fixes — Se QA loop

Output

  • Fix implementado em todos os servicos
  • Testes de regressão adicionados
  • Status: Ready → InProgress
Fix completo, ready for review
5
@qa QA Gate

Comandos

  • *gate {story} — QA gate completo
  • *security-check — Se bug de security

Decisão

  • PASS → @devops deploy
  • FAIL → QA Loop (max 5x)
🔄
QA Loop (max 5 iterações)
FAIL → @dev *apply-qa-fixes → @qa *gate
QA PASS
6
@devops Push, PR & Deploy

Comandos

  • *pre-push — Quality gates completos
  • *push — Git push
  • *create-pr — Pull request

Commit convention

  • fix: descrição [BUG-{N}]
Deployed, pronto para fechar
✓
@po Fechar Story

Comandos

  • *close-story {story} — Encerrar

Output

  • Status: Done
  • Bug tracker atualizado

Agentes no Fluxo Bugfix

@bugfix-triager Patch — Triagem
@sm River — Cria bug story
@po Pax — Valida (Completo)
@architect Aria — Impacto (Completo)
@dev Dex — Implementa fix
@qa Quinn — Valida fix
@devops Gage — Push & deploy

Synkra AIOX v2.0 — Bugfix Workflow (Rápido / Normal / Completo)