@onion-ai/cli 1.0.0-beta.1

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 (220) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +529 -0
  3. package/bin/onion.js +6 -0
  4. package/framework/CLAUDE.md +45 -0
  5. package/framework/VERSION +1 -0
  6. package/framework/agents/compliance/iso-22301-specialist.md +985 -0
  7. package/framework/agents/compliance/iso-27001-specialist.md +713 -0
  8. package/framework/agents/compliance/pmbok-specialist.md +739 -0
  9. package/framework/agents/compliance/security-information-master.md +907 -0
  10. package/framework/agents/compliance/soc2-specialist.md +889 -0
  11. package/framework/agents/deployment/docker-specialist.md +1192 -0
  12. package/framework/agents/development/c4-architecture-specialist.md +745 -0
  13. package/framework/agents/development/c4-documentation-specialist.md +695 -0
  14. package/framework/agents/development/clickup-specialist.md +396 -0
  15. package/framework/agents/development/cursor-specialist.md +277 -0
  16. package/framework/agents/development/docs-reverse-engineer.md +417 -0
  17. package/framework/agents/development/gamma-api-specialist.md +1168 -0
  18. package/framework/agents/development/gitflow-specialist.md +1206 -0
  19. package/framework/agents/development/linux-security-specialist.md +675 -0
  20. package/framework/agents/development/mermaid-specialist.md +515 -0
  21. package/framework/agents/development/nodejs-specialist.md +672 -0
  22. package/framework/agents/development/nx-migration-specialist.md +866 -0
  23. package/framework/agents/development/nx-monorepo-specialist.md +618 -0
  24. package/framework/agents/development/postgres-specialist.md +1123 -0
  25. package/framework/agents/development/react-developer.md +131 -0
  26. package/framework/agents/development/runflow-specialist.md +277 -0
  27. package/framework/agents/development/system-documentation-orchestrator.md +1387 -0
  28. package/framework/agents/development/task-specialist.md +677 -0
  29. package/framework/agents/git/branch-code-reviewer.md +225 -0
  30. package/framework/agents/git/branch-documentation-writer.md +161 -0
  31. package/framework/agents/git/branch-metaspec-checker.md +67 -0
  32. package/framework/agents/git/branch-test-planner.md +176 -0
  33. package/framework/agents/meta/agent-creator-specialist.md +1266 -0
  34. package/framework/agents/meta/command-creator-specialist.md +1676 -0
  35. package/framework/agents/meta/metaspec-gate-keeper.md +240 -0
  36. package/framework/agents/meta/onion.md +824 -0
  37. package/framework/agents/product/branding-positioning-specialist.md +1029 -0
  38. package/framework/agents/product/extract-meeting-specialist.md +394 -0
  39. package/framework/agents/product/meeting-consolidator.md +482 -0
  40. package/framework/agents/product/pain-price-specialist.md +508 -0
  41. package/framework/agents/product/presentation-orchestrator.md +1190 -0
  42. package/framework/agents/product/product-agent.md +201 -0
  43. package/framework/agents/product/story-points-framework-specialist.md +538 -0
  44. package/framework/agents/product/storytelling-business-specialist.md +890 -0
  45. package/framework/agents/research/research-agent.md +292 -0
  46. package/framework/agents/review/code-reviewer.md +154 -0
  47. package/framework/agents/review/corporate-compliance-specialist.md +370 -0
  48. package/framework/agents/testing/test-agent.md +424 -0
  49. package/framework/agents/testing/test-engineer.md +294 -0
  50. package/framework/agents/testing/test-planner.md +117 -0
  51. package/framework/commands/common/prompts/README.md +208 -0
  52. package/framework/commands/common/prompts/clickup-patterns.md +144 -0
  53. package/framework/commands/common/prompts/code-review-checklist.md +168 -0
  54. package/framework/commands/common/prompts/git-workflow-patterns.md +235 -0
  55. package/framework/commands/common/prompts/output-formats.md +240 -0
  56. package/framework/commands/common/prompts/technical.md +194 -0
  57. package/framework/commands/common/templates/abstraction-template.md +399 -0
  58. package/framework/commands/common/templates/agent-template.md +353 -0
  59. package/framework/commands/common/templates/business_context_template.md +748 -0
  60. package/framework/commands/common/templates/command-template.md +273 -0
  61. package/framework/commands/common/templates/technical_context_template.md +526 -0
  62. package/framework/commands/design/screen-spec.md +505 -0
  63. package/framework/commands/development/runflow-dev.md +465 -0
  64. package/framework/commands/docs/build-business-docs.md +299 -0
  65. package/framework/commands/docs/build-compliance-docs.md +143 -0
  66. package/framework/commands/docs/build-index.md +119 -0
  67. package/framework/commands/docs/build-tech-docs.md +221 -0
  68. package/framework/commands/docs/docs-health.md +141 -0
  69. package/framework/commands/docs/help.md +278 -0
  70. package/framework/commands/docs/refine-vision.md +25 -0
  71. package/framework/commands/docs/reverse-consolidate.md +158 -0
  72. package/framework/commands/docs/sync-sessions.md +354 -0
  73. package/framework/commands/docs/validate-docs.md +157 -0
  74. package/framework/commands/engineer/bump.md +29 -0
  75. package/framework/commands/engineer/docs.md +11 -0
  76. package/framework/commands/engineer/hotfix.md +183 -0
  77. package/framework/commands/engineer/plan.md +85 -0
  78. package/framework/commands/engineer/pr-update.md +219 -0
  79. package/framework/commands/engineer/pr.md +117 -0
  80. package/framework/commands/engineer/pre-pr.md +81 -0
  81. package/framework/commands/engineer/start.md +254 -0
  82. package/framework/commands/engineer/validate-phase-sync.md +134 -0
  83. package/framework/commands/engineer/warm-up.md +20 -0
  84. package/framework/commands/engineer/work.md +155 -0
  85. package/framework/commands/f/company-context-extractor.md +93 -0
  86. package/framework/commands/f/process-meetings.md +103 -0
  87. package/framework/commands/git/README.md +682 -0
  88. package/framework/commands/git/code-review.md +213 -0
  89. package/framework/commands/git/fast-commit.md +43 -0
  90. package/framework/commands/git/feature/finish.md +88 -0
  91. package/framework/commands/git/feature/publish.md +89 -0
  92. package/framework/commands/git/feature/start.md +172 -0
  93. package/framework/commands/git/help.md +100 -0
  94. package/framework/commands/git/hotfix/finish.md +96 -0
  95. package/framework/commands/git/hotfix/start.md +92 -0
  96. package/framework/commands/git/init.md +111 -0
  97. package/framework/commands/git/release/finish.md +96 -0
  98. package/framework/commands/git/release/start.md +93 -0
  99. package/framework/commands/git/sync.md +199 -0
  100. package/framework/commands/meta/all-tools.md +58 -0
  101. package/framework/commands/meta/analyze-complex-problem.md +186 -0
  102. package/framework/commands/meta/create-abstraction.md +882 -0
  103. package/framework/commands/meta/create-agent-express.md +98 -0
  104. package/framework/commands/meta/create-agent.md +210 -0
  105. package/framework/commands/meta/create-command.md +203 -0
  106. package/framework/commands/meta/create-knowledge-base.md +143 -0
  107. package/framework/commands/meta/create-task-structure.md +150 -0
  108. package/framework/commands/meta/setup-integration.md +274 -0
  109. package/framework/commands/onion.md +169 -0
  110. package/framework/commands/product/README.md +249 -0
  111. package/framework/commands/product/analyze-pain-price.md +694 -0
  112. package/framework/commands/product/branding.md +458 -0
  113. package/framework/commands/product/check.md +46 -0
  114. package/framework/commands/product/checklist-sync.md +239 -0
  115. package/framework/commands/product/collect.md +95 -0
  116. package/framework/commands/product/consolidate-meetings.md +291 -0
  117. package/framework/commands/product/estimate.md +511 -0
  118. package/framework/commands/product/extract-meeting.md +226 -0
  119. package/framework/commands/product/feature.md +416 -0
  120. package/framework/commands/product/light-arch.md +82 -0
  121. package/framework/commands/product/presentation.md +174 -0
  122. package/framework/commands/product/refine.md +161 -0
  123. package/framework/commands/product/spec.md +79 -0
  124. package/framework/commands/product/task-check.md +378 -0
  125. package/framework/commands/product/task.md +603 -0
  126. package/framework/commands/product/validate-task.md +325 -0
  127. package/framework/commands/product/warm-up.md +24 -0
  128. package/framework/commands/quick/analisys.md +17 -0
  129. package/framework/commands/test/e2e.md +377 -0
  130. package/framework/commands/test/integration.md +508 -0
  131. package/framework/commands/test/unit.md +381 -0
  132. package/framework/commands/validate/collab/pair-testing.md +657 -0
  133. package/framework/commands/validate/collab/three-amigos.md +534 -0
  134. package/framework/commands/validate/qa-points/estimate.md +660 -0
  135. package/framework/commands/validate/test-strategy/analyze.md +1201 -0
  136. package/framework/commands/validate/test-strategy/create.md +411 -0
  137. package/framework/commands/validate/workflow.md +370 -0
  138. package/framework/commands/warm-up.md +20 -0
  139. package/framework/docs/architecture/acoplamento-clickup-problema-analise.md +468 -0
  140. package/framework/docs/architecture/desacoplamento-roadmap.md +364 -0
  141. package/framework/docs/architecture/validacao-fase-1.md +235 -0
  142. package/framework/docs/c4/c4-detection-rules.md +395 -0
  143. package/framework/docs/c4/c4-documentation-templates.md +579 -0
  144. package/framework/docs/c4/c4-mermaid-patterns.md +331 -0
  145. package/framework/docs/c4/c4-templates.md +256 -0
  146. package/framework/docs/clickup/clickup-acceptance-criteria-strategy.md +329 -0
  147. package/framework/docs/clickup/clickup-auto-update-strategy.md +340 -0
  148. package/framework/docs/clickup/clickup-comment-formatter.md +239 -0
  149. package/framework/docs/clickup/clickup-description-fix.md +384 -0
  150. package/framework/docs/clickup/clickup-dual-comment-strategy.md +528 -0
  151. package/framework/docs/clickup/clickup-formatting.md +302 -0
  152. package/framework/docs/clickup/separador-tamanho-otimizado.md +258 -0
  153. package/framework/docs/engineer/pre-pr-acceptance-validation.md +256 -0
  154. package/framework/docs/onion/ESPERANTO.md +293 -0
  155. package/framework/docs/onion/agents-reference.md +832 -0
  156. package/framework/docs/onion/clickup-integration.md +780 -0
  157. package/framework/docs/onion/commands-guide.md +924 -0
  158. package/framework/docs/onion/engineering-flows.md +900 -0
  159. package/framework/docs/onion/getting-started.md +803 -0
  160. package/framework/docs/onion/maintenance-checklist.md +421 -0
  161. package/framework/docs/onion/naming-conventions.md +286 -0
  162. package/framework/docs/onion/practical-examples.md +854 -0
  163. package/framework/docs/product/story-points-integration.md +269 -0
  164. package/framework/docs/product/story-points-validation.md +237 -0
  165. package/framework/docs/reviews/task-manager-docs-review-2025-11-24.md +184 -0
  166. package/framework/docs/strategies/clickup-comment-patterns.md +766 -0
  167. package/framework/docs/strategies/clickup-integration-tests.md +602 -0
  168. package/framework/docs/strategies/clickup-mcp-wrappers-tests.md +888 -0
  169. package/framework/docs/strategies/clickup-regression-tests.md +587 -0
  170. package/framework/docs/strategies/visual-patterns.md +315 -0
  171. package/framework/docs/templates/README.md +649 -0
  172. package/framework/docs/templates/adr-template.md +226 -0
  173. package/framework/docs/templates/analysis-template.md +280 -0
  174. package/framework/docs/templates/execution-plan-template.md +430 -0
  175. package/framework/docs/templates/guide-template.md +367 -0
  176. package/framework/docs/templates/phase-execution-prompt-template.md +504 -0
  177. package/framework/docs/templates/reference-template.md +522 -0
  178. package/framework/docs/templates/solution-template.md +390 -0
  179. package/framework/docs/tools/README.md +356 -0
  180. package/framework/docs/tools/agents.md +365 -0
  181. package/framework/docs/tools/commands.md +669 -0
  182. package/framework/docs/tools/cursor.md +539 -0
  183. package/framework/docs/tools/mcps.md +937 -0
  184. package/framework/docs/tools/rules.md +461 -0
  185. package/framework/rules/language-and-documentation.mdc +371 -0
  186. package/framework/rules/nestjs-controllers.md +83 -0
  187. package/framework/rules/nestjs-dtos.md +255 -0
  188. package/framework/rules/nestjs-modules.md +141 -0
  189. package/framework/rules/nestjs-services.md +230 -0
  190. package/framework/rules/nx-rules.mdc +41 -0
  191. package/framework/rules/onion-patterns.mdc +197 -0
  192. package/framework/skills/codebase-visualizer/SKILL.md +26 -0
  193. package/framework/skills/codebase-visualizer/scripts/visualize.py +131 -0
  194. package/framework/skills/collect/SKILL.md +84 -0
  195. package/framework/skills/create-rule/SKILL.md +152 -0
  196. package/framework/skills/db-schema-visualizer/SKILL.md +49 -0
  197. package/framework/skills/db-schema-visualizer/scripts/visualize.py +1191 -0
  198. package/framework/skills/sync-meetings/SKILL.md +239 -0
  199. package/framework/utils/clickup-mcp-wrappers.md +744 -0
  200. package/framework/utils/date-time-standards.md +200 -0
  201. package/framework/utils/task-manager/README.md +94 -0
  202. package/framework/utils/task-manager/adapters/asana.md +377 -0
  203. package/framework/utils/task-manager/adapters/clickup.md +467 -0
  204. package/framework/utils/task-manager/adapters/linear.md +421 -0
  205. package/framework/utils/task-manager/detector.md +299 -0
  206. package/framework/utils/task-manager/factory.md +363 -0
  207. package/framework/utils/task-manager/interface.md +248 -0
  208. package/framework/utils/task-manager/types.md +409 -0
  209. package/package.json +41 -0
  210. package/src/cli.js +73 -0
  211. package/src/commands/doctor.js +191 -0
  212. package/src/commands/init.js +287 -0
  213. package/src/commands/install.js +261 -0
  214. package/src/commands/list.js +152 -0
  215. package/src/commands/uninstall.js +90 -0
  216. package/src/commands/update.js +26 -0
  217. package/src/utils/fs.js +89 -0
  218. package/src/utils/log.js +35 -0
  219. package/src/utils/paths.js +32 -0
  220. package/src/utils/prompt.js +76 -0
@@ -0,0 +1,213 @@
1
+ ---
2
+ name: code-review
3
+ description: |
4
+ Gerenciador de ChatGPT-CodeReview para setup, validação e otimização.
5
+ Use para configurar code review automático em projetos.
6
+ model: sonnet
7
+
8
+ parameters:
9
+ - name: mode
10
+ description: Modo de operação (auto/setup/validate/status)
11
+ required: false
12
+ default: auto
13
+
14
+ category: git
15
+ tags:
16
+ - code-review
17
+ - automation
18
+ - ci-cd
19
+
20
+ version: "3.0.0"
21
+ updated: "2025-11-24"
22
+
23
+ related_commands:
24
+ - /engineer/pre-pr
25
+ - /git/feature/finish
26
+
27
+ related_agents:
28
+ - code-reviewer
29
+ - branch-code-reviewer
30
+ ---
31
+
32
+ # 🤖 ChatGPT Code Review Manager
33
+
34
+ Gerenciador inteligente de ChatGPT-CodeReview para o Sistema Onion.
35
+
36
+ ## 🎯 Objetivo
37
+
38
+ Automatizar setup, validação e otimização do code review automático.
39
+
40
+ ## ⚡ Modos de Operação
41
+
42
+ ```bash
43
+ /git/code-review # AUTO: detecta e executa ação apropriada
44
+ /git/code-review setup # Criar/reconfigurar arquivo
45
+ /git/code-review validate # Validar configuração existente
46
+ /git/code-review status # Mostrar status atual
47
+ ```
48
+
49
+ ## 🔄 Fluxo de Execução
50
+
51
+ ### Passo 1: Detectar Modo
52
+
53
+ ```bash
54
+ # Verificar se code-review.yml existe
55
+ test -f .github/workflows/code-review.yml && MODE="validate" || MODE="setup"
56
+ ```
57
+
58
+ SE `{{mode}}` fornecido → usar modo especificado
59
+ SENÃO → usar detecção automática
60
+
61
+ ### Passo 2: Executar Modo
62
+
63
+ #### 🆕 SETUP MODE
64
+
65
+ 1. **Detectar Stack**
66
+ ```bash
67
+ # Package manager
68
+ test -f pnpm-lock.yaml && PM="pnpm"
69
+ test -f package-lock.json && PM="npm"
70
+
71
+ # Monorepo
72
+ test -f nx.json && MONO="nx"
73
+
74
+ # Backend/Frontend
75
+ grep -q "fastify" package.json && BACKEND="fastify"
76
+ grep -q "react" package.json && FRONTEND="react"
77
+ ```
78
+
79
+ 2. **Gerar Template**
80
+ Criar `.github/workflows/code-review.yml`:
81
+ ```yaml
82
+ name: ChatGPT Code Review
83
+
84
+ on:
85
+ pull_request:
86
+ types: [opened, synchronize]
87
+
88
+ jobs:
89
+ review:
90
+ runs-on: ubuntu-latest
91
+ steps:
92
+ - uses: actions/checkout@v4
93
+ - uses: anc95/ChatGPT-CodeReview@main
94
+ env:
95
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
96
+ OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
97
+ ```
98
+
99
+ 3. **Aplicar Configurações por Stack**
100
+ - TypeScript → adicionar regras de tipos
101
+ - React → regras de hooks
102
+ - NX → regras de monorepo
103
+
104
+ #### 🔍 VALIDATE MODE
105
+
106
+ 1. **Verificar Arquivo**
107
+ - Existe?
108
+ - YAML válido?
109
+ - Secrets configurados?
110
+
111
+ 2. **Analisar Configuração**
112
+ Usar checklist de `common/prompts/code-review-checklist.md`
113
+
114
+ 3. **Gerar Relatório**
115
+ ```
116
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
117
+ 📊 CODE REVIEW VALIDATION
118
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
119
+
120
+ ✅ Arquivo: .github/workflows/code-review.yml
121
+ ✅ YAML: Válido
122
+ ⚠️ Secrets: OPENAI_API_KEY não detectado
123
+
124
+ 💡 Recomendações:
125
+ ∟ Configurar OPENAI_API_KEY em Settings > Secrets
126
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
127
+ ```
128
+
129
+ #### 📊 STATUS MODE
130
+
131
+ Mostrar dashboard:
132
+ ```
133
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
134
+ 📊 CODE REVIEW STATUS
135
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
136
+
137
+ 🔧 Configuração:
138
+ ∟ Arquivo: ✅ Configurado
139
+ ∟ Stack: TypeScript + React + NX
140
+ ∟ Última atualização: 2025-11-24
141
+
142
+ 📈 Métricas (últimos 30 dias):
143
+ ∟ PRs revisados: 45
144
+ ∟ Issues detectados: 127
145
+ ∟ Auto-fixes aplicados: 23
146
+
147
+ 🎯 Saúde: 95% ████████████░░░░░
148
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
149
+ ```
150
+
151
+ ### Passo 3: Atualizar ClickUp
152
+
153
+ SE há task associada:
154
+ - Adicionar comentário com resultado
155
+ - Atualizar status se necessário
156
+
157
+ ## 📤 Output Esperado
158
+
159
+ ### Setup Sucesso
160
+
161
+ ```
162
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
163
+ ✅ CODE REVIEW CONFIGURADO
164
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
165
+
166
+ 📁 Criado: .github/workflows/code-review.yml
167
+
168
+ 🔧 Stack Detectado:
169
+ ∟ Package Manager: pnpm
170
+ ∟ Monorepo: NX
171
+ ∟ Backend: Fastify
172
+ ∟ Frontend: React
173
+
174
+ ⚠️ Próximos Passos:
175
+ 1. Configurar OPENAI_API_KEY em Settings > Secrets
176
+ 2. Testar com um PR de teste
177
+
178
+ 🚀 Comando: /git/code-review validate
179
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
180
+ ```
181
+
182
+ ### Validação com Issues
183
+
184
+ ```
185
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
186
+ ⚠️ CODE REVIEW - ISSUES ENCONTRADOS
187
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
188
+
189
+ 🔴 Críticos:
190
+ ∟ Secret OPENAI_API_KEY não configurado
191
+
192
+ 🟡 Importantes:
193
+ ∟ Versão do action desatualizada (usar @v1.2.0)
194
+
195
+ 💡 Sugestões:
196
+ ∟ Adicionar filtro de arquivos .ts/.tsx
197
+
198
+ 🔧 Auto-fix disponível? Sim
199
+ Executar auto-fix? (s/n)
200
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
201
+ ```
202
+
203
+ ## 🔗 Referências
204
+
205
+ - Checklist: `common/prompts/code-review-checklist.md`
206
+ - Padrões Git: `common/prompts/git-workflow-patterns.md`
207
+ - Agente: @code-reviewer para reviews manuais
208
+
209
+ ## ⚠️ Notas
210
+
211
+ - Requer GitHub Actions habilitado
212
+ - Secret `OPENAI_API_KEY` obrigatório
213
+ - Funciona com qualquer stack JavaScript/TypeScript
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: fast-commit
3
+ description: |
4
+ Adiciona todas as mudanças e faz commit rápido.
5
+ Use para commits típicos no fluxo do Sistema Onion.
6
+ model: sonnet
7
+ category: git
8
+ tags: [git, commit, fast]
9
+ version: "3.0.0"
10
+ updated: "2025-11-25"
11
+ ---
12
+
13
+ # Fast Commit
14
+
15
+ Adiciona todas as mudanças e faz commit com mensagem especificada.
16
+
17
+ ## 🎯 Uso
18
+
19
+ ```bash
20
+ /git/fast-commit "feat: implement admin dashboard basic flow"
21
+ ```
22
+
23
+ ## ⚡ Fluxo de Execução
24
+
25
+ 1. `git add .` — adiciona todas as mudanças
26
+ 2. `git commit -m "<mensagem>"` — commit com a mensagem
27
+
28
+ ## 📋 Convenção de Mensagens
29
+
30
+ Use [Conventional Commits](https://conventionalcommits.org):
31
+
32
+ | Tipo | Descrição |
33
+ |------|-----------|
34
+ | `feat:` | Nova funcionalidade |
35
+ | `fix:` | Correção de bug |
36
+ | `docs:` | Documentação |
37
+ | `refactor:` | Refatoração |
38
+ | `chore:` | Manutenção |
39
+
40
+ ## ⚠️ Notas
41
+
42
+ - SEMPRE revise `git status` antes
43
+ - Prefira commits atômicos e descritivos
@@ -0,0 +1,88 @@
1
+ ---
2
+ name: finish
3
+ description: Finalizar feature com merge para develop e cleanup.
4
+ model: sonnet
5
+ category: git
6
+ tags: [feature, gitflow, merge]
7
+ version: "3.0.0"
8
+ updated: "2025-11-24"
9
+ ---
10
+
11
+ # ✅ Git Flow - Finalizar Feature
12
+
13
+ Finalizar desenvolvimento de feature realizando merge seguro para develop branch com validações automáticas e cleanup completo. Processo seguro com confirmações obrigatórias para prevenir erros de produção.
14
+
15
+ ## 🎯 Funcionalidades
16
+
17
+ ### Safety-First e Validações
18
+ - Confirmação obrigatória antes de merge feature → develop
19
+ - Análise automática de conflitos e working directory
20
+ - Validação de status da develop branch (sincronização)
21
+ - Preview detalhado das mudanças que serão mergeadas
22
+ - Guidance para resolução de problemas encontrados
23
+
24
+ ### GitFlow Compliance e Automação
25
+ - Merge seguindo padrão oficial GitFlow (feature → develop)
26
+ - Cleanup automático de branch local e remote após merge
27
+ - Atualização de ClickUp task e session archival
28
+ - Integração preservada com @gitflow-specialist para operações complexas
29
+
30
+ ### Educação e UX
31
+ - Context display mostrando impacto das mudanças
32
+ - Progress indicators durante operação
33
+ - Educational content sobre GitFlow workflow
34
+ - Next steps guidance após finalização
35
+
36
+ ## 🚀 Como Usar
37
+
38
+ ```bash
39
+ /git/feature/finish # Auto-detecta branch atual
40
+ ```
41
+
42
+ **Pré-requisitos**: Execute na branch de feature que deseja finalizar
43
+
44
+ ### Processo Executado
45
+ 1. **Análise**: Detecta branch atual e valida estado do repositório
46
+ 2. **Validações**: Verifica working directory, conflicts e status develop
47
+ 3. **Preview**: Exibe impacto das mudanças (commits, files, lines)
48
+ 4. **Confirmação**: Solicita confirmação explícita do usuário
49
+ 5. **Merge**: Executa merge seguro feature → develop
50
+ 6. **Cleanup**: Remove branch local/remote e atualiza ClickUp task
51
+ 7. **Archive**: Move session para estado finalizado
52
+
53
+ ### Educational Context
54
+ Durante execução, o comando ensina conceitos GitFlow:
55
+ - Visualização do workflow: `develop → feature/name → develop`
56
+ - Impacto da operação na team collaboration
57
+ - Best practices para feature development
58
+ - Guidance para próximos passos
59
+
60
+ ## 🤝 Integração @gitflow-specialist
61
+
62
+ *Este comando sempre consulta @gitflow-specialist para análise de conflitos, validação de merge strategy, execução segura do merge e guidance para resolução de problemas complexos.*
63
+
64
+ ## ⚠️ Resolução de Problemas
65
+
66
+ ### Uncommitted Changes
67
+ - **Sintoma**: Working directory não está limpo
68
+ - **Solução**: `git add . && git commit -m "final changes"` antes de finalizar
69
+
70
+ ### Merge Conflicts Detectados
71
+ - **Causa**: Mudanças conflitantes entre feature e develop
72
+ - **Fix**: Resolver conflicts manualmente ou usar `git merge develop` na feature branch primeiro
73
+
74
+ ### Develop Branch Desatualizada
75
+ - **Sintoma**: Develop branch está atrás do remote
76
+ - **Solução**: `git checkout develop && git pull origin develop` antes de finalizar feature
77
+
78
+ ### Tests Failing
79
+ - **Sintoma**: Testes automatizados falhando
80
+ - **Solução**: Corrigir testes ou usar flag de override (não recomendado)
81
+
82
+ ### Feature Branch Não Encontrada
83
+ - **Causa**: Not em uma feature branch ou branch name incorreto
84
+ - **Fix**: `git checkout feature/your-feature-name` antes de executar comando
85
+
86
+ ### Remote Branch Issues
87
+ - **Sintoma**: Problemas com remote branch tracking
88
+ - **Solução**: `git push -u origin feature/name` para estabelecer tracking
@@ -0,0 +1,89 @@
1
+ ---
2
+ name: publish
3
+ description: Publicar feature branch no remote para colaboração.
4
+ model: sonnet
5
+ category: git
6
+ tags: [feature, gitflow, remote]
7
+ version: "3.0.0"
8
+ updated: "2025-11-24"
9
+ ---
10
+
11
+ # 🤝 Git Flow - Publicar Feature
12
+
13
+ Publicar feature branch para remote repository permitindo colaboração em equipe com setup automático de tracking, validações de readiness e integração com ClickUp para team awareness e code review workflow.
14
+
15
+ ## 🎯 Funcionalidades
16
+
17
+ ### Team Collaboration e Sharing
18
+ - Push seguro da feature branch para remote origin
19
+ - Setup automático de upstream tracking para colaboração
20
+ - Validações de collaboration readiness (tests, commits, documentation)
21
+ - Team notification integration via ClickUp status updates
22
+ - Code review preparation automática
23
+
24
+ ### Git Flow Compliance e Automação
25
+ - Publicação seguindo padrão oficial GitFlow (feature → remote)
26
+ - Automatic branch tracking configuration
27
+ - ClickUp task status update para "In Review"
28
+ - Team guidance para next steps após publicação
29
+ - Integration com workflows de code review
30
+
31
+ ### Educational e Team UX
32
+ - Context display mostrando impacto da publicação na equipe
33
+ - Progress indicators durante operações de remote
34
+ - Educational content sobre feature collaboration
35
+ - Team guidance e best practices para colaboração
36
+
37
+ ## 🚀 Como Usar
38
+
39
+ ```bash
40
+ /git/feature/publish # Publica branch atual (se feature)
41
+ /git/feature/publish feature-name # Publica feature específica
42
+ ```
43
+
44
+ **Pré-requisitos**: Branch deve existir localmente e ser uma feature branch
45
+
46
+ ### Processo Executado
47
+ 1. **Validation**: Verifica se é feature branch e se está ready para publicação
48
+ 2. **Readiness Check**: Valida tests, commits, working directory
49
+ 3. **Remote Setup**: Configura upstream tracking se necessário
50
+ 4. **Push**: Executa push seguro para remote origin
51
+ 5. **ClickUp Update**: Atualiza status para "In Review" e notifica team
52
+ 6. **Team Guidance**: Fornece next steps para code review workflow
53
+
54
+ ### Team Collaboration Features
55
+ Durante execução, facilita colaboração em equipe:
56
+ - Automatic remote branch creation se não existir
57
+ - Team notification via ClickUp integration
58
+ - Code review readiness validation
59
+ - Next steps guidance para collaboration workflow
60
+
61
+ ## 🤝 Integração @gitflow-specialist
62
+
63
+ *Este comando sempre consulta @gitflow-specialist para validação de remote operations, configuração de tracking, análise de readiness para team collaboration e guidance para code review preparation.*
64
+
65
+ ## ⚠️ Resolução de Problemas
66
+
67
+ ### Feature Branch Não Encontrada
68
+ - **Sintoma**: Branch especificada não existe localmente
69
+ - **Solução**: `git checkout -b feature/name` ou usar branch existente
70
+
71
+ ### Not on Feature Branch
72
+ - **Causa**: Branch atual não é uma feature branch
73
+ - **Fix**: `git checkout feature/name` ou especificar feature-name no comando
74
+
75
+ ### Remote Already Exists
76
+ - **Sintoma**: Branch já existe no remote com divergências
77
+ - **Solução**: `git pull origin feature/name` para sincronizar antes de publicar
78
+
79
+ ### Tests Failing
80
+ - **Sintoma**: Validation detecta testes falhando
81
+ - **Solução**: Corrigir testes antes da publicação para manter qualidade da team
82
+
83
+ ### Working Directory Not Clean
84
+ - **Causa**: Uncommitted changes impedem publicação segura
85
+ - **Fix**: `git add . && git commit -m "changes"` antes de publicar
86
+
87
+ ### Remote Tracking Issues
88
+ - **Sintoma**: Problemas de configuração de upstream tracking
89
+ - **Solução**: Comando configura automaticamente via @gitflow-specialist
@@ -0,0 +1,172 @@
1
+ ---
2
+ name: start
3
+ description: Iniciar feature branch GitFlow com ambiente configurado.
4
+ model: sonnet
5
+ category: git
6
+ tags: [feature, gitflow, branch]
7
+ version: '3.0.0'
8
+ updated: '2025-11-24'
9
+ ---
10
+
11
+ # 🌿 Git Flow - Iniciar Feature
12
+
13
+ Iniciar desenvolvimento de uma nova funcionalidade criando uma branch GitFlow apropriada e configurando ambiente de desenvolvimento. Integração obrigatória com @gitflow-specialist para guidance especializada.
14
+
15
+ ## 🎯 Funcionalidades
16
+
17
+ ### Criação Inteligente de Feature Branch
18
+
19
+ - Criar branch GitFlow no formato `feature/nome-da-funcionalidade`
20
+ - Detectar automaticamente branch base apropriada (develop/main)
21
+ - Validar nomenclatura seguindo convenções GitFlow
22
+ - Configurar tracking com repositório remoto quando disponível
23
+
24
+ ### Integração com @gitflow-specialist
25
+
26
+ - Consultar especialista para análise do repositório atual
27
+ - Receber estratégia de branching personalizada
28
+ - Validar compliance com workflows da equipe
29
+ - Guidance contextual para desenvolvimento
30
+
31
+ ### Session Management Automático
32
+
33
+ - Criar diretório `.claude/sessions/<feature-slug>/` automaticamente
34
+ - Gerar `context.md` com metadados da feature
35
+ - Criar `plan.md` com template de desenvolvimento
36
+ - Integração opcional com ClickUp tasks existentes
37
+
38
+ ## 🚀 Como Usar
39
+
40
+ ```bash
41
+ /git/feature/start "nome-da-funcionalidade"
42
+ ```
43
+
44
+ ### Exemplos de Nomenclatura
45
+
46
+ ```bash
47
+ /git/feature/start "implement-oauth-authentication"
48
+ /git/feature/start "add-user-dashboard-filters"
49
+ /git/feature/start "fix-payment-validation"
50
+ /git/feature/start "update-api-documentation"
51
+ ```
52
+
53
+ ## 🤖 Integração com @gitflow-specialist
54
+
55
+ Para cada nova feature:
56
+
57
+ 1. **Consultar @gitflow-specialist** para análise do estado atual do repositório
58
+ 2. **Receber estratégia** de criação de branch baseada no contexto
59
+ 3. **Validar nomenclatura** e compliance com padrões da equipe
60
+ 4. **Executar criação** seguindo as recomendações do especialista
61
+ 5. **Configurar ambiente** de desenvolvimento otimizado
62
+
63
+ ## 📋 Processo de Criação
64
+
65
+ ### Validações Pré-Criação
66
+
67
+ - **Parameter check**: Verificar se nome da feature foi fornecido
68
+ - **Repository check**: Confirmar que GitFlow está inicializado
69
+ - **Status check**: Garantir working directory limpo
70
+ - **Naming validation**: Validar convenções de nomenclatura
71
+
72
+ ### Criação da Branch
73
+
74
+ - **Base detection**: Identificar branch base apropriada (develop)
75
+ - **Branch creation**: Criar `feature/nome` baseada na develop
76
+ - **Remote setup**: Configurar tracking se repositório remoto disponível
77
+ - **Checkout**: Trocar para a nova branch automaticamente
78
+
79
+ ### Setup do Ambiente
80
+
81
+ - **Session creation**: Criar estrutura `.claude/sessions/`
82
+ - **Context setup**: Gerar arquivos de contexto e planejamento
83
+ - **ClickUp integration**: Conectar com tasks existentes se detectadas
84
+ - **Development ready**: Ambiente pronto para desenvolvimento
85
+
86
+ ## ⚙️ Estrutura Criada
87
+
88
+ ### Branch GitFlow
89
+
90
+ ```
91
+ feature/nome-da-funcionalidade ← nova branch
92
+ ├── baseada em: develop (branch de desenvolvimento)
93
+ ├── tracking: origin/feature/nome (se remoto disponível)
94
+ └── estado: pronta para desenvolvimento
95
+ ```
96
+
97
+ ### Session Directory
98
+
99
+ ```
100
+ .claude/sessions/nome-da-funcionalidade/
101
+ ├── context.md # Metadados e objetivos da feature
102
+ ├── plan.md # Plano de desenvolvimento estruturado
103
+ ├── notes.md # Notas de desenvolvimento
104
+ └── (outros arquivos conforme necessário)
105
+ ```
106
+
107
+ ## ✅ Resultado da Execução
108
+
109
+ Após execução bem-sucedida:
110
+
111
+ - ✅ **Feature branch criada** no padrão GitFlow
112
+ - ✅ **Branch checkout realizado** automaticamente
113
+ - ✅ **Session configurada** com estrutura completa
114
+ - ✅ **Ambiente pronto** para desenvolvimento
115
+ - ✅ **Próximos passos** fornecidos contextualmente
116
+
117
+ ## 🔄 Fluxo de Desenvolvimento Sugerido
118
+
119
+ Após criar a feature:
120
+
121
+ 1. **Desenvolvimento**: Implementar funcionalidade na branch criada
122
+ 2. **Commits frequentes**: Usar conventional commits para histórico limpo
123
+ 3. **Push regular**: `git push` para backup e colaboração
124
+ 4. **Compartilhamento**: `/git/feature/publish` para code review
125
+ 5. **Finalização**: `/git/feature/finish` quando completo
126
+
127
+ ## ⚠️ Tratamento de Problemas
128
+
129
+ ### GitFlow não inicializado
130
+
131
+ **Problema**: Repository não tem GitFlow configurado
132
+ **Solução**: Execute `/git/init` primeiro para configurar GitFlow
133
+
134
+ ### Nome de feature inválido
135
+
136
+ **Problema**: Nome não segue convenções ou contém caracteres inválidos
137
+ **Solução**: Use nomes descritivos em kebab-case (letras, números, hífen)
138
+
139
+ ### Working directory não limpo
140
+
141
+ **Problema**: Há mudanças não commitadas no repositório
142
+ **Solução**: Commit ou stash mudanças antes de criar nova feature
143
+
144
+ ### Feature branch já existe
145
+
146
+ **Problema**: Já existe branch com mesmo nome
147
+ **Solução**: Use nome diferente ou finalize feature existente primeiro
148
+
149
+ ### Branch develop não encontrada
150
+
151
+ **Problema**: Branch develop não existe (GitFlow mal configurado)
152
+ **Solução**: @gitflow-specialist fornecerá estratégia de resolução
153
+
154
+ ## 💡 Melhores Práticas
155
+
156
+ ### Nomenclatura de Features
157
+
158
+ - **Descritiva**: Nome deve explicar claramente a funcionalidade
159
+ - **Kebab-case**: Use hífens para separar palavras
160
+ - **Concisa**: Evite nomes muito longos, máximo 50 caracteres
161
+ - **Sem prefixos**: Não usar "feature-" pois já está no path da branch
162
+
163
+ ### Desenvolvimento
164
+
165
+ - **Commits atômicos**: Commits pequenos e focados
166
+ - **Conventional commits**: Seguir padrão (feat:, fix:, docs:, etc.)
167
+ - **Push frequente**: Backup regular do trabalho
168
+ - **Testes**: Implementar testes conforme desenvolvimento
169
+
170
+ ---
171
+
172
+ _Este comando sempre consulta @gitflow-specialist para garantir criação otimizada e compliance com padrões da equipe._
@@ -0,0 +1,100 @@
1
+ ---
2
+ name: help
3
+ description: Ajuda contextual para comandos GitFlow do Sistema Onion.
4
+ model: sonnet
5
+ category: git
6
+ tags: [help, gitflow, documentation]
7
+ version: "3.0.0"
8
+ updated: "2025-11-24"
9
+ ---
10
+
11
+ # 🆘 Git Flow - Sistema de Ajuda
12
+
13
+ Fornecer ajuda contextual e interativa para todos os comandos GitFlow do Sistema Onion. Detectar automaticamente o estado atual do repositório e sugerir próximos passos apropriados.
14
+
15
+ ## 🎯 Funcionalidades
16
+
17
+ ### Detecção Inteligente de Contexto
18
+ - Verificar se Git Flow está inicializado no repositório atual
19
+ - Identificar branch ativa e sugerir workflows apropriados
20
+ - Detectar estado do projeto e recomendar próximos passos
21
+ - Integração com @gitflow-specialist para guidance avançada
22
+
23
+ ### Sistema de Ajuda Estruturado
24
+ - **Help geral**: Visão completa de todos os comandos disponíveis
25
+ - **Help específico**: Documentação detalhada por comando individual
26
+ - **Troubleshooting**: Soluções para problemas comuns
27
+ - **Quick reference**: Comandos essenciais por situação
28
+
29
+ ## 🚀 Como Usar
30
+
31
+ ```bash
32
+ /git/help # Help completo interativo
33
+ /git/help feature # Ajuda específica para features
34
+ /git/help release # Ajuda específica para releases
35
+ /git/help hotfix # Ajuda específica para hotfixes
36
+ /git/help init # Ajuda para inicialização
37
+ ```
38
+
39
+ ## 🤖 Integração com @gitflow-specialist
40
+
41
+ Para cada solicitação de ajuda:
42
+
43
+ 1. **Consultar @gitflow-specialist** para análise contextual do repositório
44
+ 2. **Receber guidance** específica baseada no estado atual
45
+ 3. **Apresentar recomendações** personalizadas para o desenvolvedor
46
+ 4. **Fornecer exemplos práticos** para a situação detectada
47
+
48
+ ## 📋 Comandos Disponíveis
49
+
50
+ ### Setup e Inicialização
51
+ - `/git/init` - Configurar Git Flow no repositório
52
+ - `/git/help` - Este sistema de ajuda
53
+
54
+ ### Workflow de Features
55
+ - `/git/feature/start "nome"` - Iniciar nova feature
56
+ - `/git/feature/finish` - Finalizar e mergear feature
57
+ - `/git/feature/publish` - Compartilhar feature em desenvolvimento
58
+
59
+ ### Workflow de Releases
60
+ - `/git/release/start "versão"` - Iniciar processo de release
61
+ - `/git/release/finish` - Finalizar e deployar release
62
+
63
+ ### Workflow de Hotfixes
64
+ - `/git/hotfix/start "nome"` - Iniciar correção urgente
65
+ - `/git/hotfix/finish` - Finalizar e deployar hotfix
66
+
67
+ ### Sincronização
68
+ - `/git/sync [branch]` - Sincronizar após merge de PR
69
+
70
+ ## ⚠️ Troubleshooting Comum
71
+
72
+ ### Repository não inicializado
73
+ **Problema**: Git Flow não configurado
74
+ **Solução**: Execute `/git/init` para configuração automática
75
+
76
+ ### Branch errada
77
+ **Problema**: Não está na branch correta para operação
78
+ **Solução**: Use comandos Git Flow que fazem checkout automaticamente
79
+
80
+ ### Conflitos de merge
81
+ **Problema**: Conflitos durante operações GitFlow
82
+ **Solução**: Resolva conflitos manualmente e continue com comando finish
83
+
84
+ ### Estado inconsistente
85
+ **Problema**: Operação GitFlow interrompida
86
+ **Solução**: Consulte @gitflow-specialist para análise e recovery
87
+
88
+ ## 💡 Próximos Passos Sugeridos
89
+
90
+ O sistema detectará automaticamente sua situação atual e sugerirá:
91
+
92
+ - **Se Git Flow não inicializado**: `/git/init`
93
+ - **Se em develop**: `/git/feature/start "nome-da-feature"`
94
+ - **Se em feature branch**: `/git/feature/finish` ou `/git/feature/publish`
95
+ - **Se pronto para release**: `/git/release/start "versão"`
96
+ - **Se problema em produção**: `/git/hotfix/start "correção"`
97
+
98
+ ---
99
+
100
+ *Este comando sempre consulta @gitflow-specialist para fornecer guidance contextual e personalizada.*