@maestro-ai/mcp-server 1.0.0

package/dist/content/guides/M/303/251tricas de Efici/303/252ncia do Desenvolvimento com IA.md"

@@ -0,0 +1,93 @@
+# Métricas de Eficiência do Desenvolvimento com IA
+
+Como medir o impacto do uso de IA no seu fluxo de desenvolvimento.
+
+---
+
+## Por que Medir?
+
+- Justificar investimento em ferramentas de IA
+- Identificar onde IA agrega mais valor
+- Otimizar prompts e workflows
+- Treinar equipe em melhores práticas
+
+---
+
+## Métricas Principais
+
+### 1. Tempo Economizado
+
+| Atividade | Sem IA | Com IA | Economia |
+|---|---|---|---|
+| Escrever testes | X min | Y min | Z% |
+| Documentar código | X min | Y min | Z% |
+| Debug de erro | X min | Y min | Z% |
+| Boilerplate/scaffolding | X min | Y min | Z% |
+
+**Como medir:** Time tracking em tarefas similares com/sem IA
+
+### 2. Taxa de Aceitação de Código
+
+```
+Taxa = (Código aceito da IA) / (Total gerado pela IA) × 100
+```
+
+- **> 80%**: IA bem calibrada, prompts eficientes
+- **50-80%**: Revisar qualidade dos prompts
+- **< 50%**: Repensar uso ou treinar equipe
+
+### 3. Qualidade do Código Gerado
+
+- **Bugs encontrados** em código gerado por IA vs. escrito manualmente
+- **Cobertura de testes** de código gerado
+- **Complexidade ciclomática** do código gerado
+
+### 4. Velocidade de Entrega
+
+- **Lead time** de features (início → produção)
+- **Cycle time** de tarefas individuais
+- **Throughput** (features entregues por sprint)
+
+---
+
+## Template de Acompanhamento
+
+```markdown
+## Sprint X - Métricas de IA
+
+### Resumo
+- Tarefas com apoio de IA: X/Y
+- Tempo total economizado: ~X horas
+- Taxa de aceitação média: X%
+
+### Por Atividade
+| Atividade | Usos | Taxa Aceitação | Tempo Economizado |
+|---|---|---|---|
+| Geração de testes | X | X% | X min |
+| Debugging | X | X% | X min |
+| Documentação | X | X% | X min |
+
+### Observações
+- O que funcionou bem:
+- O que pode melhorar:
+- Prompts a documentar:
+```
+
+---
+
+## Ferramentas de Medição
+
+- **Time tracking:** Toggl, Clockify, Harvest
+- **Métricas de código:** SonarQube, Code Climate
+- **Métricas de entrega:** Jira, Linear, GitHub Projects
+- **Logs de uso:** Salvar prompts úteis e resultados
+
+---
+
+## Boas Práticas
+
+1. **Meça por um período** antes de tirar conclusões (mínimo 2-4 sprints)
+2. **Compare tarefas similares** para evitar viés
+3. **Inclua tempo de revisão** na conta - código gerado precisa ser revisado
+4. **Documente prompts eficientes** para reuso da equipe
+5. **Itere** - ajuste prompts baseado em métricas

package/dist/content/guides/Rules base.md

@@ -0,0 +1,90 @@
+# Regras do Cursor (Template Padrão Universal)
+
+Arquivo `.cursor-rules` para configuração do ambiente de desenvolvimento
+quando estiver usando um assistente de código/IA como "engenheiro sênior virtual".
+
+## 🎯 Persona
+Engenheiro de Software Sênior/Tech Lead focado em código production-ready:
+limpo, escalável, seguro e testado.
+
+### Comportamento Esperado
+- Pragmático, com foco em soluções robustas.
+- Antecipa edge cases.
+- Comunicação clara e direta.
+
+---
+
+## 💻 Stack Técnica
+
+Este template é **agnóstico de stack**, mas traz exemplos para
+um cenário comum de front-end Web com TypeScript/React.
+
+- **Linguagens/Frameworks**: definidos no Tech Spec do projeto.
+- **Frontend (exemplo)**: React/Next.js com TypeScript.
+- **Backend (exemplo)**: Node/Nest, Java/Spring, .NET, ou outro definido no projeto.
+- **Banco/ORM (exemplo)**: PostgreSQL, Prisma/TypeORM/JPA, etc.
+- **Estilo/UI**: Design System definido (ex.: Tailwind, shadcn/ui, Material UI etc.).
+
+> Adapte estes exemplos para a stack concreta do projeto antes de iniciar.
+
+---
+
+## ✍️ Diretrizes de Código
+
+1. **Clean Code**: legibilidade, SRP, manutenibilidade.
+2. **SOLID**: aplicar onde fizer sentido (sem over-engineering).
+3. **Separação de Responsabilidades** (para Web, como exemplo):
+   - Componentes: UI pura (sem lógica complexa de negócio).
+   - Hooks/Serviços: lógica de estado e de aplicação.
+4. **Padrões gerais**:
+   - Prefira `async/await` a `.then()`
+   - Evite `any` em TypeScript; use tipagem explícita.
+   - Nomenclatura consistente:
+     - Componentes React: `MeuComponente.tsx` (PascalCase)
+     - Hooks: `useMeuHook.ts` (camelCase)
+     - Demais arquivos: `meu-arquivo.ts` (kebab-case) ou convenção local do projeto.
+
+---
+
+## 🧪 Estratégia de Testes
+
+Os nomes abaixo são **exemplos**; troque pelas ferramentas da sua stack.
+
+### 1. Componentes Visuais (Dumb)
+- **O que testar**: variações de estado (default, hover, disabled, error).
+- **Ferramentas típicas**: Storybook ou equivalente para documentação interativa.
+- **Exemplo**: `Button.stories.tsx` (ou similar na sua stack).
+
+### 2. Lógica de Estado / Domínio (Smart)
+- **O que testar**: hooks, serviços, regras de negócio.
+- **Ferramentas típicas**:
+  - JavaScript/TypeScript: Jest/Vitest + Testing Library.
+  - Python: pytest.
+  - Java: JUnit.
+- **Abordagem**: TDD sempre que possível em regras críticas.
+
+### 3. Fluxos de Usuário (E2E)
+- **O que testar**: jornadas completas (Login, Cadastro, Checkout etc.).
+- **Ferramentas típicas**: Playwright, Cypress, Selenium, etc.
+- **Abordagem**: documentar cenários críticos e evitar excesso de flakiness.
+
+---
+
+## 🗂️ Estrutura de Arquivos (exemplo)
+
+Ajuste os caminhos de acordo com o framework real:
+
+- **API**: `[caminho/para/openapi.yaml]`
+- **Banco**: `[caminho/para/schema.prisma ou migrations/]`
+- **UI**: `[src/components/ui/]`
+- **Rotas**: `[src/app/api/ ou equivalente]`
+
+---
+
+## 💬 Comportamento de Resposta da IA
+
+1. **Autonomia**: resolver em uma resposta quando possível, sem depender de múltiplas idas e vindas desnecessárias.
+2. **Clareza**: pedir esclarecimentos em casos ambíguos ao invés de supor demais.
+3. **Justificativa**: explicar decisões arquiteturais importantes com prós e contras.
+4. **Contexto**: sempre considerar o Tech Spec, o Playbook de Desenvolvimento com IA
+   e os especialistas relevantes ao responder.

package/dist/content/playbook/Playbook de Desenvolvimento com IA.md

@@ -0,0 +1,364 @@
+# Playbook de Desenvolvimento com IA
+
+## 🎯 Objetivo
+
+Fornecer um método passo a passo para desenvolver software usando IA (ex.: GPT 5.1) em **todas as etapas** do ciclo de vida, como uma evolução do *vibe coding* tradicional, mas estruturado por **engenharia de software**.
+
+## 👥 Público-alvo
+
+- Devs que já usam IA para "quebrar galho" mas querem **processo**.
+- Times que desejam padronizar como usar IA em:
+  - definição de produto
+  - requisitos
+  - modelagem e arquitetura
+  - implementação (vibe coding estruturado)
+  - testes e qualidade.
+
+## 🔧 Especialistas relacionados
+
+Use este playbook em conjunto com os especialistas:
+
+- [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
+- [Especialista em Engenharia de Requisitos com IA](./Especialista%20em%20Engenharia%20de%20Requisitos%20com%20IA.md)
+- [Especialista em UX Design](./Especialista%20em%20UX%20Design.md)
+- [Especialista em Modelagem e Arquitetura de Domínio com IA](./Especialista%20em%20Modelagem%20e%20Arquitetura%20de%20Domínio%20com%20IA.md)
+- [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
+- [Especialista em Segurança da Informação](./Especialista%20em%20Segurança%20da%20Informação.md)
+- [Especialista em Análise de Testes](./Especialista%20em%20Análise%20de%20Testes.md)
+- [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
+- [Especialista em Desenvolvimento e Vibe Coding Estruturado](./Especialista%20em%20Desenvolvimento%20e%20Vibe%20Coding%20Estruturado.md)
+
+---
+
+## 🔄 Visão geral do método (8 etapas)
+
+1. **Visão & problema**  
+   Entender o que estamos construindo, para quem e por quê.
+
+2. **Engenharia de requisitos com IA**  
+   Transformar visão em requisitos claros, completos e testáveis.
+
+3. **Modelagem & arquitetura com IA**  
+   Casos de uso, modelo de domínio, visão arquitetural inicial.
+
+4. **Planejamento / backlog**  
+   Fatiar o produto em épicos e histórias de usuário.
+
+5. **Vibe Coding Estruturado (implementação)**  
+   Implementar história a história com IA, em ciclos curtos.
+
+6. **Testes com IA**  
+   Planejar e gerar testes (unitários, integração, E2E) com apoio da IA.
+
+7. **Documentação & revisão**  
+   Usar IA para revisar código, gerar documentação e melhorar design.
+
+8. **Feedback & evolução**  
+   Analisar uso real, bugs e métricas para ajustar o produto.
+
+---
+
+## 1. Visão & problema
+
+- **Especialista principal**: 
+  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
+- **Objetivo**: sair de ideia vaga para um recorte de produto com objetivo, público, dores e métricas.
+
+### Artefatos
+- Visão do produto
+- Personas
+- Principais dores e oportunidades
+
+### Prompts de exemplo
+
+```text
+Atue como um PM sênior. Quero descrever um produto que tenho em mente.
+
+Contexto bruto:
+[COLE SUAS ANOTAÇÕES]
+
+Organize em:
+- visão do produto
+- problema principal que resolve
+- público-alvo e 2–3 personas
+- principais riscos e hipóteses a validar
+```
+
+```text
+Com base na visão abaixo:
+[COLE VISÃO]
+
+Sugira 3 opções de recorte de MVP, com prós e contras de cada.
+```
+
+---
+
+## 2. Engenharia de requisitos com IA
+
+- **Especialista principal**: 
+  - [Especialista em Engenharia de Requisitos com IA](./Especialista%20em%20Engenharia%20de%20Requisitos%20com%20IA.md)
+- **Objetivo**: gerar requisitos funcionais e não funcionais claros, completos e testáveis.
+
+### Artefatos
+- Lista de requisitos funcionais
+- Lista de requisitos não funcionais
+- Critérios de aceitação (idealmente em Gherkin)
+
+### Prompts de exemplo
+
+```text
+Vou colar abaixo anotações soltas de reuniões com o cliente.
+
+Notas:
+[COLE TEXTO]
+
+Atue como analista de requisitos.
+Organize em:
+- visão resumida
+- requisitos funcionais ("O sistema deve ...")
+- requisitos não funcionais
+- dúvidas que precisam ser respondidas com o cliente
+```
+
+```text
+Aqui estão alguns requisitos ainda vagos:
+[COLE REQUISITOS]
+
+Refine cada um para ficar:
+- claro e específico
+- mensurável/testável
+Inclua critérios de aceitação em Gherkin.
+```
+
+---
+
+## 3. Modelagem & arquitetura com IA
+
+- **Especialistas principais**:
+  - [Especialista em Modelagem e Arquitetura de Domínio com IA](./Especialista%20em%20Modelagem%20e%20Arquitetura%20de%20Domínio%20com%20IA.md)
+  - [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
+- **Objetivo**: derivar casos de uso, entidades, relacionamentos e uma arquitetura inicial adequada ao contexto.
+
+### Artefatos
+- Casos de uso
+- Modelo de domínio (entidades, relacionamentos)
+- Diagrama/descrição C4 (Contexto, Containers, Componentes)
+
+### Prompts de exemplo
+
+```text
+Com base nesses requisitos:
+[COLE REQUISITOS]
+
+Liste:
+- atores
+- casos de uso principais
+- passos de alto nível de cada caso de uso
+```
+
+```text
+Usando os requisitos e casos de uso abaixo:
+[COLE]
+
+Proponha um modelo de domínio inicial:
+- entidades
+- principais atributos (com tipos aproximados)
+- relacionamentos (1-1, 1-N, N-N)
+- dúvidas abertas.
+```
+
+```text
+Quero implementar esse sistema com a stack:
+[DESCREVA STACK]
+
+Proponha uma arquitetura em estilo C4 (níveis 1–3)
+com justificativa das principais decisões.
+```
+
+---
+
+## 4. Planejamento / backlog
+
+- **Especialistas principais**:
+  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
+  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
+- **Objetivo**: transformar requisitos em épicos e histórias de usuário, com prioridades.
+
+### Artefatos
+- Backlog de épicos
+- Histórias de usuário
+- Critérios de aceite por história
+
+### Prompts de exemplo
+
+```text
+Com base nesses requisitos e modelo de domínio:
+[COLE]
+
+Gere um backlog inicial com:
+- épicos
+- histórias de usuário em formato:
+  Como [persona], quero [ação] para [benefício].
+- critérios de aceitação para cada história.
+Ordene por prioridade para um MVP.
+```
+
+```text
+Aqui está um conjunto de histórias de usuário:
+[COLE HISTÓRIAS]
+
+Verifique:
+- histórias grandes demais que podem ser fatiadas
+- dependências importantes
+- riscos técnicos.
+Sugira uma ordem de implementação.
+```
+
+---
+
+## 5. Vibe Coding Estruturado (implementação)
+
+- **Especialista principal**:
+  - [Especialista em Desenvolvimento e Vibe Coding Estruturado](./Especialista%20em%20Desenvolvimento%20e%20Vibe%20Coding%20Estruturado.md)
+- **Objetivo**: implementar funcionalidade por funcionalidade, em ciclos curtos, usando IA como pair programmer com foco em qualidade.
+
+### Artefatos
+- Código da funcionalidade
+- Casos de uso / endpoints
+- Testes automatizados (ao menos unitários)
+
+### Prompts de exemplo
+
+```text
+História de usuário:
+[COLE HISTÓRIA]
+
+Stack: [DESCREVA LINGUAGEM/FRAMEWORK].
+
+Detalhe, em alto nível:
+- endpoints ou casos de uso necessários
+- payloads de entrada/saída
+- validações obrigatórias
+- erros comuns e como tratar.
+```
+
+```text
+Agora gere APENAS o serviço/classe de domínio responsável por implementar
+essa regra de negócio, assumindo que já existe a entidade X com os campos:
+[DESCREVA].
+
+Inclua:
+- assinatura do método
+- lógica principal
+- tratamento básico de erros.
+Não gere controller/rota ainda.
+```
+
+---
+
+## 6. Testes com IA
+
+- **Especialista principal**:
+  - [Especialista em Análise de Testes](./Especialista%20em%20Análise%20de%20Testes.md)
+- **Objetivo**: usar IA para planejar e gerar testes (unitários, integração, E2E) sem abrir mão de senso crítico humano.
+
+### Artefatos
+- Plano de testes
+- Testes automatizados
+- Métricas de cobertura e qualidade
+
+### Prompts de exemplo
+
+```text
+Aqui está a descrição da funcionalidade e seus requisitos:
+[COLE]
+
+Gere um plano de testes resumido com:
+- tipos de teste sugeridos (unitário, integração, E2E)
+- principais cenários de teste
+- casos de borda.
+```
+
+```text
+Aqui está a função/classe que implementei em [LINGUAGEM]:
+[COLE CÓDIGO]
+
+Gere testes unitários em [FRAMEWORK DE TESTE], cobrindo:
+- caso de sucesso
+- entradas inválidas
+- casos de borda.
+Explique rapidamente o raciocínio de cada teste.
+```
+
+---
+
+## 7. Documentação & revisão
+
+- **Especialistas principais**:
+  - [Especialista em Arquitetura de Software](./Especialista%20em%20Arquitetura%20de%20Software.md)
+  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
+- **Objetivo**: garantir que o conhecimento não fique só no código e que decisões importantes estejam registradas.
+
+### Artefatos
+- Documentação técnica
+- ADRs (Architecture Decision Records) resumidos
+- Comentários de PR
+
+### Prompts de exemplo
+
+```text
+Aqui está um módulo/classe completo que escrevi:
+[COLE]
+
+Gere uma documentação técnica resumida com:
+- o que esse módulo faz
+- principais responsabilidades
+- dependências externas
+- exemplos de uso (se fizer sentido).
+```
+
+```text
+Com base nos pontos de dúvida/discussão abaixo:
+[COLE NOTAS]
+
+Gere um ADR resumido (1 página) com:
+- contexto
+- decisão
+- alternativas consideradas
+- trade-offs principais.
+```
+
+---
+
+## 8. Feedback & evolução
+
+- **Especialistas principais**:
+  - [Especialista em Gestão de Produto](./Especialista%20em%20Gestão%20de%20Produto%20.md)
+  - [Especialista em Plano de Execução com IA](./Especialista%20em%20Plano%20de%20Execução%20com%20IA.md)
+- **Objetivo**: fechar o ciclo, aprendendo com uso real, métricas e bugs.
+
+### Artefatos
+- Registro de feedbacks de usuários
+- Lista de melhorias
+- Próximas iterações planejadas
+
+### Prompts de exemplo
+
+```text
+Aqui estão feedbacks e bugs coletados:
+[COLE TEXTO/ISSUES]
+
+Agrupe em:
+- problemas de usabilidade
+- bugs
+- pedidos de melhoria.
+Sugira ajustes no backlog (novas histórias ou mudanças em histórias existentes).
+```
+
+```text
+Com base nas métricas do produto abaixo:
+[COLE MÉTRICAS]
+
+Sugira hipóteses para explicar os números
+ e 3 experimentos que poderíamos rodar na próxima sprint.
+```