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