@maestro-ai/cli 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.md +161 -29
  2. package/content/guides/fases-mapeamento.md +35 -0
  3. package/content/guides/multi-ide.md +32 -0
  4. package/content/guides/playbook-orquestrador.md +45 -0
  5. package/content/rules/GEMINI.md +841 -0
  6. package/content/rules/RULES.md +835 -0
  7. package/content/rules/adapters/copilot.md +10 -0
  8. package/content/rules/adapters/cursor.md +10 -0
  9. package/content/rules/adapters/gemini.md +13 -0
  10. package/content/rules/adapters/windsurf.md +10 -0
  11. package/content/rules/quality-gates.md +43 -0
  12. package/content/rules/validation-rules.md +97 -0
  13. package/content/templates/estado-template.json +73 -0
  14. package/content/workflows/avancar-fase.md +84 -0
  15. package/content/workflows/brainstorm.md +22 -8
  16. package/content/workflows/continuar-fase.md +64 -0
  17. package/content/workflows/{mcp-debug.md → corrigir-bug.md} +30 -6
  18. package/content/workflows/iniciar-projeto.md +59 -0
  19. package/content/workflows/maestro.md +77 -0
  20. package/content/workflows/{mcp-feature.md → nova-feature.md} +81 -28
  21. package/content/workflows/{mcp-refactor.md → refatorar-codigo.md} +33 -10
  22. package/content/workflows/status-projeto.md +54 -0
  23. package/dist/commands/init.d.ts +2 -1
  24. package/dist/commands/init.js +99 -55
  25. package/dist/index.js +100 -3
  26. package/package.json +10 -4
  27. package/content/workflows/README-MCP.md +0 -363
  28. package/content/workflows/debug.md +0 -103
  29. package/content/workflows/mcp-next.md +0 -388
  30. package/content/workflows/mcp-start.md +0 -304
  31. package/content/workflows/mcp-status.md +0 -400
  32. package/content/workflows/preview.md +0 -81
  33. package/content/workflows/status.md +0 -86
  34. /package/content/workflows/{create.md → create-app.md} +0 -0
  35. /package/content/workflows/{enhance.md → melhorar-feature.md} +0 -0
  36. /package/content/workflows/{test.md → testar.md} +0 -0
  37. /package/content/workflows/{ui-ux-pro-max.md → ux-avancado.md} +0 -0
  38. /package/content/workflows/{mcp-gate.md → validar-gate.md} +0 -0
@@ -1,400 +0,0 @@
1
- ---
2
- description: Visualizar status completo do projeto MCP com métricas e progresso
3
- ---
4
-
5
- # /mcp-status - Status do Projeto MCP
6
-
7
- $ARGUMENTS
8
-
9
- ---
10
-
11
- ## Objetivo
12
-
13
- Visualizar estado completo do projeto MCP Maestro: fase atual, progresso, gates, stack tecnológica e próximos passos.
14
-
15
- ---
16
-
17
- ## Execução
18
-
19
- ### Verificar Contexto MCP
20
-
21
- ```typescript
22
- if (!fs.existsSync('.maestro/estado.json')) {
23
- return `
24
- ❌ **Nenhum projeto MCP ativo**
25
-
26
- Para iniciar um projeto, use:
27
- \`/mcp-start\`
28
- `;
29
- }
30
-
31
- const estadoJson = await fs.readFile('.maestro/estado.json', 'utf-8');
32
-
33
- await mcp_maestro_status({
34
- estado_json: estadoJson,
35
- diretorio: process.cwd()
36
- });
37
- ```
38
-
39
- ---
40
-
41
- ## Formato de Saída
42
-
43
- ```markdown
44
- # 📊 Status MCP Maestro
45
-
46
- ## 📁 Projeto
47
-
48
- - **Nome:** [nome do projeto]
49
- - **Diretório:** [caminho absoluto]
50
- - **Tipo de Artefato:** [POC / Script / Internal / Product]
51
- - **Complexidade:** [Simples / Médio / Complexo]
52
- - **Tier de Gates:** [Essencial / Base / Avançado]
53
-
54
- ---
55
-
56
- ## 🎯 Progresso
57
-
58
- **Fase Atual:** [numero]/[total] - [nome da fase]
59
-
60
- ```
61
- [▓▓▓▓▓▓▓▓▓░░░░░░] 60% completo
62
- ```
63
-
64
- **Fases:**
65
- 1. ✅ Produto (100%)
66
- 2. ✅ Requisitos (100%)
67
- 3. ✅ UX Design (100%)
68
- 4. 🔄 Modelagem de Domínio (em andamento)
69
- 5. ⏳ Arquitetura de Software (pendente)
70
- 6. ⏳ ... (pendente)
71
-
72
- ---
73
-
74
- ## 🤖 Especialista Atual
75
-
76
- **Nome:** [Especialista em Modelagem de Domínio]
77
- **Papel:** [Definir entidades, relacionamentos, agregados e eventos de domínio]
78
- **Entregável Esperado:** `modelo-dominio.md`
79
-
80
- ---
81
-
82
- ## 🏗️ Stack Tecnológica
83
-
84
- - **Framework:** [Next.js 14 / Laravel 11 / NestJS / etc]
85
- - **Database:** [PostgreSQL / MySQL / MongoDB]
86
- - **Linguagem:** [TypeScript / PHP / Java]
87
- - **Cloud:** [AWS / GCP / Azure / Vercel]
88
-
89
- ---
90
-
91
- ## 🚦 Último Gate
92
-
93
- **Fase:** [numero] - [nome]
94
- **Score:** [score]/100
95
- **Status:** [✅ Aprovado / ⚠️ Aprovado com pendências / 🔴 Bloqueado]
96
-
97
- ${score < 100 ? `
98
- **Pendências:**
99
- ${pendencias.map(p => `- ${p}`).join('\n')}
100
- ` : ''}
101
-
102
- ---
103
-
104
- ## 📈 Métricas
105
-
106
- - **Fases Concluídas:** [numero]/[total] ([percentual]%)
107
- - **Entregáveis Salvos:** [numero]
108
- - **Gates Validados:** [numero_aprovados]/[numero_total]
109
- - **Tempo no Projeto:** [dias desde inicio]
110
-
111
- ---
112
-
113
- ## 📋 Próximos Passos
114
-
115
- 1. **Completar Fase Atual:** [nome da fase]
116
- - Criar: `[entregável esperado]`
117
- - Validação: [checklist resumido]
118
-
119
- 2. **Avançar:** Use `/mcp-next [arquivo]`
120
-
121
- 3. **Próxima Fase:** [numero+1] - [nome]
122
- - Especialista: [nome]
123
- - Template: [template.md]
124
-
125
- ---
126
-
127
- ## 🔗 Comandos Úteis
128
-
129
- \`\`\`
130
- /mcp-next [arquivo] → Avançar para próxima fase
131
- /mcp-gate → Validar gate atual
132
- /mcp-feature [descrição] → Adicionar nova feature
133
- /mcp-debug [descrição] → Corrigir bug
134
- \`\`\`
135
- ```
136
-
137
- ---
138
-
139
- ## Variações de Comando
140
-
141
- ### Status Básico
142
-
143
- ```
144
- /mcp-status
145
- ```
146
-
147
- → Saída completa acima
148
-
149
- ### Status Resumido
150
-
151
- ```
152
- /mcp-status --short
153
- ```
154
-
155
- → Saída:
156
-
157
- ```
158
- 📊 RestaurantePro - Product Médio (Fase 4/13)
159
- 🎯 Modelagem de Domínio [▓▓▓▓▓▓░░░░░░░] 46%
160
- 📄 Entregável: modelo-dominio.md
161
- ```
162
-
163
- ### Status com Histórico
164
-
165
- ```
166
- /mcp-status --history
167
- ```
168
-
169
- → Adiciona seção:
170
-
171
- ```markdown
172
- ## 📜 Histórico de Fases
173
-
174
- | Fase | Nome | Concluída em | Score | Duração |
175
- |------|------|--------------|-------|---------|
176
- | 1 | Produto | 2026-01-20 | 95/100 | 2h |
177
- | 2 | Requisitos | 2026-01-21 | 85/100 | 3h |
178
- | 3 | UX Design | 2026-01-22 | 90/100 | 4h |
179
- | 4 | Modelagem | Em andamento | - | 1h até agora |
180
- ```
181
-
182
- ---
183
-
184
- ## Exemplos de Saída
185
-
186
- ### Exemplo 1: Projeto no Meio (Fase 4/13)
187
-
188
- ```markdown
189
- # 📊 Status MCP Maestro
190
-
191
- ## 📁 Projeto
192
-
193
- - **Nome:** RestaurantePro
194
- - **Tipo:** Product
195
- - **Complexidade:** Médio (13 fases)
196
- - **Tier:** Base
197
-
198
- ---
199
-
200
- ## 🎯 Progresso
201
-
202
- **Fase Atual:** 4/13 - Modelagem de Domínio
203
-
204
- [▓▓▓▓▓░░░░░░░░] 31% completo
205
-
206
- **Fases:**
207
- 1. ✅ Produto
208
- 2. ✅ Requisitos
209
- 3. ✅ UX Design
210
- 4. 🔄 Modelagem de Domínio (em andamento)
211
- 5. ⏳ Banco de Dados
212
- 6. ⏳ Arquitetura de Software
213
- ...
214
-
215
- ---
216
-
217
- ## 🤖 Especialista Atual
218
-
219
- **Nome:** Especialista em Modelagem de Domínio
220
- **Entregável:** `modelo-dominio.md`
221
-
222
- ---
223
-
224
- ## 🏗️ Stack
225
-
226
- - Framework: Next.js 14
227
- - Database: PostgreSQL
228
- - Linguagem: TypeScript
229
-
230
- ---
231
-
232
- ## 🚦 Último Gate
233
-
234
- **Fase:** 3 - UX Design
235
- **Score:** 90/100 ✅
236
- **Pendências:**
237
- - Protótipos de alta fidelidade (opcional para tier Base)
238
-
239
- ---
240
-
241
- ## 📋 Próximos Passos
242
-
243
- 1. Completar modelo de domínio (Entidades, Agregados, Eventos)
244
- 2. Avançar: `/mcp-next docs/04-modelo/modelo-dominio.md`
245
- 3. Próxima: Fase 5 - Banco de Dados
246
- ```
247
-
248
- ### Exemplo 2: Projeto Concluído
249
-
250
- ```markdown
251
- # 📊 Status MCP Maestro
252
-
253
- ## 📁 Projeto
254
-
255
- - **Nome:** TaskFlow
256
- - **Tipo:** Internal
257
- - **Complexidade:** Simples (7 fases)
258
- - **Tier:** Base
259
-
260
- ---
261
-
262
- ## 🎯 Progresso
263
-
264
- **Status:** ✅ **PROJETO CONCLUÍDO**
265
-
266
- [▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100% completo
267
-
268
- **Todas as 7 fases finalizadas:**
269
- 1. ✅ Produto
270
- 2. ✅ Requisitos
271
- 3. ✅ UX Design
272
- 4. ✅ Modelagem
273
- 5. ✅ Arquitetura
274
- 6. ✅ Desenvolvimento
275
- 7. ✅ Deploy
276
-
277
- ---
278
-
279
- ## 🏆 Resumo Final
280
-
281
- - **Tempo Total:** 5 dias
282
- - **Entregáveis:** 7 documentos
283
- - **Score Médio dos Gates:** 87/100
284
- - **Deploy:** https://taskflow.example.com
285
-
286
- ---
287
-
288
- ## 📋 Próximos Passos
289
-
290
- 🎉 Projeto concluído!
291
-
292
- Para adicionar features:
293
- - `/mcp-feature [descrição]`
294
-
295
- Para manutenção:
296
- - `/mcp-debug [bug]`
297
- - `/mcp-refactor [área]`
298
- ```
299
-
300
- ### Exemplo 3: Nenhum Projeto Ativo
301
-
302
- ```
303
- ❌ **Nenhum projeto MCP ativo**
304
-
305
- Para iniciar um projeto, use:
306
- `/mcp-start`
307
-
308
- Ou, se já existe um projeto:
309
- `cd [diretorio-do-projeto]`
310
- `/mcp-status`
311
- ```
312
-
313
- ---
314
-
315
- ## Status em Contexto de Feature/Bug
316
-
317
- Se estiver em um fluxo de feature ou bug, mostra ambos:
318
-
319
- ```markdown
320
- # 📊 Status MCP Maestro
321
-
322
- ## 📁 Projeto Principal
323
-
324
- [status normal do projeto]
325
-
326
- ---
327
-
328
- ## 🆕 Feature em Andamento
329
-
330
- **ID:** FEAT-001
331
- **Descrição:** Sistema de notificações push
332
- **Fase:** 3/6 - Design
333
- **Progresso:** [▓▓▓▓░░] 50%
334
-
335
- Use `/mcp-next` para avançar a feature
336
-
337
- ---
338
-
339
- ## 🐛 Bug em Correção
340
-
341
- **ID:** BUG-002
342
- **Descrição:** Timeout no carregamento de imagens
343
- **Severidade:** Alta
344
- **Fase:** 2/4 - Análise de Causa Raiz
345
-
346
- Use `/mcp-next` para continuar o debug
347
- ```
348
-
349
- ---
350
-
351
- ## Integração com Dashboard Visual (Futuro)
352
-
353
- O status pode ser exportado para dashboards:
354
-
355
- ```
356
- /mcp-status --export json > status.json
357
- /mcp-status --export html > dashboard.html
358
- ```
359
-
360
- ---
361
-
362
- ## Comandos Relacionados
363
-
364
- ```
365
- /mcp-status → Status completo
366
- /mcp-status --short → Resumo de uma linha
367
- /mcp-status --history → Com histórico de fases
368
- /mcp-next → Avançar fase
369
- /mcp-start → Iniciar novo projeto
370
- ```
371
-
372
- ---
373
-
374
- ## Troubleshooting
375
-
376
- ### Status Desatualizado
377
-
378
- **Sintoma:** Status mostra fase antiga
379
-
380
- **Causa:** Cache de `resumo.json`
381
-
382
- **Solução:**
383
-
384
- ```bash
385
- # Forçar reload do estado.json
386
- /mcp-status --reload
387
- ```
388
-
389
- ### Múltiplos Projetos
390
-
391
- **Sintoma:** Status do projeto errado
392
-
393
- **Solução:**
394
-
395
- ```bash
396
- cd /caminho/do/projeto/correto
397
- /mcp-status
398
- ```
399
-
400
- O status sempre usa `.maestro/estado.json` do diretório atual.
@@ -1,81 +0,0 @@
1
- ---
2
- description: Preview server start, stop, and status check. Local development server management.
3
- ---
4
-
5
- # /preview - Preview Management
6
-
7
- $ARGUMENTS
8
-
9
- ---
10
-
11
- ## Task
12
-
13
- Manage preview server: start, stop, status check.
14
-
15
- ### Commands
16
-
17
- ```
18
- /preview - Show current status
19
- /preview start - Start server
20
- /preview stop - Stop server
21
- /preview restart - Restart
22
- /preview check - Health check
23
- ```
24
-
25
- ---
26
-
27
- ## Usage Examples
28
-
29
- ### Start Server
30
- ```
31
- /preview start
32
-
33
- Response:
34
- 🚀 Starting preview...
35
- Port: 3000
36
- Type: Next.js
37
-
38
- ✅ Preview ready!
39
- URL: http://localhost:3000
40
- ```
41
-
42
- ### Status Check
43
- ```
44
- /preview
45
-
46
- Response:
47
- === Preview Status ===
48
-
49
- 🌐 URL: http://localhost:3000
50
- 📁 Project: C:/projects/my-app
51
- 🏷️ Type: nextjs
52
- 💚 Health: OK
53
- ```
54
-
55
- ### Port Conflict
56
- ```
57
- /preview start
58
-
59
- Response:
60
- ⚠️ Port 3000 is in use.
61
-
62
- Options:
63
- 1. Start on port 3001
64
- 2. Close app on 3000
65
- 3. Specify different port
66
-
67
- Which one? (default: 1)
68
- ```
69
-
70
- ---
71
-
72
- ## Technical
73
-
74
- Auto preview uses `auto_preview.py` script:
75
-
76
- ```bash
77
- python .agent/scripts/auto_preview.py start [port]
78
- python .agent/scripts/auto_preview.py stop
79
- python .agent/scripts/auto_preview.py status
80
- ```
81
-
@@ -1,86 +0,0 @@
1
- ---
2
- description: Display agent and project status. Progress tracking and status board.
3
- ---
4
-
5
- # /status - Show Status
6
-
7
- $ARGUMENTS
8
-
9
- ---
10
-
11
- ## Task
12
-
13
- Show current project and agent status.
14
-
15
- ### What It Shows
16
-
17
- 1. **Project Info**
18
- - Project name and path
19
- - Tech stack
20
- - Current features
21
-
22
- 2. **Agent Status Board**
23
- - Which agents are running
24
- - Which tasks are completed
25
- - Pending work
26
-
27
- 3. **File Statistics**
28
- - Files created count
29
- - Files modified count
30
-
31
- 4. **Preview Status**
32
- - Is server running
33
- - URL
34
- - Health check
35
-
36
- ---
37
-
38
- ## Example Output
39
-
40
- ```
41
- === Project Status ===
42
-
43
- 📁 Project: my-ecommerce
44
- 📂 Path: C:/projects/my-ecommerce
45
- 🏷️ Type: nextjs-ecommerce
46
- 📊 Status: active
47
-
48
- 🔧 Tech Stack:
49
- Framework: next.js
50
- Database: postgresql
51
- Auth: clerk
52
- Payment: stripe
53
-
54
- ✅ Features (5):
55
- • product-listing
56
- • cart
57
- • checkout
58
- • user-auth
59
- • order-history
60
-
61
- ⏳ Pending (2):
62
- • admin-panel
63
- • email-notifications
64
-
65
- 📄 Files: 73 created, 12 modified
66
-
67
- === Agent Status ===
68
-
69
- ✅ database-architect → Completed
70
- ✅ backend-specialist → Completed
71
- 🔄 frontend-specialist → Dashboard components (60%)
72
- ⏳ test-engineer → Waiting
73
-
74
- === Preview ===
75
-
76
- 🌐 URL: http://localhost:3000
77
- 💚 Health: OK
78
- ```
79
-
80
- ---
81
-
82
- ## Technical
83
-
84
- Status uses these scripts:
85
- - `python .agent/scripts/session_manager.py status`
86
- - `python .agent/scripts/auto_preview.py status`
File without changes
File without changes