create-genia-os 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/bin/index.js +210 -0
  2. package/package.json +39 -0
  3. package/template/.claude/CLAUDE.md +215 -0
  4. package/template/.claude/agent-memory/analyst/MEMORY.md +20 -0
  5. package/template/.claude/agent-memory/architect/MEMORY.md +20 -0
  6. package/template/.claude/agent-memory/dev/MEMORY.md +20 -0
  7. package/template/.claude/agent-memory/devops/MEMORY.md +20 -0
  8. package/template/.claude/agent-memory/pm/MEMORY.md +20 -0
  9. package/template/.claude/agent-memory/po/MEMORY.md +20 -0
  10. package/template/.claude/agent-memory/qa/MEMORY.md +20 -0
  11. package/template/.claude/agent-memory/reviewer/MEMORY.md +20 -0
  12. package/template/.claude/agent-memory/sm/MEMORY.md +20 -0
  13. package/template/.claude/hooks/enforce-git-push-authority.py +70 -0
  14. package/template/.claude/hooks/precompact-session-digest.cjs +87 -0
  15. package/template/.claude/hooks/sql-governance.py +65 -0
  16. package/template/.claude/hooks/synapse-engine.cjs +122 -0
  17. package/template/.claude/hooks/write-path-validation.py +59 -0
  18. package/template/.claude/rules/agent-authority.md +39 -0
  19. package/template/.claude/rules/agent-handoff.md +71 -0
  20. package/template/.claude/rules/agent-memory.md +61 -0
  21. package/template/.claude/rules/ids-principles.md +52 -0
  22. package/template/.claude/rules/mcp-usage.md +49 -0
  23. package/template/.claude/rules/story-lifecycle.md +87 -0
  24. package/template/.claude/rules/workflow-execution.md +68 -0
  25. package/template/.claude/settings.json +58 -0
  26. package/template/.claude/settings.local.json +14 -0
  27. package/template/.genia/CONSTITUTION.md +129 -0
  28. package/template/.genia/contexts/api-patterns.md +134 -0
  29. package/template/.genia/contexts/nextjs-react.md +210 -0
  30. package/template/.genia/contexts/projeto.md +18 -0
  31. package/template/.genia/contexts/supabase.md +152 -0
  32. package/template/.genia/contexts/whatsapp-cloud.md +176 -0
  33. package/template/.genia/core-config.yaml +192 -0
  34. package/template/.genia/development/agents/analyst.md +138 -0
  35. package/template/.genia/development/agents/architect.md +171 -0
  36. package/template/.genia/development/agents/dev.md +160 -0
  37. package/template/.genia/development/agents/devops.md +200 -0
  38. package/template/.genia/development/agents/pm.md +142 -0
  39. package/template/.genia/development/agents/po.md +165 -0
  40. package/template/.genia/development/agents/qa.md +183 -0
  41. package/template/.genia/development/agents/reviewer.md +198 -0
  42. package/template/.genia/development/agents/sm.md +230 -0
  43. package/template/.genia/development/checklists/architecture-review.md +189 -0
  44. package/template/.genia/development/checklists/pre-commit.md +205 -0
  45. package/template/.genia/development/checklists/pre-deploy.md +230 -0
  46. package/template/.genia/development/checklists/qa-gate.md +216 -0
  47. package/template/.genia/development/checklists/story-dod.md +155 -0
  48. package/template/.genia/development/tasks/code-review.md +197 -0
  49. package/template/.genia/development/tasks/criar-prd.md +170 -0
  50. package/template/.genia/development/tasks/criar-spec.md +188 -0
  51. package/template/.genia/development/tasks/criar-story.md +185 -0
  52. package/template/.genia/development/tasks/debug-sistematico.md +230 -0
  53. package/template/.genia/development/tasks/dev-implement.md +199 -0
  54. package/template/.genia/development/tasks/qa-review.md +224 -0
  55. package/template/.genia/development/workflows/brownfield.md +178 -0
  56. package/template/.genia/development/workflows/delivery.md +208 -0
  57. package/template/.genia/development/workflows/development.md +189 -0
  58. package/template/.genia/development/workflows/greenfield.md +166 -0
  59. package/template/.genia/development/workflows/planning.md +167 -0
  60. package/template/.genia/development/workflows/qa-loop.md +179 -0
  61. package/template/.genia/development/workflows/spec-pipeline.md +192 -0
  62. package/template/.genia/development/workflows/story-development-cycle.md +252 -0
  63. package/template/.genia/guidelines/clean-code.md +98 -0
  64. package/template/.genia/guidelines/testing.md +176 -0
  65. package/template/.genia/skills/design/canvas-design.md +109 -0
  66. package/template/.genia/skills/design/frontend-design.md +140 -0
  67. package/template/.genia/skills/dev/mcp-builder.md +172 -0
  68. package/template/.genia/skills/dev/webapp-testing.md +150 -0
  69. package/template/.genia/skills/documents/docx.md +153 -0
  70. package/template/.genia/skills/documents/pdf.md +134 -0
  71. package/template/.genia/skills/documents/pptx.md +118 -0
  72. package/template/.genia/skills/documents/xlsx.md +140 -0
  73. package/template/.synapse/agent-analyst +8 -0
  74. package/template/.synapse/agent-architect +8 -0
  75. package/template/.synapse/agent-dev +8 -0
  76. package/template/.synapse/agent-devops +8 -0
  77. package/template/.synapse/agent-pm +8 -0
  78. package/template/.synapse/agent-po +7 -0
  79. package/template/.synapse/agent-qa +8 -0
  80. package/template/.synapse/agent-reviewer +7 -0
  81. package/template/.synapse/agent-sm +7 -0
  82. package/template/.synapse/constitution +7 -0
  83. package/template/.synapse/context +8 -0
  84. package/template/.synapse/global +8 -0
  85. package/template/.synapse/manifest +14 -0
  86. package/template/README.md +53 -0
@@ -0,0 +1,189 @@
1
+ # Workflow: Development
2
+
3
+ > Fase de execução do desenvolvimento. Transforma stories validadas em código entregue.
4
+ > Ordem: @sm → @dev → @qa → @reviewer → @devops
5
+
6
+ ---
7
+
8
+ ## Visão Geral
9
+
10
+ O workflow Development é a fase de execução, onde stories validadas se tornam código funcional. Ele opera em paralelo com o planejamento do próximo sprint e segue rigorosamente o Story Development Cycle (SDC) para cada story.
11
+
12
+ **Quando usar:** Sprint ativo com stories em status Ready
13
+ **Pré-requisito:** Sprint planejado com stories validadas por @po
14
+ **Duração:** Contínuo durante o sprint (1-2 semanas típicas)
15
+
16
+ ---
17
+
18
+ ## Responsabilidades por Agente
19
+
20
+ ### @sm — Facilitação e Acompanhamento
21
+ - Facilita daily stand-ups (assíncrono ou síncrono)
22
+ - Remove impedimentos que bloqueiam @dev
23
+ - Monitora velocity e saúde do sprint
24
+ - Atualiza status das stories no backlog
25
+ - Comunica riscos de prazo para @pm
26
+
27
+ ### @dev — Execução
28
+ - Implementa uma story por vez (evitar WIP alto)
29
+ - Segue o SDC rigorosamente para cada story
30
+ - Comunica blockers imediatamente
31
+ - Atualiza status da story quando muda de fase
32
+ - Não começa nova story sem a anterior estar In QA
33
+
34
+ ### @qa — Qualidade Contínua
35
+ - Disponível para revisão assim que @dev declara pronto
36
+ - Executa o QA Loop (máx 5 iterações)
37
+ - Não acumula stories — revisa uma por vez
38
+ - Pode revisar spec de stories futuras enquanto aguarda dev
39
+
40
+ ### @reviewer — Code Review Ágil
41
+ - Revisa código assim que @qa aprova
42
+ - Objetivo: máximo 24h de tempo de review
43
+ - Não bloqueia por questões menores sem impacto real
44
+ - Aprova com confiança ou solicita mudanças bloqueantes
45
+
46
+ ### @devops — Delivery Contínuo
47
+ - Mantém CI/CD pipeline funcionando
48
+ - Faz push e cria PR assim que @reviewer aprova
49
+ - Monitora ambiente de staging
50
+ - Alerta time sobre problemas de infraestrutura
51
+
52
+ ---
53
+
54
+ ## Fluxo Visual do Desenvolvimento
55
+
56
+ ```
57
+ STORIES READY (backlog do sprint)
58
+
59
+
60
+ @dev pega story → InProgress
61
+
62
+
63
+ @dev conclui → notifica @qa
64
+
65
+
66
+ @qa revisa (QA Loop máx 5x)
67
+
68
+ ┌────┴────┐
69
+ REPROVADO APROVADO
70
+ │ │
71
+ @dev corrige @reviewer revisa
72
+ │ │
73
+ └───────┐ ┌────┴────┐
74
+ (loop) CHANGES LGTM
75
+ │ │
76
+ @dev corrige @devops
77
+ │ │
78
+ @reviewer git push + PR
79
+ re-aprova │
80
+ │ ▼
81
+ └──────→ DONE
82
+ ```
83
+
84
+ ---
85
+
86
+ ## Daily Stand-up (Assíncrono)
87
+
88
+ Cada agente reporta diariamente:
89
+
90
+ ```markdown
91
+ ## Daily — YYYY-MM-DD
92
+
93
+ ### @dev
94
+ - Ontem: [o que foi feito]
95
+ - Hoje: [o que será feito]
96
+ - Blocker: [impedimento ou "sem blocker"]
97
+ - Story atual: STORY-XXX (status: InProgress | InQA | etc.)
98
+
99
+ ### @qa
100
+ - Ontem: [revisões concluídas]
101
+ - Hoje: [o que será revisado]
102
+ - Blocker: [impedimento ou "sem blocker"]
103
+
104
+ ### @devops
105
+ - Status do pipeline: [verde | amarelo | vermelho]
106
+ - PRs pendentes: [X PRs aguardando merge]
107
+ - Alertas: [qualquer problema de infraestrutura]
108
+ ```
109
+
110
+ ---
111
+
112
+ ## Gestão de WIP (Work In Progress)
113
+
114
+ Para garantir fluxo, o GEN.IA OS recomenda limites de WIP:
115
+
116
+ | Agente | WIP Máximo | Por quê |
117
+ |--------|-----------|---------|
118
+ | @dev | 1 story por vez | Foco garante qualidade |
119
+ | @qa | 1 story em revisão ativa | Profundidade na revisão |
120
+ | @reviewer | 2 reviews simultâneos | Viabilidade de resposta rápida |
121
+ | @devops | Sem limite | Operacional, menos cognitivo |
122
+
123
+ ---
124
+
125
+ ## Gestão de Blockers
126
+
127
+ Quando um blocker é identificado:
128
+
129
+ 1. **@dev identifica** — declara o blocker imediatamente no daily
130
+ 2. **@sm registra** — cria registro formal do blocker
131
+ 3. **@sm tenta remover** — em até 2 horas na maioria dos casos
132
+ 4. **Se não resolvível:**
133
+ - Blocker técnico → @architect
134
+ - Blocker de requisito → @po → @pm
135
+ - Blocker de infraestrutura → @devops
136
+ 5. **@sm comunica impacto** — informa @pm se o blocker ameaça o sprint
137
+
138
+ ```markdown
139
+ ## Blocker #XXX — [Título]
140
+ Data: YYYY-MM-DD
141
+ Story afetada: STORY-XXX
142
+ Agente bloqueado: @dev
143
+ Descrição: [o que está impedindo o progresso]
144
+ Responsável por remover: [@architect | @po | @devops]
145
+ Status: Aberto | Em Resolução | Resolvido
146
+ ```
147
+
148
+ ---
149
+
150
+ ## Métricas de Saúde do Sprint
151
+
152
+ @sm monitora e reporta semanalmente:
153
+
154
+ | Métrica | Fórmula | Meta |
155
+ |---------|---------|------|
156
+ | Velocity | Pontos entregues / sprint | Histórico + 10% |
157
+ | Lead Time | Draft → Done (dias) | < 5 dias por story |
158
+ | Cycle Time | InProgress → Done (dias) | < 3 dias por story |
159
+ | Bug Rate | Bugs críticos em QA / story | < 1 por sprint |
160
+ | Rework Rate | Stories que voltaram de QA | < 30% |
161
+
162
+ ---
163
+
164
+ ## Critérios de Encerramento do Sprint
165
+
166
+ O sprint é encerrado quando:
167
+
168
+ - [ ] Todas as stories comprometidas estão em Done ou formalmente movidas para o próximo sprint
169
+ - [ ] Todas as histórias em Done têm PR mergeado
170
+ - [ ] Nenhum bug crítico pendente
171
+ - [ ] @po validou todas as stories como Done
172
+ - [ ] Sprint Review preparado por @pm
173
+ - [ ] Retrospectiva agendada por @sm
174
+
175
+ ---
176
+
177
+ ## Sprint Review (Fim de Sprint)
178
+
179
+ Facilitado por @pm e @po:
180
+
181
+ 1. @pm apresenta o objetivo do sprint e se foi atingido
182
+ 2. @dev demonstra as stories entregues
183
+ 3. @po valida formalmente as stories (se não validou durante o sprint)
184
+ 4. Stakeholders dão feedback sobre o entregue
185
+ 5. @pm atualiza o roadmap com base no que foi entregue e no feedback
186
+
187
+ ---
188
+
189
+ *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*
@@ -0,0 +1,166 @@
1
+ # Workflow: Greenfield
2
+
3
+ > Para projetos que começam do zero. Constrói a fundação certa desde o primeiro dia.
4
+ > Ordem: @analyst → @pm → @architect → @devops → @sm + @po → SDC
5
+
6
+ ---
7
+
8
+ ## Visão Geral
9
+
10
+ O workflow Greenfield é usado quando o projeto não tem código existente, repositório configurado ou infraestrutura em funcionamento. Ele garante que a fundação técnica e de processo seja construída corretamente antes que qualquer funcionalidade seja desenvolvida.
11
+
12
+ **Quando usar:** Projeto novo, sem código legado, sem infraestrutura existente
13
+ **Duração típica:** 1-2 semanas para a fundação completa
14
+ **Pré-requisito:** Aprovação formal do projeto por @pm
15
+
16
+ ---
17
+
18
+ ## Fase 1 — Discovery e Briefing (@analyst)
19
+
20
+ **Responsável:** Ana (@analyst)
21
+ **Output:** `docs/[projeto]/BRIEFING.md`
22
+
23
+ ### O que acontece:
24
+ 1. @analyst conduz sessões de discovery com todos os stakeholders relevantes
25
+ 2. Mapeia o problema de negócio, objetivos e métricas de sucesso
26
+ 3. Define personas de usuário com base em pesquisa
27
+ 4. Identifica todas as integrações necessárias (APIs, sistemas legados)
28
+ 5. Mapeia restrições regulatórias, de compliance ou tecnologia obrigatória
29
+ 6. Documenta riscos de negócio identificados
30
+
31
+ ### Entregáveis:
32
+ - `docs/[projeto]/BRIEFING.md` validado com stakeholders
33
+ - Lista de personas definidas
34
+ - Mapa de integrações necessárias
35
+ - Riscos de negócio documentados
36
+
37
+ ---
38
+
39
+ ## Fase 2 — Spec Pipeline Completo
40
+
41
+ **Workflow:** Executa o [Spec Pipeline](./spec-pipeline.md) completo
42
+
43
+ @analyst → @pm → @architect → @qa (critique) → @po
44
+
45
+ Ao final desta fase:
46
+ - `docs/[projeto]/BRIEFING.md` — completo
47
+ - `docs/[projeto]/PRD.md` — aprovado
48
+ - `docs/[projeto]/SPEC-TECNICO.md` — aprovado
49
+ - ADRs iniciais registrados
50
+
51
+ ---
52
+
53
+ ## Fase 3 — Decisões Arquiteturais Finais (@architect)
54
+
55
+ **Responsável:** Arqui (@architect)
56
+ **Output:** ADRs de fundação + plano de estrutura do repositório
57
+
58
+ ### O que acontece:
59
+ 1. @architect define a estrutura completa de pastas do projeto
60
+ 2. Configura o `tsconfig.json` (imports absolutos `@/`)
61
+ 3. Define configurações de linting (ESLint, Prettier)
62
+ 4. Especifica as ferramentas de teste e configurações
63
+ 5. Define a estratégia de gerenciamento de estado
64
+ 6. Documenta padrões de nomenclatura e convenções
65
+ 7. Registra ADRs para cada decisão relevante
66
+
67
+ ### Entregáveis:
68
+ - Estrutura de pastas documentada
69
+ - Configurações de ferramentas especificadas
70
+ - Padrões de código documentados
71
+ - ADRs de fundação registrados
72
+
73
+ ---
74
+
75
+ ## Fase 4 — Setup da Fundação (@devops)
76
+
77
+ **Responsável:** Gate (@devops)
78
+ **Output:** Repositório configurado, CI/CD ativo, ambientes criados
79
+
80
+ ### O que acontece:
81
+ 1. @devops cria/configura o repositório no GitHub
82
+ 2. Configura branch protection rules para `main`
83
+ 3. Configura o pipeline CI/CD:
84
+ - GitHub Actions ou equivalente
85
+ - Stages: lint → test → build → deploy-staging
86
+ 4. Cria os ambientes:
87
+ - `development` (local)
88
+ - `staging` (homologação)
89
+ - `production` (produção)
90
+ 5. Configura secrets e variáveis de ambiente
91
+ 6. Configura MCP tools necessárias (@architect define quais)
92
+ 7. Inicializa o projeto com o boilerplate aprovado pelo @architect
93
+
94
+ ### Checklist de setup:
95
+ - [ ] Repositório criado com README inicial
96
+ - [ ] `.gitignore` configurado
97
+ - [ ] Branch protection em `main` ativado
98
+ - [ ] CI/CD pipeline configurado e testado
99
+ - [ ] Ambientes de staging e production configurados
100
+ - [ ] Secrets configurados (sem exposição em código)
101
+ - [ ] `tsconfig.json` com paths absolutos (`@/`)
102
+ - [ ] ESLint + Prettier configurados
103
+ - [ ] Framework de testes configurado
104
+ - [ ] Build inicial funcionando
105
+ - [ ] Deploy de staging funcionando
106
+
107
+ ---
108
+
109
+ ## Fase 5 — Épicos e Stories do Sprint 1 (@sm + @po)
110
+
111
+ **Responsáveis:** Sami (@sm) + Pax (@po)
112
+ **Output:** Backlog inicial priorizado com stories do Sprint 1 validadas
113
+
114
+ ### O que acontece:
115
+ 1. @sm e @po fazem breakdown dos Épicos do PRD em stories
116
+ 2. @sm cria as stories do Sprint 1 (stories de setup/fundação primeiro)
117
+ 3. @po valida cada story com o checklist 10-point
118
+ 4. Backlog priorizado e Sprint 1 definido
119
+ 5. @sm conduz Sprint Planning com @dev
120
+
121
+ ### Ordem recomendada de stories para o primeiro sprint:
122
+ 1. Story de configuração de autenticação/autorização (se necessário)
123
+ 2. Story de estrutura de layout base (se front-end)
124
+ 3. Story de conexão com banco de dados (se back-end)
125
+ 4. Primeira funcionalidade de valor de negócio
126
+
127
+ ---
128
+
129
+ ## Fase 6 — Desenvolvimento (SDC por Story)
130
+
131
+ **Workflow:** Executa o [Story Development Cycle](./story-development-cycle.md) para cada story
132
+
133
+ Para cada story do Sprint 1:
134
+ ```
135
+ @sm (Draft) → @po (Ready) → @dev (Develop) → @qa (QA) → @reviewer (Review) → @devops (PR) → @po (Done)
136
+ ```
137
+
138
+ ---
139
+
140
+ ## Marcos do Greenfield
141
+
142
+ | Marco | Agente | Entregável |
143
+ |-------|--------|-----------|
144
+ | M1 | @analyst | BRIEFING.md validado |
145
+ | M2 | @pm | PRD.md aprovado |
146
+ | M3 | @architect | SPEC-TECNICO.md + ADRs |
147
+ | M4 | @devops | Infra funcionando (CI verde em staging) |
148
+ | M5 | @sm + @po | Sprint 1 planejado |
149
+ | M6 | @dev + time | Primeira story Done |
150
+ | M7 | @pm | MVP em staging para validação |
151
+
152
+ ---
153
+
154
+ ## Riscos Comuns em Projetos Greenfield
155
+
156
+ | Risco | Prevenção |
157
+ |-------|----------|
158
+ | Escopo mal definido | Spec Pipeline completo obrigatório |
159
+ | Setup técnico adiado | Fase 4 (Setup) acontece ANTES do desenvolvimento |
160
+ | Stories mal escritas | Validação 10-point de @po obrigatória |
161
+ | Infraestrutura ignorada | @devops tem fase própria com checklist |
162
+ | Debt técnico desde o início | @architect define padrões antes do primeiro commit |
163
+
164
+ ---
165
+
166
+ *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*
@@ -0,0 +1,167 @@
1
+ # Workflow: Planning
2
+
3
+ > Fase de planejamento de produto e sprint. Transforma visão em plano executável.
4
+ > Ordem: @analyst → @pm → @architect → @po → @sm
5
+
6
+ ---
7
+
8
+ ## Visão Geral
9
+
10
+ O workflow Planning engloba todas as atividades de planejamento que antecedem o desenvolvimento. Ele pode ser executado no início de um projeto (em conjunto com o Spec Pipeline) ou de forma recorrente para planejamento de novos épicos ou sprints.
11
+
12
+ **Quando usar:**
13
+ - Início de projeto (primeiro planejamento)
14
+ - Planejamento de novo épico ou ciclo de produto
15
+ - Sprint Planning recorrente
16
+ - Revisão de roadmap
17
+
18
+ **Duração típica:** 1-3 dias por ciclo de planejamento
19
+
20
+ ---
21
+
22
+ ## Fase 1 — Alinhamento de Contexto (@analyst)
23
+
24
+ **Responsável:** Ana (@analyst)
25
+ **Output:** Contexto atualizado para planejamento
26
+
27
+ ### O que acontece:
28
+ 1. @analyst garante que o briefing está atualizado com novos requisitos ou mudanças de contexto
29
+ 2. Pesquisa mudanças de mercado ou regulatórias relevantes
30
+ 3. Coleta feedback de usuários do ciclo anterior
31
+ 4. Documenta novos requisitos identificados
32
+ 5. Passa contexto atualizado para @pm
33
+
34
+ ### Não é necessário quando:
35
+ - O planejamento é para um sprint dentro de um épico já definido
36
+ - O briefing do projeto foi feito recentemente e não houve mudanças
37
+
38
+ ---
39
+
40
+ ## Fase 2 — Definição de Escopo e PRD (@pm)
41
+
42
+ **Responsável:** Marina (@pm)
43
+ **Output:** Escopo do ciclo definido, PRD atualizado
44
+
45
+ ### O que acontece:
46
+ 1. @pm revisa o roadmap atual e define foco do próximo ciclo
47
+ 2. Seleciona épicos e features para o período
48
+ 3. Atualiza o PRD com novos itens se necessário
49
+ 4. Define objetivos e métricas do ciclo
50
+ 5. Alinha com stakeholders sobre prioridades
51
+ 6. Comunica mudanças de escopo para o time
52
+
53
+ ### Entregáveis:
54
+ - Escopo do ciclo documentado
55
+ - PRD.md atualizado (se houver novos épicos)
56
+ - Objetivos e métricas do ciclo definidos
57
+
58
+ ---
59
+
60
+ ## Fase 3 — Revisão Técnica e Capacidade (@architect)
61
+
62
+ **Responsável:** Arqui (@architect)
63
+ **Output:** Avaliação de viabilidade técnica + estimativas de complexidade
64
+
65
+ ### O que acontece:
66
+ 1. @architect revisa o escopo proposto por @pm
67
+ 2. Avalia viabilidade técnica de cada item
68
+ 3. Identifica riscos técnicos para o período
69
+ 4. Propõe soluções para itens complexos
70
+ 5. Estima complexidade técnica dos épicos
71
+ 6. Pode exercer veto técnico com alternativas
72
+
73
+ ### Importante:
74
+ Planning não é o momento de definir a solução completa — é o momento de confirmar que é viável e entender a escala do trabalho. A especificação detalhada acontece no Spec Pipeline.
75
+
76
+ ---
77
+
78
+ ## Fase 4 — Refinamento e Priorização (@po)
79
+
80
+ **Responsável:** Pax (@po)
81
+ **Output:** Backlog priorizado para o ciclo
82
+
83
+ ### O que acontece:
84
+ 1. @po revisa o backlog atual com base no escopo definido por @pm
85
+ 2. Aplica priorização com base em:
86
+ - Valor de negócio (impacto nos objetivos do ciclo)
87
+ - Complexidade técnica (estimativas de @architect)
88
+ - Dependências entre stories
89
+ - Risco de negócio (o que acontece se não for entregue?)
90
+ 3. Define o que entra no Sprint 1 do ciclo
91
+ 4. Identifica stories que precisam de mais refinamento antes de entrar no sprint
92
+ 5. Documenta backlog priorizado
93
+
94
+ ### Ferramentas de priorização:
95
+ - **MoSCoW:** Must/Should/Could/Won't
96
+ - **RICE:** Reach × Impact × Confidence / Effort
97
+ - **Value/Effort:** quadrante simples de priorização
98
+
99
+ ---
100
+
101
+ ## Fase 5 — Sprint Planning (@sm)
102
+
103
+ **Responsável:** Sami (@sm)
104
+ **Output:** Sprint planejado com stories commitadas
105
+
106
+ ### O que acontece:
107
+ 1. @sm facilita a sessão de sprint planning
108
+ 2. Apresenta o objetivo do sprint (definido com @po e @pm)
109
+ 3. Cria ou confirma stories necessárias para o sprint
110
+ 4. Garante que todas as stories estão validadas por @po (status: Ready)
111
+ 5. Calcula capacity do sprint baseado em velocity histórica
112
+ 6. Time commita com o volume de stories que cabe na capacity
113
+ 7. Define critérios de sucesso do sprint
114
+
115
+ ### Output do Sprint Planning:
116
+ ```markdown
117
+ # Sprint XX — Planning
118
+
119
+ ## Objetivo do Sprint
120
+ [Uma frase clara do que será entregue ao final do sprint]
121
+
122
+ ## Stories Comprometidas
123
+ | Story | Título | Estimativa | Assignee |
124
+ |-------|--------|-----------|----------|
125
+ | STORY-001 | ... | M | @dev |
126
+ | STORY-002 | ... | P | @dev |
127
+
128
+ ## Capacity
129
+ Velocity histórica: XX pts | Capacity este sprint: XX pts | Total commitado: XX pts
130
+
131
+ ## Critérios de Sucesso do Sprint
132
+ - [ ] [Critério mensurável 1]
133
+ - [ ] [Critério mensurável 2]
134
+
135
+ ## Riscos Identificados
136
+ - [Risco com plano de mitigação]
137
+ ```
138
+
139
+ ---
140
+
141
+ ## Cadência Recomendada
142
+
143
+ | Cerimônia | Frequência | Duração | Facilitador |
144
+ |-----------|-----------|---------|------------|
145
+ | Sprint Planning | A cada sprint | 2-4 horas | @sm |
146
+ | Sprint Review | Fim de sprint | 1-2 horas | @pm + @po |
147
+ | Retrospectiva | Fim de sprint | 1 hora | @sm |
148
+ | Backlog Refinement | Meio do sprint | 1 hora | @po + @sm |
149
+ | Revisão de Roadmap | Mensal | 2 horas | @pm + @po |
150
+
151
+ ---
152
+
153
+ ## Critérios de Saída do Planning
154
+
155
+ O planning está completo quando:
156
+
157
+ - [ ] Objetivo do sprint definido e aprovado por @pm + @po
158
+ - [ ] Stories do sprint com status Ready (validadas por @po)
159
+ - [ ] Capacity calculada e respeitada
160
+ - [ ] Riscos do sprint documentados
161
+ - [ ] @dev tem clareza sobre o que fazer no Sprint 1
162
+ - [ ] @devops está alinhado sobre necessidades de infraestrutura
163
+ - [ ] @architect foi consultado sobre pontos de complexidade alta
164
+
165
+ ---
166
+
167
+ *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*
@@ -0,0 +1,179 @@
1
+ # Workflow: QA Loop
2
+
3
+ > Ciclo iterativo de revisão de qualidade e correção de bugs.
4
+ > Máximo de 5 iterações. Após o limite, escalar para @architect + @pm.
5
+
6
+ ---
7
+
8
+ ## Visão Geral
9
+
10
+ O QA Loop é a fase de qualidade dentro do Story Development Cycle. Ele define um processo rigoroso e limitado de revisão-correção para garantir que o código entregue atende aos acceptance criteria sem criar ciclos infinitos de revisão.
11
+
12
+ **Máximo de iterações:** 5
13
+ **Responsáveis:** @qa (revisão) + @dev (correção)
14
+ **Pré-requisito:** @dev declarou implementação concluída
15
+
16
+ ---
17
+
18
+ ## Fluxo do QA Loop
19
+
20
+ ```
21
+ Iteração 1:
22
+ @qa revisa o código
23
+ → APROVADO → Fim do QA Loop → @reviewer
24
+ → REPROVADO → @dev corrige bugs críticos e altos
25
+
26
+ Iteração 2:
27
+ @qa re-revisa
28
+ → APROVADO → Fim do QA Loop → @reviewer
29
+ → REPROVADO → @dev corrige
30
+
31
+ Iteração 3:
32
+ @qa re-revisa
33
+ → APROVADO → Fim do QA Loop → @reviewer
34
+ → REPROVADO → @dev corrige
35
+
36
+ Iteração 4:
37
+ @qa re-revisa
38
+ → APROVADO → Fim do QA Loop → @reviewer
39
+ → REPROVADO → @dev corrige
40
+
41
+ Iteração 5 (ÚLTIMA):
42
+ @qa re-revisa
43
+ → APROVADO → Fim do QA Loop → @reviewer
44
+ → REPROVADO → ESCALAR para @architect + @pm
45
+ (decisão: refatorar, redefinir escopo ou cancelar story)
46
+ ```
47
+
48
+ ---
49
+
50
+ ## Fase de Revisão (@qa)
51
+
52
+ ### O que @qa verifica em cada iteração:
53
+
54
+ **1. Acceptance Criteria (obrigatório):**
55
+ - [ ] AC-01 verificado com evidência
56
+ - [ ] AC-02 verificado com evidência
57
+ - [ ] AC-03 verificado com evidência
58
+ - [ ] [demais ACs da story]
59
+
60
+ **2. Qualidade do código:**
61
+ - [ ] `npm run lint` — zero warnings ou erros
62
+ - [ ] `npm run typecheck` — zero erros TypeScript
63
+ - [ ] `npm run test` — todos os testes passando
64
+ - [ ] `npm run coverage` — cobertura >= 80%
65
+
66
+ **3. Cenários adicionais:**
67
+ - [ ] Cenários positivos funcionando
68
+ - [ ] Cenários negativos (edge cases) tratados
69
+ - [ ] Mensagens de erro claras e consistentes
70
+ - [ ] Estados de loading/empty/error cobertos (se UI)
71
+
72
+ **4. Segurança básica:**
73
+ - [ ] Sem dados sensíveis expostos
74
+ - [ ] Inputs validados
75
+ - [ ] Autenticação/autorização conforme spec
76
+
77
+ ---
78
+
79
+ ## Documentação de Bugs
80
+
81
+ Para cada bug encontrado, @qa documenta:
82
+
83
+ ```markdown
84
+ ### BUG-QA-XXX — [Título descritivo]
85
+
86
+ **Iteração:** X de 5
87
+ **Severidade:** CRÍTICO | ALTO | MÉDIO | BAIXO
88
+ **AC relacionado:** AC-XX (ou "Fora dos ACs — problema encontrado")
89
+ **Status:** Aberto | Em Correção | Resolvido
90
+
91
+ #### Comportamento Esperado
92
+ [Descrição precisa do que deveria acontecer]
93
+
94
+ #### Comportamento Atual
95
+ [Descrição precisa do que está acontecendo]
96
+
97
+ #### Passos para Reproduzir
98
+ 1. [Passo 1]
99
+ 2. [Passo 2]
100
+ 3. [Passo 3]
101
+
102
+ #### Evidência
103
+ ```
104
+ [Log de erro, stack trace, ou descrição da tela]
105
+ ```
106
+
107
+ #### Critério de Resolução
108
+ [Como @qa saberá que o bug foi corrigido]
109
+ ```
110
+
111
+ ---
112
+
113
+ ## Critérios de Aprovação
114
+
115
+ Para o QA Loop encerrar com APROVADO:
116
+
117
+ | Critério | Obrigatório |
118
+ |---------|------------|
119
+ | Zero bugs CRÍTICOS | Sim |
120
+ | Zero ou máximo 2 bugs ALTOS (documentados) | Sim |
121
+ | Todos os ACs verificados | Sim |
122
+ | Testes passando | Sim |
123
+ | Coverage >= 80% | Sim |
124
+ | Lint sem erros | Sim |
125
+ | Typecheck passando | Sim |
126
+
127
+ Bugs de severidade MÉDIO e BAIXO podem existir se documentados no backlog para correção futura.
128
+
129
+ ---
130
+
131
+ ## Escalada Após 5 Iterações
132
+
133
+ Se após 5 iterações o QA Loop não encerrar com aprovação:
134
+
135
+ 1. **@qa documenta relatório completo** com todos os bugs e histórico de iterações
136
+ 2. **@qa notifica @architect e @pm** com o relatório
137
+ 3. **@architect analisa** se há problema arquitetural subjacente
138
+ 4. **@pm e @architect decidem:**
139
+ - Opção A: Aumentar esforço de dev (@dev faz refatoração completa — nova branch)
140
+ - Opção B: Reduzir escopo da story (remover AC problemático para nova story)
141
+ - Opção C: Cancelar story com documentação de impedimento técnico
142
+
143
+ **A escalada NUNCA é vista como fracasso do @dev — é informação valiosa sobre subestimação de complexidade.**
144
+
145
+ ---
146
+
147
+ ## Relatório Final de QA
148
+
149
+ Ao encerrar o QA Loop, @qa emite relatório:
150
+
151
+ ```markdown
152
+ # Relatório QA — STORY-XXX
153
+ Data: YYYY-MM-DD | QA: Quinn (@qa)
154
+ Iterações: X/5 | Veredicto: APROVADO | REPROVADO
155
+
156
+ ## Acceptance Criteria
157
+ - AC-01: ✅ VERIFICADO
158
+ - AC-02: ✅ VERIFICADO
159
+ - AC-03: ✅ VERIFICADO
160
+
161
+ ## Resultados de Testes
162
+ - Unitários: XX/XX passando
163
+ - Coverage: XX%
164
+ - Lint: limpo
165
+ - Typecheck: limpo
166
+
167
+ ## Bugs Encontrados
168
+ | ID | Título | Severidade | Status |
169
+ |----|--------|-----------|--------|
170
+ | BUG-QA-001 | ... | MÉDIO | Documentado para backlog |
171
+
172
+ ## Conclusão
173
+ [Story aprovada / reprovada] por Quinn (@qa) em YYYY-MM-DD.
174
+ Próximo passo: [@reviewer para code review | escalar]
175
+ ```
176
+
177
+ ---
178
+
179
+ *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*