create-genia-os 2.1.1 → 2.3.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 (89) hide show
  1. package/README.md +117 -11
  2. package/bin/index.js +92 -0
  3. package/package.json +4 -2
  4. package/template/.claude/CLAUDE.md +215 -215
  5. package/template/.claude/agent-memory/analyst/MEMORY.md +20 -20
  6. package/template/.claude/agent-memory/architect/MEMORY.md +20 -20
  7. package/template/.claude/agent-memory/dev/MEMORY.md +20 -20
  8. package/template/.claude/agent-memory/devops/MEMORY.md +20 -20
  9. package/template/.claude/agent-memory/pm/MEMORY.md +20 -20
  10. package/template/.claude/agent-memory/po/MEMORY.md +20 -20
  11. package/template/.claude/agent-memory/qa/MEMORY.md +20 -20
  12. package/template/.claude/agent-memory/reviewer/MEMORY.md +20 -20
  13. package/template/.claude/agent-memory/sm/MEMORY.md +20 -20
  14. package/template/.claude/hooks/enforce-git-push-authority.py +70 -70
  15. package/template/.claude/hooks/metrics-tracker.cjs +65 -0
  16. package/template/.claude/hooks/precompact-session-digest.cjs +87 -87
  17. package/template/.claude/hooks/sql-governance.py +65 -65
  18. package/template/.claude/hooks/synapse-engine.cjs +122 -122
  19. package/template/.claude/hooks/write-path-validation.py +59 -59
  20. package/template/.claude/rules/agent-authority.md +39 -39
  21. package/template/.claude/rules/agent-handoff.md +71 -71
  22. package/template/.claude/rules/agent-memory.md +61 -61
  23. package/template/.claude/rules/ids-principles.md +52 -52
  24. package/template/.claude/rules/mcp-usage.md +49 -49
  25. package/template/.claude/rules/new-project.md +157 -0
  26. package/template/.claude/rules/story-lifecycle.md +87 -87
  27. package/template/.claude/rules/workflow-execution.md +68 -68
  28. package/template/.claude/settings.json +58 -58
  29. package/template/.claude/settings.local.json +14 -14
  30. package/template/.genia/CONSTITUTION.md +129 -129
  31. package/template/.genia/contexts/api-patterns.md +134 -134
  32. package/template/.genia/contexts/nextjs-react.md +210 -210
  33. package/template/.genia/contexts/projeto.md +18 -18
  34. package/template/.genia/contexts/supabase.md +152 -152
  35. package/template/.genia/contexts/whatsapp-cloud.md +176 -176
  36. package/template/.genia/core-config.yaml +192 -192
  37. package/template/.genia/development/agents/analyst.md +138 -138
  38. package/template/.genia/development/agents/architect.md +171 -171
  39. package/template/.genia/development/agents/dev.md +160 -160
  40. package/template/.genia/development/agents/devops.md +200 -200
  41. package/template/.genia/development/agents/pm.md +142 -142
  42. package/template/.genia/development/agents/po.md +165 -165
  43. package/template/.genia/development/agents/qa.md +183 -183
  44. package/template/.genia/development/agents/reviewer.md +198 -198
  45. package/template/.genia/development/agents/sm.md +230 -230
  46. package/template/.genia/development/checklists/architecture-review.md +189 -189
  47. package/template/.genia/development/checklists/pre-commit.md +205 -205
  48. package/template/.genia/development/checklists/pre-deploy.md +230 -230
  49. package/template/.genia/development/checklists/qa-gate.md +216 -216
  50. package/template/.genia/development/checklists/story-dod.md +155 -155
  51. package/template/.genia/development/tasks/code-review.md +197 -197
  52. package/template/.genia/development/tasks/criar-prd.md +170 -170
  53. package/template/.genia/development/tasks/criar-spec.md +188 -188
  54. package/template/.genia/development/tasks/criar-story.md +185 -185
  55. package/template/.genia/development/tasks/debug-sistematico.md +230 -230
  56. package/template/.genia/development/tasks/dev-implement.md +199 -199
  57. package/template/.genia/development/tasks/qa-review.md +224 -224
  58. package/template/.genia/development/workflows/brownfield.md +178 -178
  59. package/template/.genia/development/workflows/delivery.md +208 -208
  60. package/template/.genia/development/workflows/development.md +189 -189
  61. package/template/.genia/development/workflows/greenfield.md +166 -166
  62. package/template/.genia/development/workflows/planning.md +167 -167
  63. package/template/.genia/development/workflows/qa-loop.md +179 -179
  64. package/template/.genia/development/workflows/spec-pipeline.md +192 -192
  65. package/template/.genia/development/workflows/story-development-cycle.md +252 -252
  66. package/template/.genia/guidelines/clean-code.md +98 -98
  67. package/template/.genia/guidelines/testing.md +176 -176
  68. package/template/.genia/skills/design/canvas-design.md +109 -109
  69. package/template/.genia/skills/design/frontend-design.md +140 -140
  70. package/template/.genia/skills/dev/mcp-builder.md +172 -172
  71. package/template/.genia/skills/dev/webapp-testing.md +150 -150
  72. package/template/.genia/skills/documents/docx.md +153 -153
  73. package/template/.genia/skills/documents/pdf.md +134 -134
  74. package/template/.genia/skills/documents/pptx.md +118 -118
  75. package/template/.genia/skills/documents/xlsx.md +140 -140
  76. package/template/.synapse/agent-analyst +8 -8
  77. package/template/.synapse/agent-architect +8 -8
  78. package/template/.synapse/agent-dev +8 -8
  79. package/template/.synapse/agent-devops +8 -8
  80. package/template/.synapse/agent-pm +8 -8
  81. package/template/.synapse/agent-po +7 -7
  82. package/template/.synapse/agent-qa +8 -8
  83. package/template/.synapse/agent-reviewer +7 -7
  84. package/template/.synapse/agent-sm +7 -7
  85. package/template/.synapse/constitution +7 -7
  86. package/template/.synapse/context +8 -8
  87. package/template/.synapse/global +8 -8
  88. package/template/.synapse/manifest +14 -14
  89. package/template/README.md +53 -53
@@ -1,166 +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}}*
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}}*
@@ -1,167 +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}}*
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}}*