adi_dev_workflow 1.1.0 → 1.1.1

package/frameworks/skills/prompt-engineer-expert/templates/prompt_template.md

@@ -0,0 +1,139 @@
+# Prompt 5 Estrelas
+
+---
+
+## 1. Contexto
+
+**Linguagem/Framework:**
+[linguagem e versão, frameworks principais]
+
+**Arquitetura/Padrão:**
+[padrão arquitetural do projeto]
+
+**Público-alvo:**
+[quem vai consumir o resultado]
+
+**Limitações/Restrições:**
+[restrições de ambiente, dependências, compatibilidade]
+
+---
+
+## 2. Objetivo
+
+**O que precisa ser entregue:**
+[entregável principal da tarefa]
+
+**Propósito da tarefa:**
+[problema que resolve ou valor que agrega]
+
+**Resultado esperado:**
+[forma do resultado: código funcional, documentação, plano, etc.]
+
+---
+
+## 3. Instruções Específicas
+
+**Detalhes técnicos:**
+- [detalhe 1]
+- [detalhe 2]
+- [detalhe 3]
+
+**Restrições:**
+- [restrição 1]
+- [restrição 2]
+
+**Estrutura lógica:**
+- [passo ou camada 1]
+- [passo ou camada 2]
+- [passo ou camada 3]
+
+---
+
+## 4. Regras: DEVE / NÃO DEVE
+
+### DEVE:
+- [regra obrigatória 1]
+- [regra obrigatória 2]
+- [regra obrigatória 3]
+
+### NÃO DEVE:
+- [proibição 1]
+- [proibição 2]
+- [proibição 3]
+
+### ATENÇÃO ESPECIAL:
+- [ponto crítico, se houver]
+
+---
+
+## 5. Formato da Resposta
+
+**Estrutura desejada:**
+[formato do output: código com comentários, tópicos, tabela, etc.]
+
+**Limites:**
+[restrições de tamanho ou escopo do output]
+
+**Estilo:**
+[idioma, formatação, nível de detalhe]
+
+---
+
+## 6. Persona / Tom
+
+**Perspectiva:**
+[papel que a IA deve assumir]
+
+**Tom da explicação:**
+[técnico, didático, consultivo, direto]
+
+**Nível de profundidade:**
+[básico, intermediário, aprofundado com edge cases]
+
+---
+
+## 7. Critérios de Aceite *(opcional)*
+
+- [ ] [critério 1]
+- [ ] [critério 2]
+- [ ] [critério 3]
+
+---
+
+## 8. Exemplos *(opcional)*
+
+**Exemplo 1:**
+```
+Entrada: [entrada]
+Saída esperada: [saída]
+```
+
+---
+
+## 9. Arquivos Envolvidos *(opcional)*
+
+**Arquivos a criar:**
+- [caminho — descrição]
+
+**Arquivos a modificar:**
+- [caminho — descrição]
+
+**Arquivos de referência (não alterar):**
+- [caminho — descrição]
+
+---
+
+## 10. Testes de Unidade *(opcional)*
+
+**Escopo dos testes:**
+- [camadas e tipos de teste]
+
+**Cenários obrigatórios:**
+- [cenário 1: descrição → resultado esperado]
+- [cenário 2: descrição → resultado esperado]
+
+**Padrão de testes:**
+- [framework, convenções, nomenclatura]
+
+**Arquivo de referência:**
+- [caminho do teste existente a seguir como modelo]

package/frameworks/skills/sdd-prd-expert/SKILL.md

@@ -25,6 +25,18 @@ Estilo: Objetivo. Estruturado. Sem redundância.
 
 ---
 
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
+
+---
+
 # Framework SDD — Etapa PRD
 
 ## Visão Geral

package/frameworks/skills/sdd-task-plan-expert/SKILL.md

@@ -16,6 +16,18 @@ Seu foco é **EXCLUSIVAMENTE** no **COMO executar** — decomposição técnica
 
 ---
 
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
+
+---
+
 # Framework SDD — Etapa TASK PLAN
 
 ## Visão Geral

package/frameworks/skills/sdd-tech-direction-expert/SKILL.md

@@ -16,7 +16,19 @@ Domina o framework SDD: template, regras, guardrails, convencoes e fluxos.
 
 Foco: **DECISOES TECNICAS** que guiarao o SPEC_TECH. Nao e SPEC_TECH — e o direcionamento previo.
 
-Estilo: Objetivo. Contextualizado. Perguntas curtas com opcoes baseadas no codebase.
+Estilo: Objetivo. Contextualizado. Perguntas curtas com opções baseadas no codebase.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
 
 ---
 

package/frameworks/skills/sdd-tech-spec-expert/SKILL.md

@@ -5,6 +5,19 @@ argument-hint: [caminho do PRD]
 ---
 PERSONA: Você é um Arquiteto de Software Sênior.
 Responsabilidade: Transformar PRDs aprovados em especificações técnicas completas, claras e prontas para implementação.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
+
 ---
 
 # Framework SDD - SPEC_TECH

package/frameworks/skills/taskcard-expert/SKILL.md

@@ -6,7 +6,19 @@ argument-hint: [pergunta, contexto ou caminho da taskcard]
 
 Voce e um **Especialista no Framework TaskCard** — o sistema de planejamento e execucao de tasks deste projeto.
 
-Voce domina completamente o framework: template, regras, guardrails, convencoes de nomenclatura, estrutura de diretorios e fluxos de geracao/execucao.
+Você domina completamente o framework: template, regras, guardrails, convenções de nomenclatura, estrutura de diretórios e fluxos de geração/execução.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
 
 ---
 
@@ -60,15 +72,18 @@ Se `project-profile.md` NAO existir, execute `/generate-project-profile` antes d
 
 ---
 
-## Secao 10 (Testes): Delegacao ao qa-staff-engineer
+## Seção 10 (Testes): Delegação ao qa-staff-engineer
+
+A seção 10 (Testes) NÃO é preenchida diretamente pelo gerador da TaskCard. O fluxo é:
+
+1. O orquestrador (`generate-taskcard`) dispara o agente `qa-staff-engineer` (modo GERAR_TESTES)
+2. O agente retorna um **JSON estruturado** com casos de teste, rastreabilidade e padrões detectados
+3. O orquestrador **transforma o JSON** no formato do template oficial (subseções 10.1 a 10.6) e edita o arquivo
 
-A secao 10 (Testes) NAO e preenchida pelo gerador da TaskCard. Ela e delegada ao agente `qa-staff-engineer` (modo GERAR_TESTES) que:
-- Analisa o codebase, testes existentes e padroes do projeto
-- Mapeia criterios de aceite (secao 9) para testes
-- Preenche as subsecoes 10.1 a 10.6 diretamente no arquivo da TaskCard
+O agente QA é compartilhado entre processos (SDD, miniStack, TaskCard) e sempre retorna JSON — a adaptação ao formato do template é responsabilidade do orquestrador.
 
-> **Nunca gere uma TaskCard sem disparar o qa-staff-engineer para preencher a secao 10.**
-> Salve o arquivo com secoes 1-9 e 11 primeiro, depois delegue a secao 10 ao agente.
+> **Nunca gere uma TaskCard sem disparar o qa-staff-engineer para a seção 10.**
+> Salve o arquivo com seções 1-9 e 11 primeiro, depois dispare o agente e formate o resultado.
 
 ---
 
@@ -178,9 +193,9 @@ Contexto do usuario
   -> Preencher template (secoes 1-9 e 11)
   -> Remover todos os comentarios <!-- LLM-ONLY: ... --> do conteudo antes de salvar
   -> Salvar em docs/<feature>/vN/ (GERAR ARQUIVOS IMEDIATAMENTE, SEM PEDIR APROVACAO)
-  -> Delegar secao 10 (Testes) ao agente qa-staff-engineer (modo GERAR_TESTES)
-     O agente analisa o codebase, testes existentes e criterios de aceite (secao 9)
-     e preenche as subsecoes 10.1 a 10.6 diretamente no arquivo da TaskCard
+  -> Disparar qa-staff-engineer (modo GERAR_TESTES) → recebe JSON
+  -> Transformar JSON no formato do template (subseções 10.1 a 10.6)
+  -> Editar arquivo da TaskCard com a seção 10 formatada
   -> Se multiplas: gerar task-plan.md
   -> Apresentar resumo curto do que foi criado (arquivos gerados, IDs, nomes)
 ```

package/frameworks/templates/prompt_template.md

@@ -0,0 +1,207 @@
+# 🎯 Prompt Template 5 Estrelas
+
+> **Como usar:** Preencha cada seção abaixo com as informações específicas da sua tarefa. Delete as dicas entre colchetes após preencher.
+
+> 💡 **Novo!** Seção **DEVE/NÃO DEVE** adicionada para estabelecer limites claros e evitar comportamentos indesejados da IA.
+
+---
+
+## 1. 🌍 Contexto
+
+[Descreva o ambiente técnico, stack, público e restrições relevantes]
+
+**Linguagem/Framework:**
+[Ex: Python 3.11 com FastAPI / Go com Gin / React com TypeScript]
+
+**Arquitetura/Padrão:**
+[Ex: Clean Architecture / Arquitetura em camadas / MVC / Microserviços]
+
+**Público-alvo:**
+[Ex: Desenvolvedores backend / Equipe de frontend / Arquitetos de software]
+
+**Limitações/Restrições:**
+[Ex: Não pode usar bibliotecas externas / Deve ser compatível com PostgreSQL 14 / Budget limitado de memória]
+
+---
+
+## 2. 🎯 Objetivo
+
+[Descreva claramente o que você deseja obter da IA]
+
+**O que precisa ser entregue:**
+[Ex: Implementar feature de autenticação JWT / Criar testes unitários / Refatorar código legado]
+
+**Propósito da tarefa:**
+[Ex: Melhorar segurança / Aumentar cobertura de testes / Facilitar manutenção]
+
+**Resultado esperado:**
+[Ex: Código funcional / Documentação técnica / Plano de implementação]
+
+---
+
+## 3. ⚙️ Instruções Específicas
+
+[Defina COMO a IA deve construir a resposta]
+
+**Detalhes técnicos:**
+- [Ex: Usar pgx/v5 para conexão com banco]
+- [Ex: Implementar validação de entrada com tags do Gin]
+- [Ex: Seguir padrão de nomenclatura do projeto]
+
+**Restrições:**
+- [Ex: NÃO usar bibliotecas ORM]
+- [Ex: NÃO modificar arquivos de configuração existentes]
+- [Ex: Manter compatibilidade com API v1]
+
+**Estrutura lógica:**
+- [Ex: Separar camadas: handler → service → repository]
+- [Ex: Implementar tratamento de erros em cada camada]
+- [Ex: Adicionar logs estruturados]
+
+---
+
+## 4. ✓ Regras: DEVE / NÃO DEVE
+
+[Defina limites claros do que a IA DEVE e NÃO DEVE fazer]
+
+### ✅ DEVE:
+- [Ex: DEVE usar Context para operações de I/O]
+- [Ex: DEVE seguir o padrão de nomenclatura do projeto (PascalCase/camelCase)]
+- [Ex: DEVE implementar tratamento de erros com contexto usando fmt.Errorf]
+- [Ex: DEVE adicionar comentários explicativos em lógicas complexas]
+- [Ex: DEVE validar todos os inputs antes de processar]
+- [Ex: DEVE retornar erros apropriados em cada camada]
+- [Ex: DEVE escrever testes para código crítico]
+- [Ex: DEVE formatar código com gofmt/prettier]
+
+### ❌ NÃO DEVE:
+- [Ex: NÃO DEVE usar bibliotecas ORM (usar apenas SQL puro)]
+- [Ex: NÃO DEVE expor informações sensíveis em logs]
+- [Ex: NÃO DEVE fazer breaking changes na API pública]
+- [Ex: NÃO DEVE ignorar erros silenciosamente]
+- [Ex: NÃO DEVE criar código duplicado (DRY - Don't Repeat Yourself)]
+- [Ex: NÃO DEVE usar hardcoded values (usar variáveis de ambiente)]
+- [Ex: NÃO DEVE modificar arquivos de migração já aplicados]
+- [Ex: NÃO DEVE pular validações de segurança]
+
+### ⚠️ ATENÇÃO ESPECIAL:
+- [Ex: Ao manipular senhas, SEMPRE usar hashing (bcrypt)]
+- [Ex: Ao fazer queries SQL, SEMPRE usar prepared statements]
+- [Ex: Ao lidar com datas, SEMPRE usar UTC]
+
+---
+
+## 5. 📋 Formato da Resposta
+[Ex: Se a resposta for longa, use subtítulos (##) e listas numeradas para facilitar leitura.]
+
+[Especifique COMO você quer receber o resultado]
+
+**Estrutura desejada:**
+[Ex: Código completo com comentários / Plano em tópicos / Tabela comparativa / Diagrama + explicação]
+
+**Limites:**
+[Ex: Máximo 200 linhas de código / Resposta em até 3 parágrafos / Sem dependências externas]
+
+**Estilo:**
+[Ex: Responder em português / Usar markdown / Incluir exemplos de uso / Formato técnico e direto]
+
+---
+
+## 6. 👤 Persona / Tom
+
+[Defina a perspectiva e forma de comunicação da IA]
+
+**Perspectiva:**
+[Ex: Desenvolvedor sênior / Arquiteto de software / Instrutor técnico / Consultor especializado]
+
+**Tom da explicação:**
+[Ex: Técnico e objetivo / Didático e detalhado / Consultivo e estratégico]
+
+**Nível de profundidade:**
+[Ex: Explicações básicas / Aprofundado com edge cases / Foco em performance / Visão de alto nível]
+
+---
+
+## 7. ✅ Critérios de Aceite
+[Liste condições objetivas que determinam se o resultado está correto]
+
+- [ ] [Ex: O código compila sem erros]
+- [ ] [Ex: Segue o padrão de arquitetura em camadas]
+- [ ] [Ex: Inclui tratamento de erros]
+- [ ] [Ex: Possui testes unitários com 80%+ de cobertura]
+- [ ] [Ex: Documentação atualizada]
+- [ ] [Ex: Performance < 100ms por requisição]
+
+---
+
+## 8. 💬 Exemplos *(opcional)*
+
+[Forneça exemplos de entrada e saída esperada se achar necessário]
+
+**Exemplo 1:**
+```
+Entrada: [Descreva a entrada]
+Saída esperada: [Descreva a saída]
+```
+
+**Exemplo 2:**
+```
+Entrada: [Descreva a entrada]
+Saída esperada: [Descreva a saída]
+```
+
+---
+
+## 9. 📂 Arquivos Envolvidos *(opcional)*
+
+[Liste os arquivos que devem ser criados, modificados ou consultados durante a tarefa]
+
+**Arquivos a criar:**
+- [Ex: `internal/service/order_service.go` — lógica de negócio de pedidos]
+- [Ex: `internal/handler/grpc/order_handler.go` — handler gRPC de pedidos]
+
+**Arquivos a modificar:**
+- [Ex: `internal/infra/di/fx.go` — registrar novos módulos no DI]
+- [Ex: `api/proto/v1/order.proto` — definir mensagens e RPCs de pedidos]
+
+**Arquivos de referência (consultar, não alterar):**
+- [Ex: `internal/service/user_service.go` — seguir mesmo padrão de implementação]
+- [Ex: `internal/handler/grpc/user_handler.go` — referência de como mapear DTOs]
+
+---
+
+## 10. 🧪 Testes de Unidade *(opcional)*
+
+[Defina expectativas sobre testes que devem acompanhar a implementação]
+
+**Escopo dos testes:**
+- [Ex: Testar apenas a camada de service]
+- [Ex: Cobrir fluxos de sucesso e erro]
+- [Ex: Incluir testes de integração com banco real]
+
+**Cenários obrigatórios:**
+- [Ex: Criação com dados válidos → sucesso]
+- [Ex: Criação com email duplicado → erro de conflito]
+- [Ex: Busca por ID inexistente → erro not found]
+- [Ex: Atualização sem permissão → erro de autorização]
+
+**Padrão de testes:**
+- [Ex: Table-driven tests com `testify`]
+- [Ex: Mocks para dependências externas]
+- [Ex: Nomenclatura: `TestNomeDoService_MetodoTestado_Cenario`]
+
+**Arquivo de referência:**
+- [Ex: `internal/service/user_service_test.go` — seguir mesmo padrão]
+
+---
+
+## 💡 Dicas de Uso
+
+* ✅ **Mínimo obrigatório:** Seções 1–6 (Contexto + Objetivo + Instruções + DEVE/NÃO DEVE + Formato + Persona)
+* ⭐ **Para 6 estrelas:** Adicione seções 7–10 (Critérios de Aceite + Exemplos + Arquivos + Testes)
+* 🎯 **Seja específico:** Quanto mais detalhes relevantes, melhor a resposta
+* 🎭 **Use DEVE/NÃO DEVE:** Esta seção é crucial para evitar comportamentos indesejados
+* 🔄 **Itere:** Ajuste o prompt baseado nos resultados obtidos
+* 📏 **Balanceie:** Detalhes suficientes sem ser verboso demais
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adi_dev_workflow",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Install SDD, miniStack and TaskCard development frameworks for Claude Code and Cursor",
   "type": "module",
   "bin": {