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.
- package/README.md +117 -11
- package/bin/index.js +92 -0
- package/package.json +4 -2
- package/template/.claude/CLAUDE.md +215 -215
- package/template/.claude/agent-memory/analyst/MEMORY.md +20 -20
- package/template/.claude/agent-memory/architect/MEMORY.md +20 -20
- package/template/.claude/agent-memory/dev/MEMORY.md +20 -20
- package/template/.claude/agent-memory/devops/MEMORY.md +20 -20
- package/template/.claude/agent-memory/pm/MEMORY.md +20 -20
- package/template/.claude/agent-memory/po/MEMORY.md +20 -20
- package/template/.claude/agent-memory/qa/MEMORY.md +20 -20
- package/template/.claude/agent-memory/reviewer/MEMORY.md +20 -20
- package/template/.claude/agent-memory/sm/MEMORY.md +20 -20
- package/template/.claude/hooks/enforce-git-push-authority.py +70 -70
- package/template/.claude/hooks/metrics-tracker.cjs +65 -0
- package/template/.claude/hooks/precompact-session-digest.cjs +87 -87
- package/template/.claude/hooks/sql-governance.py +65 -65
- package/template/.claude/hooks/synapse-engine.cjs +122 -122
- package/template/.claude/hooks/write-path-validation.py +59 -59
- package/template/.claude/rules/agent-authority.md +39 -39
- package/template/.claude/rules/agent-handoff.md +71 -71
- package/template/.claude/rules/agent-memory.md +61 -61
- package/template/.claude/rules/ids-principles.md +52 -52
- package/template/.claude/rules/mcp-usage.md +49 -49
- package/template/.claude/rules/new-project.md +157 -0
- package/template/.claude/rules/story-lifecycle.md +87 -87
- package/template/.claude/rules/workflow-execution.md +68 -68
- package/template/.claude/settings.json +58 -58
- package/template/.claude/settings.local.json +14 -14
- package/template/.genia/CONSTITUTION.md +129 -129
- package/template/.genia/contexts/api-patterns.md +134 -134
- package/template/.genia/contexts/nextjs-react.md +210 -210
- package/template/.genia/contexts/projeto.md +18 -18
- package/template/.genia/contexts/supabase.md +152 -152
- package/template/.genia/contexts/whatsapp-cloud.md +176 -176
- package/template/.genia/core-config.yaml +192 -192
- package/template/.genia/development/agents/analyst.md +138 -138
- package/template/.genia/development/agents/architect.md +171 -171
- package/template/.genia/development/agents/dev.md +160 -160
- package/template/.genia/development/agents/devops.md +200 -200
- package/template/.genia/development/agents/pm.md +142 -142
- package/template/.genia/development/agents/po.md +165 -165
- package/template/.genia/development/agents/qa.md +183 -183
- package/template/.genia/development/agents/reviewer.md +198 -198
- package/template/.genia/development/agents/sm.md +230 -230
- package/template/.genia/development/checklists/architecture-review.md +189 -189
- package/template/.genia/development/checklists/pre-commit.md +205 -205
- package/template/.genia/development/checklists/pre-deploy.md +230 -230
- package/template/.genia/development/checklists/qa-gate.md +216 -216
- package/template/.genia/development/checklists/story-dod.md +155 -155
- package/template/.genia/development/tasks/code-review.md +197 -197
- package/template/.genia/development/tasks/criar-prd.md +170 -170
- package/template/.genia/development/tasks/criar-spec.md +188 -188
- package/template/.genia/development/tasks/criar-story.md +185 -185
- package/template/.genia/development/tasks/debug-sistematico.md +230 -230
- package/template/.genia/development/tasks/dev-implement.md +199 -199
- package/template/.genia/development/tasks/qa-review.md +224 -224
- package/template/.genia/development/workflows/brownfield.md +178 -178
- package/template/.genia/development/workflows/delivery.md +208 -208
- package/template/.genia/development/workflows/development.md +189 -189
- package/template/.genia/development/workflows/greenfield.md +166 -166
- package/template/.genia/development/workflows/planning.md +167 -167
- package/template/.genia/development/workflows/qa-loop.md +179 -179
- package/template/.genia/development/workflows/spec-pipeline.md +192 -192
- package/template/.genia/development/workflows/story-development-cycle.md +252 -252
- package/template/.genia/guidelines/clean-code.md +98 -98
- package/template/.genia/guidelines/testing.md +176 -176
- package/template/.genia/skills/design/canvas-design.md +109 -109
- package/template/.genia/skills/design/frontend-design.md +140 -140
- package/template/.genia/skills/dev/mcp-builder.md +172 -172
- package/template/.genia/skills/dev/webapp-testing.md +150 -150
- package/template/.genia/skills/documents/docx.md +153 -153
- package/template/.genia/skills/documents/pdf.md +134 -134
- package/template/.genia/skills/documents/pptx.md +118 -118
- package/template/.genia/skills/documents/xlsx.md +140 -140
- package/template/.synapse/agent-analyst +8 -8
- package/template/.synapse/agent-architect +8 -8
- package/template/.synapse/agent-dev +8 -8
- package/template/.synapse/agent-devops +8 -8
- package/template/.synapse/agent-pm +8 -8
- package/template/.synapse/agent-po +7 -7
- package/template/.synapse/agent-qa +8 -8
- package/template/.synapse/agent-reviewer +7 -7
- package/template/.synapse/agent-sm +7 -7
- package/template/.synapse/constitution +7 -7
- package/template/.synapse/context +8 -8
- package/template/.synapse/global +8 -8
- package/template/.synapse/manifest +14 -14
- 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}}*
|