@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.
- package/LICENSE +21 -0
- package/README.md +529 -0
- package/bin/onion.js +6 -0
- package/framework/CLAUDE.md +45 -0
- package/framework/VERSION +1 -0
- package/framework/agents/compliance/iso-22301-specialist.md +985 -0
- package/framework/agents/compliance/iso-27001-specialist.md +713 -0
- package/framework/agents/compliance/pmbok-specialist.md +739 -0
- package/framework/agents/compliance/security-information-master.md +907 -0
- package/framework/agents/compliance/soc2-specialist.md +889 -0
- package/framework/agents/deployment/docker-specialist.md +1192 -0
- package/framework/agents/development/c4-architecture-specialist.md +745 -0
- package/framework/agents/development/c4-documentation-specialist.md +695 -0
- package/framework/agents/development/clickup-specialist.md +396 -0
- package/framework/agents/development/cursor-specialist.md +277 -0
- package/framework/agents/development/docs-reverse-engineer.md +417 -0
- package/framework/agents/development/gamma-api-specialist.md +1168 -0
- package/framework/agents/development/gitflow-specialist.md +1206 -0
- package/framework/agents/development/linux-security-specialist.md +675 -0
- package/framework/agents/development/mermaid-specialist.md +515 -0
- package/framework/agents/development/nodejs-specialist.md +672 -0
- package/framework/agents/development/nx-migration-specialist.md +866 -0
- package/framework/agents/development/nx-monorepo-specialist.md +618 -0
- package/framework/agents/development/postgres-specialist.md +1123 -0
- package/framework/agents/development/react-developer.md +131 -0
- package/framework/agents/development/runflow-specialist.md +277 -0
- package/framework/agents/development/system-documentation-orchestrator.md +1387 -0
- package/framework/agents/development/task-specialist.md +677 -0
- package/framework/agents/git/branch-code-reviewer.md +225 -0
- package/framework/agents/git/branch-documentation-writer.md +161 -0
- package/framework/agents/git/branch-metaspec-checker.md +67 -0
- package/framework/agents/git/branch-test-planner.md +176 -0
- package/framework/agents/meta/agent-creator-specialist.md +1266 -0
- package/framework/agents/meta/command-creator-specialist.md +1676 -0
- package/framework/agents/meta/metaspec-gate-keeper.md +240 -0
- package/framework/agents/meta/onion.md +824 -0
- package/framework/agents/product/branding-positioning-specialist.md +1029 -0
- package/framework/agents/product/extract-meeting-specialist.md +394 -0
- package/framework/agents/product/meeting-consolidator.md +482 -0
- package/framework/agents/product/pain-price-specialist.md +508 -0
- package/framework/agents/product/presentation-orchestrator.md +1190 -0
- package/framework/agents/product/product-agent.md +201 -0
- package/framework/agents/product/story-points-framework-specialist.md +538 -0
- package/framework/agents/product/storytelling-business-specialist.md +890 -0
- package/framework/agents/research/research-agent.md +292 -0
- package/framework/agents/review/code-reviewer.md +154 -0
- package/framework/agents/review/corporate-compliance-specialist.md +370 -0
- package/framework/agents/testing/test-agent.md +424 -0
- package/framework/agents/testing/test-engineer.md +294 -0
- package/framework/agents/testing/test-planner.md +117 -0
- package/framework/commands/common/prompts/README.md +208 -0
- package/framework/commands/common/prompts/clickup-patterns.md +144 -0
- package/framework/commands/common/prompts/code-review-checklist.md +168 -0
- package/framework/commands/common/prompts/git-workflow-patterns.md +235 -0
- package/framework/commands/common/prompts/output-formats.md +240 -0
- package/framework/commands/common/prompts/technical.md +194 -0
- package/framework/commands/common/templates/abstraction-template.md +399 -0
- package/framework/commands/common/templates/agent-template.md +353 -0
- package/framework/commands/common/templates/business_context_template.md +748 -0
- package/framework/commands/common/templates/command-template.md +273 -0
- package/framework/commands/common/templates/technical_context_template.md +526 -0
- package/framework/commands/design/screen-spec.md +505 -0
- package/framework/commands/development/runflow-dev.md +465 -0
- package/framework/commands/docs/build-business-docs.md +299 -0
- package/framework/commands/docs/build-compliance-docs.md +143 -0
- package/framework/commands/docs/build-index.md +119 -0
- package/framework/commands/docs/build-tech-docs.md +221 -0
- package/framework/commands/docs/docs-health.md +141 -0
- package/framework/commands/docs/help.md +278 -0
- package/framework/commands/docs/refine-vision.md +25 -0
- package/framework/commands/docs/reverse-consolidate.md +158 -0
- package/framework/commands/docs/sync-sessions.md +354 -0
- package/framework/commands/docs/validate-docs.md +157 -0
- package/framework/commands/engineer/bump.md +29 -0
- package/framework/commands/engineer/docs.md +11 -0
- package/framework/commands/engineer/hotfix.md +183 -0
- package/framework/commands/engineer/plan.md +85 -0
- package/framework/commands/engineer/pr-update.md +219 -0
- package/framework/commands/engineer/pr.md +117 -0
- package/framework/commands/engineer/pre-pr.md +81 -0
- package/framework/commands/engineer/start.md +254 -0
- package/framework/commands/engineer/validate-phase-sync.md +134 -0
- package/framework/commands/engineer/warm-up.md +20 -0
- package/framework/commands/engineer/work.md +155 -0
- package/framework/commands/f/company-context-extractor.md +93 -0
- package/framework/commands/f/process-meetings.md +103 -0
- package/framework/commands/git/README.md +682 -0
- package/framework/commands/git/code-review.md +213 -0
- package/framework/commands/git/fast-commit.md +43 -0
- package/framework/commands/git/feature/finish.md +88 -0
- package/framework/commands/git/feature/publish.md +89 -0
- package/framework/commands/git/feature/start.md +172 -0
- package/framework/commands/git/help.md +100 -0
- package/framework/commands/git/hotfix/finish.md +96 -0
- package/framework/commands/git/hotfix/start.md +92 -0
- package/framework/commands/git/init.md +111 -0
- package/framework/commands/git/release/finish.md +96 -0
- package/framework/commands/git/release/start.md +93 -0
- package/framework/commands/git/sync.md +199 -0
- package/framework/commands/meta/all-tools.md +58 -0
- package/framework/commands/meta/analyze-complex-problem.md +186 -0
- package/framework/commands/meta/create-abstraction.md +882 -0
- package/framework/commands/meta/create-agent-express.md +98 -0
- package/framework/commands/meta/create-agent.md +210 -0
- package/framework/commands/meta/create-command.md +203 -0
- package/framework/commands/meta/create-knowledge-base.md +143 -0
- package/framework/commands/meta/create-task-structure.md +150 -0
- package/framework/commands/meta/setup-integration.md +274 -0
- package/framework/commands/onion.md +169 -0
- package/framework/commands/product/README.md +249 -0
- package/framework/commands/product/analyze-pain-price.md +694 -0
- package/framework/commands/product/branding.md +458 -0
- package/framework/commands/product/check.md +46 -0
- package/framework/commands/product/checklist-sync.md +239 -0
- package/framework/commands/product/collect.md +95 -0
- package/framework/commands/product/consolidate-meetings.md +291 -0
- package/framework/commands/product/estimate.md +511 -0
- package/framework/commands/product/extract-meeting.md +226 -0
- package/framework/commands/product/feature.md +416 -0
- package/framework/commands/product/light-arch.md +82 -0
- package/framework/commands/product/presentation.md +174 -0
- package/framework/commands/product/refine.md +161 -0
- package/framework/commands/product/spec.md +79 -0
- package/framework/commands/product/task-check.md +378 -0
- package/framework/commands/product/task.md +603 -0
- package/framework/commands/product/validate-task.md +325 -0
- package/framework/commands/product/warm-up.md +24 -0
- package/framework/commands/quick/analisys.md +17 -0
- package/framework/commands/test/e2e.md +377 -0
- package/framework/commands/test/integration.md +508 -0
- package/framework/commands/test/unit.md +381 -0
- package/framework/commands/validate/collab/pair-testing.md +657 -0
- package/framework/commands/validate/collab/three-amigos.md +534 -0
- package/framework/commands/validate/qa-points/estimate.md +660 -0
- package/framework/commands/validate/test-strategy/analyze.md +1201 -0
- package/framework/commands/validate/test-strategy/create.md +411 -0
- package/framework/commands/validate/workflow.md +370 -0
- package/framework/commands/warm-up.md +20 -0
- package/framework/docs/architecture/acoplamento-clickup-problema-analise.md +468 -0
- package/framework/docs/architecture/desacoplamento-roadmap.md +364 -0
- package/framework/docs/architecture/validacao-fase-1.md +235 -0
- package/framework/docs/c4/c4-detection-rules.md +395 -0
- package/framework/docs/c4/c4-documentation-templates.md +579 -0
- package/framework/docs/c4/c4-mermaid-patterns.md +331 -0
- package/framework/docs/c4/c4-templates.md +256 -0
- package/framework/docs/clickup/clickup-acceptance-criteria-strategy.md +329 -0
- package/framework/docs/clickup/clickup-auto-update-strategy.md +340 -0
- package/framework/docs/clickup/clickup-comment-formatter.md +239 -0
- package/framework/docs/clickup/clickup-description-fix.md +384 -0
- package/framework/docs/clickup/clickup-dual-comment-strategy.md +528 -0
- package/framework/docs/clickup/clickup-formatting.md +302 -0
- package/framework/docs/clickup/separador-tamanho-otimizado.md +258 -0
- package/framework/docs/engineer/pre-pr-acceptance-validation.md +256 -0
- package/framework/docs/onion/ESPERANTO.md +293 -0
- package/framework/docs/onion/agents-reference.md +832 -0
- package/framework/docs/onion/clickup-integration.md +780 -0
- package/framework/docs/onion/commands-guide.md +924 -0
- package/framework/docs/onion/engineering-flows.md +900 -0
- package/framework/docs/onion/getting-started.md +803 -0
- package/framework/docs/onion/maintenance-checklist.md +421 -0
- package/framework/docs/onion/naming-conventions.md +286 -0
- package/framework/docs/onion/practical-examples.md +854 -0
- package/framework/docs/product/story-points-integration.md +269 -0
- package/framework/docs/product/story-points-validation.md +237 -0
- package/framework/docs/reviews/task-manager-docs-review-2025-11-24.md +184 -0
- package/framework/docs/strategies/clickup-comment-patterns.md +766 -0
- package/framework/docs/strategies/clickup-integration-tests.md +602 -0
- package/framework/docs/strategies/clickup-mcp-wrappers-tests.md +888 -0
- package/framework/docs/strategies/clickup-regression-tests.md +587 -0
- package/framework/docs/strategies/visual-patterns.md +315 -0
- package/framework/docs/templates/README.md +649 -0
- package/framework/docs/templates/adr-template.md +226 -0
- package/framework/docs/templates/analysis-template.md +280 -0
- package/framework/docs/templates/execution-plan-template.md +430 -0
- package/framework/docs/templates/guide-template.md +367 -0
- package/framework/docs/templates/phase-execution-prompt-template.md +504 -0
- package/framework/docs/templates/reference-template.md +522 -0
- package/framework/docs/templates/solution-template.md +390 -0
- package/framework/docs/tools/README.md +356 -0
- package/framework/docs/tools/agents.md +365 -0
- package/framework/docs/tools/commands.md +669 -0
- package/framework/docs/tools/cursor.md +539 -0
- package/framework/docs/tools/mcps.md +937 -0
- package/framework/docs/tools/rules.md +461 -0
- package/framework/rules/language-and-documentation.mdc +371 -0
- package/framework/rules/nestjs-controllers.md +83 -0
- package/framework/rules/nestjs-dtos.md +255 -0
- package/framework/rules/nestjs-modules.md +141 -0
- package/framework/rules/nestjs-services.md +230 -0
- package/framework/rules/nx-rules.mdc +41 -0
- package/framework/rules/onion-patterns.mdc +197 -0
- package/framework/skills/codebase-visualizer/SKILL.md +26 -0
- package/framework/skills/codebase-visualizer/scripts/visualize.py +131 -0
- package/framework/skills/collect/SKILL.md +84 -0
- package/framework/skills/create-rule/SKILL.md +152 -0
- package/framework/skills/db-schema-visualizer/SKILL.md +49 -0
- package/framework/skills/db-schema-visualizer/scripts/visualize.py +1191 -0
- package/framework/skills/sync-meetings/SKILL.md +239 -0
- package/framework/utils/clickup-mcp-wrappers.md +744 -0
- package/framework/utils/date-time-standards.md +200 -0
- package/framework/utils/task-manager/README.md +94 -0
- package/framework/utils/task-manager/adapters/asana.md +377 -0
- package/framework/utils/task-manager/adapters/clickup.md +467 -0
- package/framework/utils/task-manager/adapters/linear.md +421 -0
- package/framework/utils/task-manager/detector.md +299 -0
- package/framework/utils/task-manager/factory.md +363 -0
- package/framework/utils/task-manager/interface.md +248 -0
- package/framework/utils/task-manager/types.md +409 -0
- package/package.json +41 -0
- package/src/cli.js +73 -0
- package/src/commands/doctor.js +191 -0
- package/src/commands/init.js +287 -0
- package/src/commands/install.js +261 -0
- package/src/commands/list.js +152 -0
- package/src/commands/uninstall.js +90 -0
- package/src/commands/update.js +26 -0
- package/src/utils/fs.js +89 -0
- package/src/utils/log.js +35 -0
- package/src/utils/paths.js +32 -0
- 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.
|