@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,183 @@
1
+ ---
2
+ name: hotfix
3
+ description: |
4
+ Emergency workflow completo: task ClickUp + branch hotfix + desenvolvimento.
5
+ Use para correções urgentes em produção.
6
+ model: sonnet
7
+ parameters:
8
+ - name: description
9
+ description: Descrição do hotfix
10
+ required: true
11
+ - name: related_tasks
12
+ description: IDs de tasks relacionadas (comma-separated)
13
+ required: false
14
+ - name: tags
15
+ description: Tags adicionais (comma-separated)
16
+ required: false
17
+
18
+ category: engineer
19
+ tags:
20
+ - hotfix
21
+ - emergency
22
+ - gitflow
23
+
24
+ version: '3.0.0'
25
+ updated: '2025-11-24'
26
+
27
+ related_commands:
28
+ - /git/hotfix/start
29
+ - /git/hotfix/finish
30
+ - /product/task
31
+
32
+ related_agents:
33
+ - gitflow-specialist
34
+ - clickup-specialist
35
+ ---
36
+
37
+ # 🔥 Engineer Hotfix
38
+
39
+ Emergency workflow completo: Task + Branch + Desenvolvimento.
40
+
41
+ ## 🎯 Objetivo
42
+
43
+ Executar workflow de hotfix end-to-end em um único comando.
44
+
45
+ ## ⚡ Fluxo de Execução
46
+
47
+ ### Passo 1: Validar Input
48
+
49
+ ```bash
50
+ # Verificar descrição
51
+ if [ -z "{{description}}" ]; then
52
+ echo "❌ Descrição obrigatória"
53
+ exit 1
54
+ fi
55
+
56
+ # Verificar branch atual
57
+ CURRENT=$(git branch --show-current)
58
+ if [[ ! "$CURRENT" =~ ^(main|master|develop)$ ]]; then
59
+ echo "⚠️ Recomendado: iniciar de main/master"
60
+ fi
61
+ ```
62
+
63
+ ### Passo 2: Criar Task Emergencial
64
+
65
+ Via ClickUp MCP:
66
+
67
+ ```yaml
68
+ name: '🔥 HOTFIX: {{description}}'
69
+ list_id: [lista de hotfixes]
70
+ priority: urgent
71
+ tags:
72
+ - hotfix
73
+ - urgent
74
+ - { { tags } }
75
+ status: 'In Progress'
76
+ markdown_description: |
77
+ ## 🚨 Emergency Hotfix
78
+
79
+ **Descrição**: {{description}}
80
+
81
+ ## 📋 Checklist
82
+ - [ ] Diagnóstico
83
+ - [ ] Implementação
84
+ - [ ] Testes
85
+ - [ ] Deploy
86
+ ```
87
+
88
+ ### Passo 3: Criar Branch Hotfix
89
+
90
+ ```bash
91
+ # Garantir main atualizada
92
+ git checkout main
93
+ git pull origin main
94
+
95
+ # Criar hotfix branch
96
+ VERSION=$(cat package.json | grep version | head -1 | awk -F'"' '{print $4}')
97
+ PATCH=$(echo $VERSION | awk -F. '{print $1"."$2"."$3+1}')
98
+ BRANCH="hotfix/$PATCH-$(echo '{{description}}' | tr ' ' '-' | tr '[:upper:]' '[:lower:]' | head -c 30)"
99
+
100
+ git checkout -b $BRANCH
101
+ ```
102
+
103
+ ### Passo 4: Setup Session
104
+
105
+ ```bash
106
+ # Criar sessão de desenvolvimento
107
+ mkdir -p .claude/sessions/hotfix-$(date +%Y%m%d)/
108
+
109
+ # Criar context.md
110
+ cat > .claude/sessions/hotfix-$(date +%Y%m%d)/context.md << EOF
111
+ # Hotfix Context
112
+
113
+ ## Task
114
+ - ID: [task_id criado]
115
+ - URL: [url do clickup]
116
+
117
+ ## Branch
118
+ - Nome: $BRANCH
119
+ - Base: main
120
+
121
+ ## Descrição
122
+ {{description}}
123
+ EOF
124
+ ```
125
+
126
+ ### Passo 5: Iniciar Desenvolvimento
127
+
128
+ ```
129
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
130
+ 🔥 HOTFIX INICIADO
131
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
132
+
133
+ 📋 Task: [URL do ClickUp]
134
+ 🌿 Branch: hotfix/X.X.X-description
135
+
136
+ ⚡ Próximos Passos:
137
+ 1. Implementar correção
138
+ 2. Testar localmente
139
+ 3. /engineer/pre-pr
140
+ 4. /git/hotfix/finish
141
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
142
+ ```
143
+
144
+ ## 📤 Output Esperado
145
+
146
+ ### Sucesso
147
+
148
+ ```
149
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
150
+ ✅ HOTFIX SETUP COMPLETO
151
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
152
+
153
+ 📋 ClickUp:
154
+ ∟ Task: 🔥 HOTFIX: {{description}}
155
+ ∟ ID: 86adfxxxx
156
+ ∟ Status: In Progress
157
+ ∟ Priority: Urgent
158
+
159
+ 🌿 Git:
160
+ ∟ Branch: hotfix/1.2.3-fix-description
161
+ ∟ Base: main
162
+ ∟ Remote: origin
163
+
164
+ 📁 Session:
165
+ ∟ Path: .claude/sessions/hotfix-20251124/
166
+
167
+ 🚀 Comandos:
168
+ ∟ Desenvolver: /engineer/work
169
+ ∟ Pre-PR: /engineer/pre-pr
170
+ ∟ Finalizar: /git/hotfix/finish
171
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
172
+ ```
173
+
174
+ ## 🔗 Referências
175
+
176
+ - Padrões: `common/prompts/git-workflow-patterns.md`
177
+ - Agente: @gitflow-specialist
178
+
179
+ ## ⚠️ Notas
180
+
181
+ - Sempre parte de `main` ou `master`
182
+ - Task criada com prioridade máxima
183
+ - Merge automático para main E develop no finish
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: plan
3
+ description: Planejamento de feature. Analisa e cria plano estruturado.
4
+ model: sonnet
5
+ category: engineer
6
+ tags: [planning, architecture, design]
7
+ version: '3.0.0'
8
+ updated: '2025-11-24'
9
+ ---
10
+
11
+ # Engineer Reason
12
+
13
+ Este é o comando para iniciar o planejamento de uma funcionalidade.
14
+
15
+ <arguments>
16
+ #$ARGUMENTS
17
+ </arguments>
18
+
19
+ ## Análise
20
+
21
+ Leia os arquivos context.md e architecture.md na pasta .claude/sessions/<feature-slug> se ainda não tiver feito.
22
+
23
+ Sua tarefa agora é criar um plano de implementação detalhado (plan.md) para esta funcionalidade. O objetivo desta documentação é criar uma abordagem de implementação faseada que nos permita construir a funcionalidade incrementalmente, testando cada fase conforme avançamos. E também deve tornar possível retomar o trabalho caso nossa sessão seja interrompida.
24
+
25
+ O plan.md deve dividir a implementação em fases, cada fase com um pedaço do trabalho que pode ser realizado por um humano em 2 horas.
26
+
27
+ O template para o plan.md é:
28
+
29
+ <plan>
30
+ # [NOME DA FUNCIONALIDADE]
31
+
32
+ Se você está trabalhando nesta funcionalidade, certifique-se de atualizar este arquivo plan.md conforme progride.
33
+
34
+ ## FASE 1 [Completada ✅]
35
+
36
+ Detalhes desta parte da funcionalidade
37
+
38
+ ### Uma tarefa que foi feita [Completada ✅]
39
+
40
+ Detalhes sobre a tarefa
41
+
42
+ ### Uma tarefa que foi feita [Completada ✅]
43
+
44
+ Detalhes sobre a tarefa
45
+
46
+ ### Comentários:
47
+
48
+ - Algo que aconteceu e nos forçou a mudar de direção
49
+ - Algo que aprendemos durante o desenvolvimento
50
+ - Algo que discutimos e concordamos
51
+
52
+ ## FASE 2 [Em Progresso ⏰]
53
+
54
+ ### Uma tarefa que precisa ser feita [Em Progresso ⏰]
55
+
56
+ Detalhes sobre a tarefa
57
+
58
+ ### Uma tarefa que precisa ser feita [Não Iniciada ⏳]
59
+
60
+ Detalhes sobre a tarefa
61
+
62
+ ## FASE 3 [Não Iniciada ⏳]
63
+
64
+ ### Uma tarefa que precisa ser feita [Não Iniciada ⏳]
65
+
66
+ Detalhes sobre a tarefa
67
+
68
+ ### Uma tarefa que precisa ser feita [Não Iniciada ⏳]
69
+
70
+ Detalhes sobre a tarefa
71
+
72
+ </plan>
73
+
74
+ Dicas:
75
+
76
+ - Use repoprompt:search (se disponível) para encontrar arquivos específicos baseados nas respostas de descoberta
77
+ - Use repoprompt:set_selection e repoprompt:read_selected_files (se disponível) para ler código relevante em batch
78
+ - Analise detalhes específicos de implementação
79
+ - Use WebSearch e ou context7 para melhores práticas ou documentação de bibliotecas (se necessário)
80
+
81
+ No caso desta pesquisa levantar uma nova decisão arquitetural ou contradição com as decisões anteriores, você iniciará uma discussão sobre isso com o humano, concordará com as mudanças e atualizará o documento architecture.md para aquela funcionalidade se necessário.
82
+
83
+ Este documento também deve anotar quais tarefas precisam ser feitas sequencialmente ou em paralelo.
84
+
85
+ Uma vez que o plan.md esteja finalizado, informe ao humano que você está pronto para prosseguir para o próximo passo.
@@ -0,0 +1,219 @@
1
+ ---
2
+ name: pr-update
3
+ description: Atualizar PR existente com mudanças adicionais.
4
+ model: sonnet
5
+ category: engineer
6
+ tags: [pr, update, git]
7
+ version: '3.0.0'
8
+ updated: '2025-11-24'
9
+ ---
10
+
11
+ # 🔄 Engineer PR Update
12
+
13
+ Atualizar um Pull Request existente com mudanças adicionais. Este comando automatiza o processo completo de commit, push e documentação quando você já executou `/engineer/pr` mas fez mudanças subsequentes.
14
+
15
+ ## 🎯 Funcionalidades
16
+
17
+ ### Detecção Automática de Contexto
18
+
19
+ - Identifica automaticamente a branch de feature ativa
20
+ - Detecta mudanças pendentes (staged/unstaged/untracked)
21
+ - Valida se existe PR aberto para a branch atual
22
+ - Verifica se está na sessão de desenvolvimento correta
23
+
24
+ ### Commit Inteligente e Descritivo
25
+
26
+ - Analisa arquivos modificados para categorizar mudanças
27
+ - Gera mensagem de commit contextual e descritiva
28
+ - Suporta diferentes tipos de mudanças (fix, feat, docs, refactor)
29
+ - Mantém histórico limpo com commits atômicos
30
+
31
+ ### Sincronização Automática
32
+
33
+ - Push automático para branch do PR existente
34
+ - Atualização do ClickUp com comentário detalhado
35
+ - Validação de que PR foi atualizado com sucesso
36
+ - Timestamp e métricas das mudanças aplicadas
37
+
38
+ ## 🚀 Como Usar
39
+
40
+ ```bash
41
+ /engineer/pr-update
42
+ ```
43
+
44
+ ### Exemplos com Parâmetros Opcionais
45
+
46
+ ```bash
47
+ /engineer/pr-update # Análise automática + commit inteligente
48
+ /engineer/pr-update --type fix # Força tipo de commit específico
49
+ /engineer/pr-update --message "Custom msg" # Mensagem personalizada
50
+ /engineer/pr-update --dry-run # Preview sem executar
51
+ ```
52
+
53
+ ## 🤝 Integração ClickUp MCP
54
+
55
+ ### Detecção de Task Ativa
56
+
57
+ - Lê task ID do arquivo `.claude/sessions/[slug]/context.md`
58
+ - Identifica PR existente através da task ou branch
59
+ - Valida se task está em status "in progress" com tag "under-review"
60
+
61
+ ### Comentário Automático Padronizado
62
+
63
+ **Chamar abstração MCP para documentação de atualização:**
64
+
65
+ ```typescript
66
+ // Ao atualizar PR com novos commits, chamar:
67
+ await commentPRUpdated(taskId, {
68
+ commitType: 'fix|feat|refactor|docs|chore',
69
+ commitHash: '[hash do commit]',
70
+ filesModified: N,
71
+ linesAdded: N,
72
+ linesRemoved: N,
73
+ description: '[descrição das mudanças]',
74
+ });
75
+ ```
76
+
77
+ **Referências:**
78
+
79
+ - **Padrão 4 (PR Atualizada)**: `.claude/docs/strategies/clickup-comment-patterns.md`
80
+ - **Abstração MCP**: `commentPRUpdated()` em `.claude/utils/clickup-mcp-wrappers.md` (linhas 632-661)
81
+
82
+ ## ⚙️ Processo Automático
83
+
84
+ 1. **Validação de Contexto**: Confirma branch de feature + sessão ativa
85
+ 2. **Análise de Mudanças**: Categoriza arquivos modificados por tipo
86
+ 3. **Geração de Commit**: Cria mensagem contextual e descritiva
87
+ 4. **Staging Inteligente**: Adiciona apenas arquivos relevantes
88
+ 5. **Commit & Push**: Executa commit + push para branch do PR
89
+ 6. **Atualização ClickUp**: Documenta mudanças com comentário formatado
90
+ 7. **Validação Final**: Confirma que PR foi atualizado com sucesso
91
+
92
+ ## 🧠 Detecção Inteligente de Tipos
93
+
94
+ ### Tipos de Commit Auto-Detectados
95
+
96
+ - **fix**: Correções de bugs, patches, hotfixes
97
+ - **feat**: Novas funcionalidades, enhancements
98
+ - **docs**: Mudanças apenas em documentação
99
+ - **refactor**: Refatoração sem mudança de funcionalidade
100
+ - **style**: Formatação, linting, style fixes
101
+ - **test**: Adição ou correção de testes
102
+ - **chore**: Tarefas de manutenção, configuração
103
+
104
+ ### Análise de Arquivos Modificados
105
+
106
+ ```markdown
107
+ ## Categorização Automática:
108
+
109
+ - `.claude/commands/` → "feat/fix: Comando updates"
110
+ - `docs/` → "docs: Documentation updates"
111
+ - `tests/` → "test: Test updates"
112
+ - `*.md` (session files) → "chore: Session documentation"
113
+ - Múltiplos tipos → "chore: Multiple updates"
114
+ ```
115
+
116
+ ## ⚠️ Resolução de Problemas
117
+
118
+ ### Problema: "Não há PR ativo para esta branch"
119
+
120
+ **Solução**: Executar `/engineer/pr` primeiro para criar o PR inicial
121
+
122
+ ```bash
123
+ # Se necessário, criar PR primeiro:
124
+ /engineer/pr
125
+ ```
126
+
127
+ ### Problema: "Nenhuma mudança detectada"
128
+
129
+ **Solução**: Verificar se há arquivos modificados
130
+
131
+ ```bash
132
+ git status # Confirmar mudanças pendentes
133
+ ```
134
+
135
+ ### Problema: "Branch não está sincronizada"
136
+
137
+ **Solução**: Sincronizar branch antes de atualizar
138
+
139
+ ```bash
140
+ git pull origin [branch-name] # Sincronizar primeiro
141
+ /engineer/pr-update # Depois atualizar
142
+ ```
143
+
144
+ ### Problema: "Task ClickUp não encontrada"
145
+
146
+ **Solução**: Verificar context.md da sessão ativa
147
+
148
+ - Confirmar task ID no arquivo `.claude/sessions/[slug]/context.md`
149
+ - Validar se task existe e está acessível
150
+
151
+ ## 💡 Casos de Uso Comuns
152
+
153
+ ### 1. Correções Pós-Review
154
+
155
+ ```bash
156
+ # Após feedback do code review:
157
+ # 1. Fazer correções solicitadas
158
+ # 2. Executar:
159
+ /engineer/pr-update --type fix
160
+ ```
161
+
162
+ ### 2. Melhorias Adicionais
163
+
164
+ ```bash
165
+ # Após pensar em melhorias:
166
+ # 1. Implementar enhancements
167
+ # 2. Executar:
168
+ /engineer/pr-update --type feat
169
+ ```
170
+
171
+ ### 3. Documentação Esquecida
172
+
173
+ ```bash
174
+ # Após lembrar de documentar:
175
+ # 1. Atualizar docs
176
+ # 2. Executar:
177
+ /engineer/pr-update --type docs
178
+ ```
179
+
180
+ ### 4. Correções Arquiteturais
181
+
182
+ ```bash
183
+ # Como no exemplo atual:
184
+ # 1. Implementar correções arquiteturais
185
+ # 2. Executar:
186
+ /engineer/pr-update --type fix --message "Correção arquitetural - Phase→Subtask sync"
187
+ ```
188
+
189
+ ## 🔗 Integração com Workflow
190
+
191
+ ### Fluxo Padrão Completo
192
+
193
+ 1. `/product/task` - Criar task ClickUp
194
+ 2. `/engineer/start` - Iniciar desenvolvimento
195
+ 3. `/engineer/work` - Desenvolver features
196
+ 4. `/engineer/pre-pr` - Validações finais
197
+ 5. `/engineer/pr` - Criar Pull Request
198
+ 6. **`/engineer/pr-update`** - Atualizar PR com mudanças adicionais (quantas vezes necessário)
199
+ 7. Merge do PR → Auto-sync `/git/sync`
200
+
201
+ ### Compatibilidade com Comandos Existentes
202
+
203
+ - ✅ Funciona após `/engineer/pr`
204
+ - ✅ Integra com `/engineer/work` progress tracking
205
+ - ✅ Compatível com `/git/sync` automático pós-merge
206
+ - ✅ Respeita mapeamento Phase→Subtask do context.md
207
+
208
+ ---
209
+
210
+ **🎯 VALOR AGREGADO: Este comando elimina o processo manual de atualização de PRs, automatizando commit inteligente, push, e documentação ClickUp em uma única operação otimizada.**
211
+
212
+ ## 📈 Benefícios
213
+
214
+ - ⚡ **Automação completa** do processo de update
215
+ - 🧠 **Commits inteligentes** com mensagens contextuais
216
+ - 📝 **Documentação automática** no ClickUp
217
+ - 🔄 **Consistência** no workflow de PRs
218
+ - ⏰ **Economia de tempo** significativa
219
+ - 🎯 **Redução de erros** manuais
@@ -0,0 +1,117 @@
1
+ ---
2
+ name: pr
3
+ description: Criar Pull Request com integração GitFlow e sync automático.
4
+ model: sonnet
5
+ category: engineer
6
+ tags: [pr, gitflow, workflow]
7
+ version: '3.0.0'
8
+ updated: '2025-11-24'
9
+ ---
10
+
11
+ # 🚀 Engineer PR - GitFlow Integrated
12
+
13
+ Você é um assistente especializado em **criação de Pull Requests** com integração automática ao novo sistema `/git/sync` otimizado do Sistema Onion.
14
+
15
+ ## 🤖 **Nova Integração GitFlow**
16
+
17
+ Este comando agora inclui **sync automático pós-merge** usando:
18
+
19
+ - **GitFlow Analysis** via @gitflow-specialist
20
+ - **Performance otimizada** (cache + operações paralelas)
21
+ - **Cleanup inteligente** baseado na estratégia de branch
22
+ - **Session archiving** automático
23
+ - **ClickUp auto-update** para status "Done"
24
+
25
+ ---
26
+
27
+ Agora é solicitado que você faça um PR. Siga estes passos cuidadosamente para completar a tarefa:
28
+
29
+ 1. Primeiro, garanta que todos os testes estão funcionando para a branch atual. Execute a suíte de testes apropriada para seu projeto e confirme que todos os testes passam. Se algum teste falhar, corrija os problemas antes de prosseguir.
30
+
31
+ 2. **CRÍTICO - Criar Feature Branch PRIMEIRO:**
32
+ a. Crie uma feature branch a partir da branch base (develop/main):
33
+
34
+ ```bash
35
+ git checkout -b feature/[descricao-sucinta]
36
+ git push -u origin feature/[descricao-sucinta]
37
+ ```
38
+
39
+ b. Faça commit das mudanças que você fez. Use uma mensagem de commit clara e concisa que resuma as alterações.
40
+ c. Push dos commits para a feature branch.
41
+
42
+ 3. Mova a task do ClickUp associada com esta tarefa para o status "in progress" e adicione a tag "under-review".
43
+
44
+ 4. Adicione um comentário na task do ClickUp documentando o PR:
45
+
46
+ **Chamar abstração MCP para comentário automatizado:**
47
+
48
+ ```typescript
49
+ // Ao criar PR, chamar:
50
+ await commentPRCreated(taskId, {
51
+ prUrl: '[PR_URL]',
52
+ branch: '[branch-name]',
53
+ changesDescription: '[descrição das mudanças]',
54
+ testsStatus: 'passing|review|pending',
55
+ });
56
+ ```
57
+
58
+ **Referências:**
59
+
60
+ - **Padrão 3 (PR Criada)**: `.claude/docs/strategies/clickup-comment-patterns.md`
61
+ - **Abstração MCP**: `commentPRCreated()` em `.claude/utils/clickup-mcp-wrappers.md` (linhas 632-661)
62
+
63
+ 5. Abra um Pull Request (PR) com os detalhes da implementação:
64
+
65
+ Importante: Não mencione nenhum código relacionado a AI ou assistentes de IA no PR.
66
+
67
+ 6. Após abrir o PR, aguarde 3 minutos e então verifique comentários da ferramenta automatizada de code review. Se nenhum comentário aparecer, aguarde mais 3 minutos e verifique novamente.
68
+
69
+ 7. Uma vez que você receba comentários da ferramenta automatizada de code review, analise cada comentário cuidadosamente. Determine quais comentários requerem correções e quais podem ser ignorados com segurança ou explicados. Apresente suas sugestões ao usuário e peça permissão para fazer as mudanças.
70
+
71
+ 8. Para os comentários que requerem correções:
72
+ a. Faça as mudanças necessárias no código
73
+ b. Faça commit dessas mudanças com uma mensagem de commit clara
74
+ c. Faça push do(s) novo(s) commit(s) para a mesma branch
75
+
76
+ 9. Após abordar os comentários e fazer push das atualizações, aguarde a confirmação de merge do PR.
77
+
78
+ 10. **NOVO - Sync Automático Pós-Merge**: Uma vez que o PR for merged, execute automaticamente:
79
+
80
+ ```bash
81
+ /git/sync
82
+ ```
83
+
84
+ Este comando agora inclui:
85
+ - 🤖 **GitFlow Analysis** com @gitflow-specialist
86
+ - ⚡ **Performance otimizada** (cache + operações paralelas)
87
+ - 🧹 **Cleanup inteligente** baseado na estratégia GitFlow
88
+ - 📁 **Session management** automático com archiving
89
+ - 🔗 **ClickUp auto-update** para status "Done"
90
+
91
+ O sync será executado automaticamente com a estratégia otimizada baseada no tipo de branch e workflow detectado.
92
+
93
+ REGRA DE OURO: Sempre faça commit APENAS dos arquivos que você alterou. SE houver mais arquivos, pergunte ao usuário se eels devem ser incluidos. Não use `git add .` para prevenir commits de arquivos que não deveriam ser commitados, a não ser que o usuario confirme.
94
+
95
+ Seu output final deve ser uma mensagem para o usuário, formatada da seguinte forma:
96
+
97
+ <task_completion_message>
98
+ Tarefa completada:
99
+
100
+ - Testes estão passando
101
+ - Mudanças commitadas
102
+ - Task do ClickUp [INSERT TASK ID] movida para "in progress" com tag "under-review"
103
+ - PR aberto: [INSERT PR TITLE]
104
+ - Comentários do code review automatizado abordados e correções pushed
105
+ - 🤖 GitFlow integration: Auto-sync configurado para pós-merge
106
+
107
+ O PR está agora pronto para sua revisão final e merge manual.
108
+
109
+ 🚀 APÓS O MERGE: O comando `/git/sync` será executado automaticamente com:
110
+ ∟ GitFlow analysis via @gitflow-specialist
111
+ ∟ Performance otimizada (cache + operações paralelas)
112
+ ∟ Cleanup inteligente baseado na estratégia GitFlow
113
+ ∟ Session archiving automático
114
+ ∟ ClickUp auto-update para status "Done"
115
+
116
+ [INSERT PR LINK]
117
+ </task_completion_message>
@@ -0,0 +1,81 @@
1
+ ---
2
+ name: pre-pr
3
+ description: Validação completa antes do PR. Verifica padrões e qualidade.
4
+ model: sonnet
5
+ category: engineer
6
+ tags: [validation, pr, quality]
7
+ version: '3.0.0'
8
+ updated: '2025-11-24'
9
+ ---
10
+
11
+ # Pre-PR - Validação Completa Antes do Pull Request
12
+
13
+ Estamos nos aproximando de finalizar o trabalho nesta branch e nos preparar para um pull request. Agora, é hora de fazer verificações finais e limpezas para garantir que estamos alinhados com nossos padrões e objetivos.
14
+
15
+ ## 🔄 **Auto-Update ClickUp**
16
+
17
+ Este comando **automaticamente atualiza** a task ClickUp durante preparação para PR:
18
+
19
+ ### **✅ Updates Automáticos SEMPRE:**
20
+
21
+ - **Validação de critérios de aceitação** - Verifica todos os checkboxes
22
+ - **Comentário de preparação** com checklist completo
23
+ - **Tag 'ready-for-pr'** quando todas verificações passam
24
+ - **Tag 'needs-fixes'** se verificações falham
25
+ - **Progresso estimado** para 90% (quase pronto)
26
+
27
+ ### **💬 Formato do Comentário de Pre-PR:**
28
+
29
+ **Chamar abstrações MCP para validação automatizada:**
30
+
31
+ ```typescript
32
+ // 1. Validar Critérios de Aceitação
33
+ const validation = await validateAcceptanceCriteria(taskId);
34
+ // Retorna: { isComplete, coverage, criteria[], pendingCriteria[] }
35
+
36
+ // 2. Criar comentário de validação com resultado
37
+ await commentPrePRValidation(taskId, {
38
+ validationResult: validation,
39
+ technicalChecks: { metaSpecs: true, codeReview: true, tests: true },
40
+ readyForPR: validation.isComplete,
41
+ });
42
+ ```
43
+
44
+ **Referências:**
45
+
46
+ - **Padrão 5 (Validação Pre-PR)**: `.claude/docs/strategies/clickup-comment-patterns.md`
47
+ - **Abstrações MCP**:
48
+ - `validateAcceptanceCriteria()` em `.claude/utils/clickup-mcp-wrappers.md` (linhas 534-600)
49
+ - `commentPrePRValidation()` em `.claude/utils/clickup-mcp-wrappers.md` (linhas 603-629)
50
+
51
+ ### **📋 Identificação da Task:**
52
+
53
+ 1. **Context.md**: Lê task-id da sessão ativa
54
+ 2. **Branch atual**: Detecta automaticamente pela branch git
55
+
56
+ ## Checklist de Preparação:
57
+
58
+ ### ✅ Validação de Critérios de Aceitação:
59
+
60
+ 1. **Extrair critérios** - Ler checkboxes da description da task/subtask
61
+ 2. **Validar cobertura** - Confirmar que TODOS os checkboxes estão marcados `[x]`
62
+ 3. **Gerar relatório** - Criar lista de critérios validados
63
+ 4. **Bloquear se incompleto** - Se algum critério não estiver marcado, indicar no comentário
64
+
65
+ ### 🔧 Validações Técnicas:
66
+
67
+ 1. Invoque o agente `branch-metaspec-checker` para verificar se a branch está alinhada com as meta specs do projeto.
68
+ 2. Invoque o agente `branch-code-reviewer` para revisar o código e garantir que está bom para lançar.
69
+ 3. Invoque o agente `branch-documentation-writer` para atualizar a documentação do projeto.
70
+ 4. Invoque o agente `branch-test-planner` para finalizar a escrita de testes para a branch.
71
+
72
+ ### 📋 AUTO-UPDATE:
73
+
74
+ 5. **Validar critérios de aceitação** - Verificar todos os checkboxes
75
+ 6. **Adicionar comentário de preparação** no ClickUp automaticamente
76
+ 7. **Aplicar tags** (ready-for-pr ou needs-fixes)
77
+ 8. **Atualizar progresso** para 90%
78
+
79
+ Você também precisará lidar com todo o feedback que esses agentes fornecerem e fazer mudanças e correções conforme necessário.
80
+
81
+ Uma vez terminado E todos os critérios de aceitação validados, me avise e peça minha permissão para abrir o Pull Request.