@maestro-ai/cli 1.0.0

package/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/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/content/prompts/README.md

@@ -0,0 +1,203 @@
+# Biblioteca de Prompts
+
+Templates de prompts prontos para uso organizados por área.
+
+---
+
+## Como Usar
+
+1. Copie o prompt da área desejada
+2. Substitua os placeholders `[...]` com seu contexto
+3. Cole na sua IA preferida (Claude, GPT, Gemini)
+4. Valide usando o checklist no final de cada prompt
+
+> **Dica**: Sempre inclua o conteúdo de `docs/CONTEXTO.md` para melhor resultado.
+
+---
+
+## Como Escolher o Prompt Certo
+
+```mermaid
+flowchart TD
+    START[Início] --> Q1{Qual fase do projeto?}
+    
+    Q1 --> |Ideia inicial| DISC[discovery-inicial.md]
+    Q1 --> |Definindo escopo| REQ[refinar-requisitos.md]
+    Q1 --> |Modelando dados| MODEL[modelo-dominio.md]
+    Q1 --> |Prototipando UI| STITCH[gerar-ui-stitch.md]
+    
+    Q1 --> |Arquitetura| Q2{Complexidade?}
+    Q2 --> |Simples/Médio| CLEAN[clean-architecture.md]
+    Q2 --> |Médio| C4[arquitetura-c4-completo.md]
+    Q2 --> |Complexo| DDD[ddd-cqrs.md ou ddd-bounded-contexts.md]
+    
+    Q1 --> |Implementando| Q3{O que precisa?}
+    Q3 --> |API Design| API[design-api-rest.md]
+    Q3 --> |Serviço| SERV[gerar-servico.md]
+    Q3 --> |Testes| TEST[gerar-testes-unitarios.md]
+    Q3 --> |Review| REVIEW[code-review.md]
+    
+    Q1 --> |Preparando produção| Q4{Área?}
+    Q4 --> |Performance| PERF[analise-performance.md]
+    Q4 --> |Observabilidade| OBS[estrategia-observabilidade.md]
+    Q4 --> |Segurança| SEC[analise-seguranca.md]
+    Q4 --> |CI/CD| CICD[pipeline-cicd.md]
+    Q4 --> |Banco de dados| DB[otimizacao-queries.md]
+    Q4 --> |Acessibilidade| A11Y[analise-acessibilidade.md]
+```
+
+---
+
+## Índice de Prompts
+
+### 📋 Produto & Requisitos
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [discovery-inicial.md](./produto/discovery-inicial.md) | Início de projeto, ideia vaga | Simples |
+| [refinar-requisitos.md](./requisitos/refinar-requisitos.md) | Após discovery, formalizar requisitos | Simples |
+
+---
+
+### 🎨 UX & Prototipagem
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [gerar-ui-stitch.md](./ux/gerar-ui-stitch.md) | Prototipar UI com Google Stitch | Simples |
+
+---
+
+### 🏗️ Arquitetura & Modelagem
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [modelo-dominio.md](./arquitetura/modelo-dominio.md) | Modelar entidades e relacionamentos | Simples |
+| [arquitetura-c4-completo.md](./arquitetura/arquitetura-c4-completo.md) | Definir arquitetura com diagramas C4 | Médio |
+| [clean-architecture.md](./arquitetura/clean-architecture.md) | Arquitetura limpa para projetos médios | Médio |
+| [ddd-bounded-contexts.md](./arquitetura/ddd-bounded-contexts.md) | Definir contextos em DDD | Complexo |
+| [ddd-cqrs.md](./arquitetura/ddd-cqrs.md) | DDD + CQRS para sistemas complexos | Complexo |
+| [multi-tenancy.md](./arquitetura/multi-tenancy.md) | Arquitetura multi-tenant para SaaS | Complexo |
+
+---
+
+### 🔌 APIs
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [design-api-rest.md](./apis/design-api-rest.md) | Projetar API REST com OpenAPI | Médio |
+| [idempotencia.md](./apis/idempotencia.md) | Implementar idempotência em endpoints | Médio |
+| [versionamento.md](./apis/versionamento.md) | Estratégias de versionamento de API | Médio |
+
+---
+
+### 💻 Desenvolvimento
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [gerar-servico.md](./desenvolvimento/gerar-servico.md) | Gerar código de serviços/use cases | Médio |
+| [code-review.md](./desenvolvimento/code-review.md) | Revisar código de PRs | Médio |
+
+---
+
+### 🧪 Testes
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [gerar-testes-unitarios.md](./testes/gerar-testes-unitarios.md) | Criar testes unitários | Simples |
+| [testes-integracao.md](./testes/testes-integracao.md) | Testes de integração com banco/APIs | Médio |
+| [testes-e2e.md](./testes/testes-e2e.md) | Testes end-to-end com Playwright | Médio |
+| [testes-performance.md](./testes/testes-performance.md) | Load testing com k6 | Médio |
+| [contract-testing.md](./testes/contract-testing.md) | Contract testing com Pact | Médio |
+
+---
+
+### 🚀 Performance & Escalabilidade
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [analise-performance.md](./escalabilidade/analise-performance.md) | Identificar e corrigir gargalos | Médio |
+| [caching.md](./escalabilidade/caching.md) | Estratégias de cache com Redis | Médio |
+
+---
+
+### 🗄️ Database
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [otimizacao-queries.md](./database/otimizacao-queries.md) | Otimizar banco de dados e queries | Médio |
+| [migrations-zero-downtime.md](./database/migrations-zero-downtime.md) | Migrations sem downtime | Médio |
+
+---
+
+### 📊 Observabilidade
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [estrategia-observabilidade.md](./observabilidade/estrategia-observabilidade.md) | Configurar logs, métricas, traces | Médio |
+| [slos.md](./observabilidade/slos.md) | Definir SLOs, SLIs e Error Budgets | Médio |
+| [chaos-testing.md](./observabilidade/chaos-testing.md) | Experimentos de chaos engineering | Complexo |
+
+---
+
+### 🔐 Segurança
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [analise-seguranca.md](./seguranca/analise-seguranca.md) | Análise OWASP Top 10 | Médio |
+| [threat-modeling.md](./seguranca/threat-modeling.md) | Modelagem de ameaças STRIDE | Médio |
+| [revisao-lgpd.md](./seguranca/revisao-lgpd.md) | Conformidade LGPD/GDPR | Médio |
+| [pentest-checklist.md](./seguranca/pentest-checklist.md) | Checklist de pentest para devs | Médio |
+| [rate-limiting.md](./seguranca/rate-limiting.md) | Rate limiting e throttling | Médio |
+
+---
+
+### ⚙️ DevOps
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [pipeline-cicd.md](./devops/pipeline-cicd.md) | Configurar CI/CD com GitHub Actions | Médio |
+| [docker-compose.md](./devops/docker-compose.md) | Docker Compose multi-ambiente | Médio |
+| [kubernetes-deploy.md](./devops/kubernetes-deploy.md) | Deploy Kubernetes com manifests | Complexo |
+| [terraform-iac.md](./devops/terraform-iac.md) | Infrastructure as Code com Terraform | Complexo |
+| [feature-flags.md](./devops/feature-flags.md) | Feature flags e rollout gradual | Médio |
+
+---
+
+### ♿ Acessibilidade
+
+| Prompt | Quando Usar | Nível |
+|--------|-------------|-------|
+| [analise-acessibilidade.md](./acessibilidade/analise-acessibilidade.md) | Verificar WCAG 2.1, screen readers | Médio |
+
+---
+
+## Estrutura dos Prompts
+
+Todos os prompts seguem a mesma estrutura:
+
+```markdown
+# Prompt: [Nome]
+
+> **Quando usar**: [Contexto]
+> **Especialista**: [Link para especialista]
+> **Nível**: [Simples/Médio/Complexo]
+
+---
+
+## Fluxo de Contexto
+[Documentos de entrada e saída]
+
+## Prompt Completo
+[Prompt para copiar]
+
+## Exemplo de Uso
+[Exemplo preenchido]
+
+## Resposta Esperada
+[Exemplo de saída]
+
+## Checklist Pós-Geração
+[Validações do resultado]
+```
+
+

package/content/prompts/acessibilidade/analise-acessibilidade.md

@@ -0,0 +1,257 @@
+# Prompt: Análise de Acessibilidade
+
+> **Quando usar**: Durante desenvolvimento de UI ou antes de ir para produção
+> **Especialista**: UX/UI Design
+> **Nível**: Médio
+
+---
+
+## Fluxo de Contexto
+
+Antes de usar este prompt, tenha em mãos:
+- URL do site/app ou código HTML/React
+- Tipo de aplicação (web, mobile, desktop)
+
+Após gerar, salve o resultado em:
+- `docs/11-acessibilidade/analise-acessibilidade.md`
+
+---
+
+## Prompt Completo
+
+```text
+Atue como especialista em acessibilidade digital (WCAG).
+
+## Contexto
+
+Tipo de aplicação: [Web app / Mobile app / Site institucional]
+Framework: [React/Vue/Angular/HTML puro]
+Público-alvo: [Descreva o público, incluindo se há foco em usuários com deficiência]
+
+## Código/URL a Analisar
+
+```html
+[COLE O CÓDIGO HTML OU COMPONENTE REACT/VUE]
+```
+
+Ou: [URL do site para análise]
+
+---
+
+## Sua Missão
+
+Realize uma análise de acessibilidade baseada em WCAG 2.1:
+
+### 1. Análise por Princípio WCAG
+
+#### 1.1 Perceivable (Perceptível)
+- Textos alternativos para imagens
+- Legendas para vídeos e áudios
+- Contraste de cores (mínimo 4.5:1)
+- Redimensionamento de texto (até 200%)
+- Conteúdo sem depender apenas de cor
+
+#### 1.2 Operable (Operável)
+- Navegação por teclado
+- Tempo suficiente para leitura
+- Sem elementos que causem convulsões (flashing)
+- Skip links para conteúdo principal
+- Títulos e labels claros
+
+#### 1.3 Understandable (Compreensível)
+- Texto legível e compreensível
+- Comportamento previsível
+- Ajuda na correção de erros
+- Labels em formulários
+
+#### 1.4 Robust (Robusto)
+- Compatibilidade com tecnologias assistivas
+- HTML semântico
+- ARIA roles quando necessário
+
+### 2. Checklist de Problemas
+
+Para cada problema encontrado:
+
+| Critério WCAG | Severidade | Elemento | Problema | Solução |
+|---------------|------------|----------|----------|---------|
+| [Ex: 1.1.1] | [A/AA/AAA] | [Elemento] | [Descrição] | [Como corrigir] |
+
+### 3. Navegação por Teclado
+
+- Tab order está lógico?
+- Focus visible em todos os elementos?
+- Todos os controles são acessíveis?
+- Modais capturam foco corretamente?
+- Atalhos de teclado documentados?
+
+### 4. Screen Reader
+
+- Headings hierárquicos (h1 > h2 > h3)?
+- Landmarks definidos (main, nav, aside)?
+- Live regions para conteúdo dinâmico?
+- Formulários com labels associados?
+- Tabelas com headers definidos?
+
+### 5. Contraste e Cores
+
+- Texto normal: 4.5:1 mínimo
+- Texto grande: 3:1 mínimo
+- Componentes UI: 3:1 mínimo
+- Não depende apenas de cor
+
+### 6. Formulários
+
+- Todos os inputs têm labels
+- Erros claramente identificados
+- Instruções antes do campo
+- Campos obrigatórios indicados
+- Mensagens de erro associadas ao campo
+
+### 7. Código Corrigido
+
+Forneça exemplos de código corrigido para os principais problemas:
+
+**Antes:**
+```html
+[Código com problema]
+```
+
+**Depois:**
+```html
+[Código corrigido com comentários]
+```
+
+### 8. Ferramentas de Teste
+
+Recomende ferramentas para testar:
+- Automatizadas (axe, WAVE, Lighthouse)
+- Manuais (VoiceOver, NVDA, JAWS)
+- Simuladores de daltonismo
+```
+
+---
+
+## Exemplo de Uso
+
+```text
+Atue como especialista em acessibilidade digital (WCAG).
+
+## Contexto
+
+Tipo de aplicação: Web app
+Framework: React + Next.js
+Público-alvo: Clientes de salão de beleza, incluindo idosos
+
+## Código a Analisar
+
+```jsx
+function AgendamentoForm() {
+  return (
+    <div>
+      <div style={{color: '#999', background: '#fff'}}>
+        <img src="/calendar.png" />
+        <input type="text" placeholder="Seu nome" />
+        <input type="tel" placeholder="Telefone" />
+        <select>
+          <option>Selecione um serviço</option>
+          <option>Corte</option>
+          <option>Manicure</option>
+        </select>
+        <div onClick={() => submit()} style={{background: 'red', color: 'white'}}>
+          Agendar
+        </div>
+      </div>
+    </div>
+  );
+}
+```
+```
+
+---
+
+## Resposta Esperada
+
+### Problemas Identificados
+
+| Critério | Severidade | Elemento | Problema | Solução |
+|----------|------------|----------|----------|---------|
+| 1.1.1 | A | img | Sem alt text | Adicionar alt="Ícone de calendário" |
+| 1.4.3 | AA | texto | Contraste #999 no branco = 2.8:1 | Usar #666 ou mais escuro |
+| 2.1.1 | A | div botão | Não acessível por teclado | Trocar por `<button>` |
+| 1.3.1 | A | form | Inputs sem labels | Adicionar `<label>` |
+| 4.1.2 | A | select | Sem identificação | Adicionar label/aria-label |
+
+### Código Corrigido
+
+```jsx
+function AgendamentoForm() {
+  return (
+    <form 
+      role="form" 
+      aria-labelledby="form-title"
+      onSubmit={handleSubmit}
+    >
+      <h2 id="form-title">Agendar horário</h2>
+      
+      {/* Imagem com alt text descritivo */}
+      <img src="/calendar.png" alt="Ícone de calendário" />
+      
+      {/* Inputs com labels associados */}
+      <div>
+        <label htmlFor="nome">Seu nome</label>
+        <input 
+          type="text" 
+          id="nome"
+          name="nome"
+          required
+          aria-required="true"
+        />
+      </div>
+      
+      <div>
+        <label htmlFor="telefone">Telefone</label>
+        <input 
+          type="tel" 
+          id="telefone"
+          name="telefone"
+          required
+          aria-required="true"
+        />
+      </div>
+      
+      <div>
+        <label htmlFor="servico">Serviço</label>
+        <select id="servico" name="servico" required>
+          <option value="">Selecione um serviço</option>
+          <option value="corte">Corte</option>
+          <option value="manicure">Manicure</option>
+        </select>
+      </div>
+      
+      {/* Botão real em vez de div clicável */}
+      <button 
+        type="submit"
+        style={{background: '#c00', color: 'white'}}
+      >
+        Agendar
+      </button>
+    </form>
+  );
+}
+```
+
+---
+
+## Checklist Pós-Geração
+
+- [ ] Todas as imagens têm alt text
+- [ ] Contraste mínimo 4.5:1 verificado
+- [ ] Navegação por teclado funciona
+- [ ] Todos os inputs têm labels
+- [ ] Headings hierárquicos
+- [ ] Landmarks semânticos definidos
+- [ ] Botões usam elemento correto
+- [ ] Focus visible em todos os elementos
+- [ ] Testado com screen reader
+- [ ] Salvar em `docs/11-acessibilidade/analise-acessibilidade.md`