@maestro-ai/mcp-server 1.2.0 → 2.0.0

package/dist/content/skills/specialist-plano-execucao-ia/resources/templates/historia-backend.md

@@ -0,0 +1,157 @@
+# BE-{{ID}}: {{TITULO}}
+
+**Épico:** {{EPICO}}  
+**Feature:** {{FEATURE}}  
+**Tipo:** Backend  
+**Prioridade:** {{PRIORIDADE}}  
+**Estimativa:** {{ESTIMATIVA}} dias
+
+---
+
+## 📝 História
+
+**Como** sistema backend,  
+**Eu preciso** {{FUNCIONALIDADE}},  
+**Para** {{BENEFICIO_TECNICO}}.
+
+---
+
+## 🔌 Endpoints a Implementar
+
+### **{{METODO}} /api/{{ROTA}}**
+
+**Request:**
+```typescript
+interface {{REQUEST_DTO}} {
+  {{CAMPOS_REQUEST}}
+}
+```
+
+**Response:**
+```typescript
+interface {{RESPONSE_DTO}} {
+  {{CAMPOS_RESPONSE}}
+}
+```
+
+**Status Codes:**
+- `200 OK` - {{DESCRICAO_200}}
+- `400 Bad Request` - {{DESCRICAO_400}}
+- `401 Unauthorized` - {{DESCRICAO_401}}
+- `404 Not Found` - {{DESCRICAO_404}}
+- `500 Internal Server Error` - {{DESCRICAO_500}}
+
+---
+
+## 🏗️ Arquitetura
+
+### **Camadas a Implementar**
+
+**Controller:**
+```typescript
+// src/{{FEATURE}}/{{FEATURE}}.controller.ts
+@Controller('{{ROTA}}')
+export class {{FEATURE}}Controller {
+  @{{METODO}}()
+  async {{METODO_NOME}}(@Body() dto: {{REQUEST_DTO}}) {
+    return this.service.{{METODO_SERVICE}}(dto);
+  }
+}
+```
+
+**Service:**
+```typescript
+// src/{{FEATURE}}/{{FEATURE}}.service.ts
+@Injectable()
+export class {{FEATURE}}Service {
+  async {{METODO_SERVICE}}(dto: {{REQUEST_DTO}}): Promise<{{RESPONSE_DTO}}> {
+    // Lógica de negócio
+  }
+}
+```
+
+**Repository:**
+```typescript
+// src/{{FEATURE}}/{{FEATURE}}.repository.ts
+@Injectable()
+export class {{FEATURE}}Repository {
+  async {{METODO_REPOSITORY}}(data: {{ENTITY_DATA}}): Promise<{{ENTITY}}> {
+    // Acesso ao banco
+  }
+}
+```
+
+**Entity:**
+```typescript
+// src/{{FEATURE}}/entities/{{ENTITY}}.entity.ts
+@Entity()
+export class {{ENTITY}} {
+  @PrimaryGeneratedColumn()
+  id: number;
+  
+  {{CAMPOS_ENTITY}}
+}
+```
+
+---
+
+## ✅ Critérios de Aceite
+
+### **Cenário 1: {{CENARIO_SUCESSO}}**
+```gherkin
+Dado que {{CONTEXTO_BACKEND}}
+Quando {{REQUISICAO}}
+Então {{RESPOSTA_ESPERADA}}
+E {{EFEITO_COLATERAL}}
+```
+
+### **Cenário 2: {{CENARIO_ERRO}}**
+```gherkin
+Dado que {{CONTEXTO_INVALIDO}}
+Quando {{REQUISICAO_INVALIDA}}
+Então {{ERRO_ESPERADO}}
+```
+
+---
+
+## 🔗 Dependências
+
+- [ ] CONT-{{ID}}: Contrato API definido
+- [ ] {{MIGRACAO_DB}}: Migração de banco criada
+- [ ] {{DEPENDENCIA_SERVICO}}
+
+---
+
+## 📋 Tarefas Técnicas
+
+- [ ] Criar DTOs (Request/Response)
+- [ ] Criar Entity e Repository
+- [ ] Implementar Service (lógica de negócio)
+- [ ] Implementar Controller
+- [ ] Adicionar validação (class-validator)
+- [ ] Implementar error handling
+- [ ] Criar testes unitários (Jest)
+- [ ] Criar testes de integração (Supertest)
+- [ ] Documentar API (Swagger)
+
+---
+
+## ✅ Definition of Done
+
+- [ ] Endpoints implementados conforme contrato
+- [ ] Lógica de negócio implementada
+- [ ] Validação de entrada (DTOs)
+- [ ] Error handling robusto
+- [ ] Testes unitários (>80% coverage)
+- [ ] Testes de integração passando
+- [ ] Documentação Swagger atualizada
+- [ ] Segurança implementada (auth, sanitização)
+- [ ] Logs estruturados
+- [ ] Code review aprovado
+- [ ] Deploy em staging
+
+---
+
+**Status:** 🔄 Backlog  
+**Assignee:** {{ASSIGNEE}}  
+**Sprint:** {{SPRINT}}

package/dist/content/skills/specialist-plano-execucao-ia/resources/templates/historia-frontend.md

@@ -0,0 +1,116 @@
+# FE-{{ID}}: {{TITULO}}
+
+**Épico:** {{EPICO}}  
+**Feature:** {{FEATURE}}  
+**Tipo:** Frontend  
+**Prioridade:** {{PRIORIDADE}}  
+**Estimativa:** {{ESTIMATIVA}} dias
+
+---
+
+## 📝 História
+
+**Como** {{PERSONA}},  
+**Eu quero** {{ACAO_UI}},  
+**Para** {{BENEFICIO}}.
+
+---
+
+## 🎨 Componentes a Criar/Modificar
+
+### **Componentes Novos**
+- `{{COMPONENTE_1}}.tsx` - {{DESCRICAO_1}}
+- `{{COMPONENTE_2}}.tsx` - {{DESCRICAO_2}}
+
+### **Componentes Modificados**
+- `{{COMPONENTE_EXISTENTE}}.tsx` - {{MODIFICACAO}}
+
+---
+
+## 🔌 Integração com API
+
+### **Endpoints Utilizados**
+```typescript
+// GET /api/{{ENDPOINT_1}}
+interface {{RESPONSE_TYPE_1}} {
+  {{CAMPOS}}
+}
+
+// POST /api/{{ENDPOINT_2}}
+interface {{REQUEST_TYPE}} {
+  {{CAMPOS}}
+}
+```
+
+### **Regra Frontend-First (Obrigatória)**
+- [ ] Contrato API validado (CONT-{{ID}})
+- [ ] Mocks ativos gerados do contrato
+- [ ] Frontend consome **somente** mocks até a fase de integração
+
+### **Mocks (MSW)**
+```typescript
+// mocks/handlers/{{FEATURE}}.ts
+export const {{FEATURE}}Handlers = [
+  rest.get('/api/{{ENDPOINT}}', (req, res, ctx) => {
+    return res(ctx.json({{MOCK_DATA}}));
+  }),
+];
+```
+
+---
+
+## ✅ Critérios de Aceite
+
+### **Cenário 1: {{CENARIO_UI_1}}**
+```gherkin
+Dado que o usuário está em {{PAGINA}}
+Quando {{ACAO_UI}}
+Então {{RESULTADO_VISUAL}}
+```
+
+### **Cenário 2: {{CENARIO_UI_2}}**
+```gherkin
+Dado que {{ESTADO_INICIAL}}
+Quando {{INTERACAO}}
+Então {{FEEDBACK_VISUAL}}
+```
+
+---
+
+## 🔗 Dependências
+
+- [ ] CONT-{{ID}}: Contrato API definido
+- [ ] {{DESIGN_COMPONENT}}: Design aprovado
+- [ ] {{DEPENDENCIA_TECNICA}}
+
+---
+
+## 📋 Tarefas Técnicas
+
+- [ ] Criar componentes base
+- [ ] Implementar lógica de estado (hooks/store)
+- [ ] Integrar com mocks MSW
+- [ ] Criar testes unitários (React Testing Library)
+- [ ] Criar testes E2E (Playwright/Cypress)
+- [ ] Validar responsividade
+- [ ] Validar acessibilidade (a11y)
+
+---
+
+## ✅ Definition of Done
+
+- [ ] Componentes implementados e testáveis
+- [ ] Integração com mocks funcionando
+- [ ] Testes unitários (>80% coverage)
+- [ ] Testes E2E passando
+- [ ] Responsivo (mobile, tablet, desktop)
+- [ ] Acessível (WCAG 2.1 AA)
+- [ ] Performance aceitável (Lighthouse >90)
+- [ ] Code review aprovado
+- [ ] Deploy em staging
+
+---
+
+**Status:** 🔄 Backlog  
+**Assignee:** {{ASSIGNEE}}  
+**Sprint:** {{SPRINT}}

package/dist/content/skills/specialist-plano-execucao-ia/resources/templates/historia-usuario.md

@@ -0,0 +1,66 @@
+# US-{{ID}}: {{TITULO}}
+
+**Épico:** {{EPICO}}  
+**Feature:** {{FEATURE}}  
+**Tipo:** História de Usuário  
+**Prioridade:** {{PRIORIDADE}}  
+**Estimativa:** {{ESTIMATIVA}} pontos
+
+---
+
+## 📝 História
+
+**Como** {{PERSONA}},  
+**Eu quero** {{ACAO}},  
+**Para** {{BENEFICIO}}.
+
+---
+
+## ✅ Critérios de Aceite
+
+### **Cenário 1: {{CENARIO_1}}**
+```gherkin
+Dado que {{CONTEXTO}}
+Quando {{ACAO}}
+Então {{RESULTADO}}
+```
+
+### **Cenário 2: {{CENARIO_2}}**
+```gherkin
+Dado que {{CONTEXTO}}
+Quando {{ACAO}}
+Então {{RESULTADO}}
+```
+
+---
+
+## 🔗 Dependências
+
+- [ ] {{DEPENDENCIA_1}}
+- [ ] {{DEPENDENCIA_2}}
+
+---
+
+## 📋 Tarefas Técnicas
+
+- [ ] {{TAREFA_1}}
+- [ ] {{TAREFA_2}}
+- [ ] {{TAREFA_3}}
+
+---
+
+## ✅ Definition of Done
+
+- [ ] Código implementado
+- [ ] Testes unitários criados (>80% coverage)
+- [ ] Testes de integração passando
+- [ ] Code review aprovado
+- [ ] Documentação atualizada
+- [ ] Deploy em staging
+- [ ] Validação com stakeholder
+
+---
+
+**Status:** 🔄 Backlog  
+**Assignee:** {{ASSIGNEE}}  
+**Sprint:** {{SPRINT}}