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,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}}*