create-genia-os 2.1.1 → 2.2.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 (88) hide show
  1. package/README.md +154 -154
  2. package/package.json +4 -2
  3. package/template/.claude/CLAUDE.md +215 -215
  4. package/template/.claude/agent-memory/analyst/MEMORY.md +20 -20
  5. package/template/.claude/agent-memory/architect/MEMORY.md +20 -20
  6. package/template/.claude/agent-memory/dev/MEMORY.md +20 -20
  7. package/template/.claude/agent-memory/devops/MEMORY.md +20 -20
  8. package/template/.claude/agent-memory/pm/MEMORY.md +20 -20
  9. package/template/.claude/agent-memory/po/MEMORY.md +20 -20
  10. package/template/.claude/agent-memory/qa/MEMORY.md +20 -20
  11. package/template/.claude/agent-memory/reviewer/MEMORY.md +20 -20
  12. package/template/.claude/agent-memory/sm/MEMORY.md +20 -20
  13. package/template/.claude/hooks/enforce-git-push-authority.py +70 -70
  14. package/template/.claude/hooks/metrics-tracker.cjs +65 -0
  15. package/template/.claude/hooks/precompact-session-digest.cjs +87 -87
  16. package/template/.claude/hooks/sql-governance.py +65 -65
  17. package/template/.claude/hooks/synapse-engine.cjs +122 -122
  18. package/template/.claude/hooks/write-path-validation.py +59 -59
  19. package/template/.claude/rules/agent-authority.md +39 -39
  20. package/template/.claude/rules/agent-handoff.md +71 -71
  21. package/template/.claude/rules/agent-memory.md +61 -61
  22. package/template/.claude/rules/ids-principles.md +52 -52
  23. package/template/.claude/rules/mcp-usage.md +49 -49
  24. package/template/.claude/rules/new-project.md +157 -0
  25. package/template/.claude/rules/story-lifecycle.md +87 -87
  26. package/template/.claude/rules/workflow-execution.md +68 -68
  27. package/template/.claude/settings.json +58 -58
  28. package/template/.claude/settings.local.json +14 -14
  29. package/template/.genia/CONSTITUTION.md +129 -129
  30. package/template/.genia/contexts/api-patterns.md +134 -134
  31. package/template/.genia/contexts/nextjs-react.md +210 -210
  32. package/template/.genia/contexts/projeto.md +18 -18
  33. package/template/.genia/contexts/supabase.md +152 -152
  34. package/template/.genia/contexts/whatsapp-cloud.md +176 -176
  35. package/template/.genia/core-config.yaml +192 -192
  36. package/template/.genia/development/agents/analyst.md +138 -138
  37. package/template/.genia/development/agents/architect.md +171 -171
  38. package/template/.genia/development/agents/dev.md +160 -160
  39. package/template/.genia/development/agents/devops.md +200 -200
  40. package/template/.genia/development/agents/pm.md +142 -142
  41. package/template/.genia/development/agents/po.md +165 -165
  42. package/template/.genia/development/agents/qa.md +183 -183
  43. package/template/.genia/development/agents/reviewer.md +198 -198
  44. package/template/.genia/development/agents/sm.md +230 -230
  45. package/template/.genia/development/checklists/architecture-review.md +189 -189
  46. package/template/.genia/development/checklists/pre-commit.md +205 -205
  47. package/template/.genia/development/checklists/pre-deploy.md +230 -230
  48. package/template/.genia/development/checklists/qa-gate.md +216 -216
  49. package/template/.genia/development/checklists/story-dod.md +155 -155
  50. package/template/.genia/development/tasks/code-review.md +197 -197
  51. package/template/.genia/development/tasks/criar-prd.md +170 -170
  52. package/template/.genia/development/tasks/criar-spec.md +188 -188
  53. package/template/.genia/development/tasks/criar-story.md +185 -185
  54. package/template/.genia/development/tasks/debug-sistematico.md +230 -230
  55. package/template/.genia/development/tasks/dev-implement.md +199 -199
  56. package/template/.genia/development/tasks/qa-review.md +224 -224
  57. package/template/.genia/development/workflows/brownfield.md +178 -178
  58. package/template/.genia/development/workflows/delivery.md +208 -208
  59. package/template/.genia/development/workflows/development.md +189 -189
  60. package/template/.genia/development/workflows/greenfield.md +166 -166
  61. package/template/.genia/development/workflows/planning.md +167 -167
  62. package/template/.genia/development/workflows/qa-loop.md +179 -179
  63. package/template/.genia/development/workflows/spec-pipeline.md +192 -192
  64. package/template/.genia/development/workflows/story-development-cycle.md +252 -252
  65. package/template/.genia/guidelines/clean-code.md +98 -98
  66. package/template/.genia/guidelines/testing.md +176 -176
  67. package/template/.genia/skills/design/canvas-design.md +109 -109
  68. package/template/.genia/skills/design/frontend-design.md +140 -140
  69. package/template/.genia/skills/dev/mcp-builder.md +172 -172
  70. package/template/.genia/skills/dev/webapp-testing.md +150 -150
  71. package/template/.genia/skills/documents/docx.md +153 -153
  72. package/template/.genia/skills/documents/pdf.md +134 -134
  73. package/template/.genia/skills/documents/pptx.md +118 -118
  74. package/template/.genia/skills/documents/xlsx.md +140 -140
  75. package/template/.synapse/agent-analyst +8 -8
  76. package/template/.synapse/agent-architect +8 -8
  77. package/template/.synapse/agent-dev +8 -8
  78. package/template/.synapse/agent-devops +8 -8
  79. package/template/.synapse/agent-pm +8 -8
  80. package/template/.synapse/agent-po +7 -7
  81. package/template/.synapse/agent-qa +8 -8
  82. package/template/.synapse/agent-reviewer +7 -7
  83. package/template/.synapse/agent-sm +7 -7
  84. package/template/.synapse/constitution +7 -7
  85. package/template/.synapse/context +8 -8
  86. package/template/.synapse/global +8 -8
  87. package/template/.synapse/manifest +14 -14
  88. package/template/README.md +53 -53
@@ -1,170 +1,170 @@
1
- # Task: Criar PRD
2
-
3
- > Tarefa executada por @pm após receber o BRIEFING.md de @analyst.
4
- > Output: `docs/[projeto]/PRD.md`
5
-
6
- ---
7
-
8
- ## Objetivo
9
-
10
- Transformar o briefing de negócios em um Product Requirements Document (PRD) completo, priorizado e aprovado por stakeholders. O PRD é o documento de referência que guia todo o desenvolvimento — ele deve ser suficientemente claro para que qualquer agente entenda o que está sendo construído e por quê.
11
-
12
- ---
13
-
14
- ## Pré-requisitos
15
-
16
- Antes de iniciar, confirme:
17
-
18
- - [ ] `docs/[projeto]/BRIEFING.md` existe e está completo
19
- - [ ] @analyst confirmou que o briefing foi validado com stakeholders
20
- - [ ] Todas as ambiguidades do briefing foram resolvidas
21
- - [ ] @pm tem acesso a qualquer material adicional do cliente
22
-
23
- ---
24
-
25
- ## Passos de Execução
26
-
27
- ### Passo 1 — Revisão do Briefing
28
- 1. Leia o BRIEFING.md completamente
29
- 2. Identifique e anote quaisquer pontos que precisam de esclarecimento
30
- 3. Se necessário, solicite esclarecimento a @analyst antes de prosseguir
31
- 4. Nunca assuma — dúvidas são resolvidas antes de escrever o PRD
32
-
33
- ### Passo 2 — Definição da Visão de Produto
34
- 1. Articule o problema central que o produto resolve (em 1-2 parágrafos)
35
- 2. Defina a proposta de valor única (o que diferencia este produto)
36
- 3. Descreva o estado futuro desejado: como fica o mundo com este produto?
37
- 4. Identifique as restrições não-negociáveis (tecnologia, prazo, regulatório)
38
-
39
- ### Passo 3 — Definição de Personas
40
- 1. Liste as personas identificadas no briefing
41
- 2. Para cada persona, defina:
42
- - Nome e perfil
43
- - Objetivos principais ao usar o sistema
44
- - Dores e frustrações atuais
45
- - Nível de expertise técnica
46
- 3. Priorize as personas (primária, secundária)
47
-
48
- ### Passo 4 — Estruturação em Épicos
49
- 1. Agrupe as funcionalidades em Épicos coesos:
50
- - Cada épico é um conjunto de funcionalidades relacionadas
51
- - Épicos devem ser independentes entre si quando possível
52
- - Épicos têm uma "promessa de valor" clara
53
- 2. Nomeie os épicos com IDs: E-01, E-02, E-03...
54
- 3. Escreva uma frase de valor para cada épico
55
-
56
- ### Passo 5 — Priorização MoSCoW
57
- Para cada funcionalidade/épico, aplique:
58
- - **Must Have (M):** crítico para o produto funcionar. Sem isso, não há produto
59
- - **Should Have (S):** importante mas há workaround possível
60
- - **Could Have (C):** desejável se houver tempo e budget
61
- - **Won't Have (W):** explicitamente fora do escopo desta versão
62
-
63
- ### Passo 6 — Definição de Métricas de Sucesso
64
- 1. Defina 3-5 métricas de produto que indicam sucesso
65
- 2. Para cada métrica:
66
- - Nome claro
67
- - Como é medida
68
- - Baseline atual (se disponível)
69
- - Meta após lançamento
70
- 3. Evite métricas de vaidade — prefira métricas de comportamento do usuário
71
-
72
- ### Passo 7 — Validação com @architect
73
- 1. Compartilhe o PRD rascunho com @architect
74
- 2. Aguarde avaliação de viabilidade técnica
75
- 3. Incorpore feedback técnico (ajustes de escopo, riscos identificados)
76
- 4. Se @architect vetar algum item, documente a decisão
77
-
78
- ### Passo 8 — Aprovação com @po
79
- 1. Compartilhe o PRD atualizado com @po
80
- 2. @po valida que é possível criar stories claras para cada item
81
- 3. Incorpore ajustes de @po
82
- 4. Obtenha aprovação formal de @po
83
-
84
- ### Passo 9 — Publicação
85
- 1. Salve o documento final em `docs/[projeto]/PRD.md`
86
- 2. Versione o documento (v1.0)
87
- 3. Notifique o time sobre a disponibilidade do PRD
88
- 4. Acione @sm para iniciar criação de stories
89
-
90
- ---
91
-
92
- ## Critérios de Saída
93
-
94
- O PRD está pronto quando:
95
-
96
- - [ ] Todos os épicos estão definidos com proposta de valor
97
- - [ ] Priorização MoSCoW aplicada a todas as funcionalidades
98
- - [ ] Personas definidas e priorizadas
99
- - [ ] Métricas de sucesso definidas (mínimo 3)
100
- - [ ] Não-escopo documentado explicitamente
101
- - [ ] @architect validou viabilidade técnica
102
- - [ ] @po aprovou formalmente
103
- - [ ] Documento salvo em `docs/[projeto]/PRD.md`
104
-
105
- ---
106
-
107
- ## Output — Estrutura do PRD.md
108
-
109
- ```markdown
110
- # PRD — [Nome do Produto]
111
- Versão: 1.0 | PM: Marina (@pm) | Data: YYYY-MM-DD
112
- Status: Rascunho | Em Revisão | Aprovado
113
-
114
- ## 1. Visão e Proposta de Valor
115
- ### Problema Central
116
- ### Proposta de Valor Única
117
- ### Estado Futuro Desejado
118
-
119
- ## 2. Personas
120
- ### Persona Primária: [Nome]
121
- ### Persona Secundária: [Nome]
122
-
123
- ## 3. Objetivos de Produto
124
- | Objetivo | Métrica | Baseline | Meta |
125
- |---------|--------|---------|------|
126
-
127
- ## 4. Épicos e Funcionalidades
128
-
129
- ### E-01 — [Nome do Épico]
130
- **Promessa de valor:** [Uma frase]
131
- **Prioridade:** Must Have
132
-
133
- #### Funcionalidades
134
- - [Feature 1] — Must Have
135
- - [Feature 2] — Should Have
136
- - [Feature 3] — Could Have
137
-
138
- ### E-02 — [Nome do Épico]
139
- ...
140
-
141
- ## 5. Não-Escopo (Explícito)
142
- O que NÃO será construído nesta versão:
143
- - [Item 1]
144
- - [Item 2]
145
-
146
- ## 6. Restrições
147
- - Prazo: [data]
148
- - Budget: [informação se disponível]
149
- - Tecnologia obrigatória: [se houver]
150
- - Regulatório: [compliance, LGPD, etc]
151
-
152
- ## 7. Roadmap e Milestones
153
- | Milestone | O que inclui | Data estimada |
154
- |----------|------------|--------------|
155
-
156
- ## 8. Riscos de Produto
157
- | Risco | Probabilidade | Impacto | Mitigação |
158
- |-------|--------------|--------|----------|
159
-
160
- ## 9. Glossário
161
- [Termos de negócio específicos do domínio]
162
-
163
- ## 10. Histórico de Versões
164
- | Versão | Data | Autor | Mudança |
165
- |--------|------|-------|--------|
166
- ```
167
-
168
- ---
169
-
170
- *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*
1
+ # Task: Criar PRD
2
+
3
+ > Tarefa executada por @pm após receber o BRIEFING.md de @analyst.
4
+ > Output: `docs/[projeto]/PRD.md`
5
+
6
+ ---
7
+
8
+ ## Objetivo
9
+
10
+ Transformar o briefing de negócios em um Product Requirements Document (PRD) completo, priorizado e aprovado por stakeholders. O PRD é o documento de referência que guia todo o desenvolvimento — ele deve ser suficientemente claro para que qualquer agente entenda o que está sendo construído e por quê.
11
+
12
+ ---
13
+
14
+ ## Pré-requisitos
15
+
16
+ Antes de iniciar, confirme:
17
+
18
+ - [ ] `docs/[projeto]/BRIEFING.md` existe e está completo
19
+ - [ ] @analyst confirmou que o briefing foi validado com stakeholders
20
+ - [ ] Todas as ambiguidades do briefing foram resolvidas
21
+ - [ ] @pm tem acesso a qualquer material adicional do cliente
22
+
23
+ ---
24
+
25
+ ## Passos de Execução
26
+
27
+ ### Passo 1 — Revisão do Briefing
28
+ 1. Leia o BRIEFING.md completamente
29
+ 2. Identifique e anote quaisquer pontos que precisam de esclarecimento
30
+ 3. Se necessário, solicite esclarecimento a @analyst antes de prosseguir
31
+ 4. Nunca assuma — dúvidas são resolvidas antes de escrever o PRD
32
+
33
+ ### Passo 2 — Definição da Visão de Produto
34
+ 1. Articule o problema central que o produto resolve (em 1-2 parágrafos)
35
+ 2. Defina a proposta de valor única (o que diferencia este produto)
36
+ 3. Descreva o estado futuro desejado: como fica o mundo com este produto?
37
+ 4. Identifique as restrições não-negociáveis (tecnologia, prazo, regulatório)
38
+
39
+ ### Passo 3 — Definição de Personas
40
+ 1. Liste as personas identificadas no briefing
41
+ 2. Para cada persona, defina:
42
+ - Nome e perfil
43
+ - Objetivos principais ao usar o sistema
44
+ - Dores e frustrações atuais
45
+ - Nível de expertise técnica
46
+ 3. Priorize as personas (primária, secundária)
47
+
48
+ ### Passo 4 — Estruturação em Épicos
49
+ 1. Agrupe as funcionalidades em Épicos coesos:
50
+ - Cada épico é um conjunto de funcionalidades relacionadas
51
+ - Épicos devem ser independentes entre si quando possível
52
+ - Épicos têm uma "promessa de valor" clara
53
+ 2. Nomeie os épicos com IDs: E-01, E-02, E-03...
54
+ 3. Escreva uma frase de valor para cada épico
55
+
56
+ ### Passo 5 — Priorização MoSCoW
57
+ Para cada funcionalidade/épico, aplique:
58
+ - **Must Have (M):** crítico para o produto funcionar. Sem isso, não há produto
59
+ - **Should Have (S):** importante mas há workaround possível
60
+ - **Could Have (C):** desejável se houver tempo e budget
61
+ - **Won't Have (W):** explicitamente fora do escopo desta versão
62
+
63
+ ### Passo 6 — Definição de Métricas de Sucesso
64
+ 1. Defina 3-5 métricas de produto que indicam sucesso
65
+ 2. Para cada métrica:
66
+ - Nome claro
67
+ - Como é medida
68
+ - Baseline atual (se disponível)
69
+ - Meta após lançamento
70
+ 3. Evite métricas de vaidade — prefira métricas de comportamento do usuário
71
+
72
+ ### Passo 7 — Validação com @architect
73
+ 1. Compartilhe o PRD rascunho com @architect
74
+ 2. Aguarde avaliação de viabilidade técnica
75
+ 3. Incorpore feedback técnico (ajustes de escopo, riscos identificados)
76
+ 4. Se @architect vetar algum item, documente a decisão
77
+
78
+ ### Passo 8 — Aprovação com @po
79
+ 1. Compartilhe o PRD atualizado com @po
80
+ 2. @po valida que é possível criar stories claras para cada item
81
+ 3. Incorpore ajustes de @po
82
+ 4. Obtenha aprovação formal de @po
83
+
84
+ ### Passo 9 — Publicação
85
+ 1. Salve o documento final em `docs/[projeto]/PRD.md`
86
+ 2. Versione o documento (v1.0)
87
+ 3. Notifique o time sobre a disponibilidade do PRD
88
+ 4. Acione @sm para iniciar criação de stories
89
+
90
+ ---
91
+
92
+ ## Critérios de Saída
93
+
94
+ O PRD está pronto quando:
95
+
96
+ - [ ] Todos os épicos estão definidos com proposta de valor
97
+ - [ ] Priorização MoSCoW aplicada a todas as funcionalidades
98
+ - [ ] Personas definidas e priorizadas
99
+ - [ ] Métricas de sucesso definidas (mínimo 3)
100
+ - [ ] Não-escopo documentado explicitamente
101
+ - [ ] @architect validou viabilidade técnica
102
+ - [ ] @po aprovou formalmente
103
+ - [ ] Documento salvo em `docs/[projeto]/PRD.md`
104
+
105
+ ---
106
+
107
+ ## Output — Estrutura do PRD.md
108
+
109
+ ```markdown
110
+ # PRD — [Nome do Produto]
111
+ Versão: 1.0 | PM: Marina (@pm) | Data: YYYY-MM-DD
112
+ Status: Rascunho | Em Revisão | Aprovado
113
+
114
+ ## 1. Visão e Proposta de Valor
115
+ ### Problema Central
116
+ ### Proposta de Valor Única
117
+ ### Estado Futuro Desejado
118
+
119
+ ## 2. Personas
120
+ ### Persona Primária: [Nome]
121
+ ### Persona Secundária: [Nome]
122
+
123
+ ## 3. Objetivos de Produto
124
+ | Objetivo | Métrica | Baseline | Meta |
125
+ |---------|--------|---------|------|
126
+
127
+ ## 4. Épicos e Funcionalidades
128
+
129
+ ### E-01 — [Nome do Épico]
130
+ **Promessa de valor:** [Uma frase]
131
+ **Prioridade:** Must Have
132
+
133
+ #### Funcionalidades
134
+ - [Feature 1] — Must Have
135
+ - [Feature 2] — Should Have
136
+ - [Feature 3] — Could Have
137
+
138
+ ### E-02 — [Nome do Épico]
139
+ ...
140
+
141
+ ## 5. Não-Escopo (Explícito)
142
+ O que NÃO será construído nesta versão:
143
+ - [Item 1]
144
+ - [Item 2]
145
+
146
+ ## 6. Restrições
147
+ - Prazo: [data]
148
+ - Budget: [informação se disponível]
149
+ - Tecnologia obrigatória: [se houver]
150
+ - Regulatório: [compliance, LGPD, etc]
151
+
152
+ ## 7. Roadmap e Milestones
153
+ | Milestone | O que inclui | Data estimada |
154
+ |----------|------------|--------------|
155
+
156
+ ## 8. Riscos de Produto
157
+ | Risco | Probabilidade | Impacto | Mitigação |
158
+ |-------|--------------|--------|----------|
159
+
160
+ ## 9. Glossário
161
+ [Termos de negócio específicos do domínio]
162
+
163
+ ## 10. Histórico de Versões
164
+ | Versão | Data | Autor | Mudança |
165
+ |--------|------|-------|--------|
166
+ ```
167
+
168
+ ---
169
+
170
+ *GEN.IA OS v1.0 — {{TEAM_NAME}} — {{CREATOR_NAME}}*