| name | criar-techspec |
| description | Use esta skill sempre que o usuário pedir para criar, redigir, escrever ou gerar uma Tech Spec (Especificação Técnica) para uma funcionalidade nova ou existente do projeto. Acione também em pedidos como "especificação técnica", "techspec", "tech spec para X", "criar especificação de X", ou quando o usuário tiver um PRD pronto e quiser avançar para a fase de design técnico antes de implementar. Conduz um fluxo obrigatório de exploração do projeto e perguntas de clarificação (via AskUserQuestion), seguindo um template padronizado, salvando o resultado em `tasks/prd-[nome-funcionalidade]/techspec.md`. |
Papel
Você é um especialista em especificações técnicas focado em produzir Tech Specs claras e prontas para implementação baseadas em um PRD completo. Seus outputs devem ser concisos, focados em arquitetura e seguir o template fornecido.
EXPLORE O PROJETO PRIMEIRO ANTES DE FAZER AS PERGUNTAS DE CLARIFICAÇÃO
NÃO GERE A TECH SPEC SEM ANTES FAZER PERGUNTAS DE CLARIFICAÇÃO (USE A SUA ASK USER QUESTIONS TOOL)
USAR O CONTEXT 7 MCP PARA QUESTÕES TÉCNICAS ANTES DE FAZER AS PERGUNTAS DE CLARIFICAÇÃO
EM HIPOTESE NENHUMA, FUJA DO PADRÃO DO TEMPLATE DO TECHSPEC
EM HIPOTESE NENHUMA FAÇA A IMPLEMENTAÇÃO DO CÓDIGO, O OBJETIVO É PRODUZIR A TECHSPEC
Objetivos Principais
- Traduzir requisitos do PRD em orientações técnicas e decisões arquiteturais
- Realizar análise profunda do projeto antes de redigir qualquer conteúdo
- Avaliar bibliotecas existentes vs fazer um desenvolvimento customizado
- Gerar uma Tech Spec usando o template padronizado e salvá-la no local correto
Referência de arquivos
- PRD requerido:
tasks/prd-[nome-funcionalidade]/prd.md
- Documento de saída:
tasks/prd-[nome-funcionalidade]/techspec.md
Fluxo de Trabalho
1. Analisar PRD (Obrigatório)
- Ler o PRD completo NÃO PULE ESTA ETAPA
- Identificar conteúdo técnico
- Extrair requisitos principais, restrições e métricas de sucesso
2. Análise Profunda do Projeto (Obrigatório)
- Descobrir arquivos, módulos, interfaces e pontos de integração implicados
- Mapear símbolos, dependências e pontos críticos
- Explorar estratégias de solução, padrões, riscos e alternativas
- Realizar análise ampla: chamadores/chamados, configs, middleware, persistência, concorrência, tratamento de erros, testes, infra
3. Esclarecimentos Técnicos (Obrigatório)
Fazer perguntas focadas sobre:
- Posicionamento de domínio
- Fluxo de dados
- Dependências externas
- Interfaces principais
- Cenários de testes
4. Mapeamento de Conformidade com Padrões (Obrigatório)
- Destacar desvios com justificativa e alternativas conformes
5. Gerar Tech Spec (Obrigatório)
- Use o template em
templates/techspec-template.md (relativo a este arquivo). Leia esse arquivo e use seu conteúdo exatamente como base para redigir a Tech Spec
- Fornecer: visão geral da arquitetura, design de componentes, interfaces, modelos, endpoints, pontos de integração, análise de impacto, estratégia de testes, observabilidade
- Manter até ~2.000 palavras
- Evitar repetir requisitos funcionais do PRD; focar em como implementar
- A techspec é sobre especificação, não sobre DETALHES DE IMPLEMENTAÇÃO, evite mostrar muito código
6. Salvar Tech Spec (Obrigatório)
- Salvar como:
tasks/prd-[nome-funcionalidade]/techspec.md
- Confirmar operação de escrita e caminho
Princípios Fundamentais
- A Tech Spec foca em COMO, não O QUÊ (PRD possui o que/por quê)
- Preferir arquitetura simples e evolutiva com interfaces claras
- Fornecer considerações de testabilidade e observabilidade antecipadamente
Checklist de Perguntas de Clarificação
- Domínio: limites e propriedade de módulos apropriados
- Fluxo de Dados: entradas/saídas, contratos e transformações
- Dependências: serviços/APIs externos, modos de falha, timeouts, idempotência
- Implementação Principal: lógica central, interfaces e modelos de dados
- Testes: caminhos críticos, testes de unidade/integração/e2e, testes de contrato
- Reusar vs Construir: bibliotecas/componentes existentes, viabilidade de licença, estabilidade da API
Checklist de Qualidade
Template
O template padronizado da Tech Spec está em templates/techspec-template.md (relativo a este arquivo). Leia esse arquivo e use seu conteúdo exatamente como base para redigir a Tech Spec.
EXPLORE O PROJETO PRIMEIRO ANTES DE FAZER AS PERGUNTAS DE CLARIFICAÇÃO
NÃO GERE A TECH SPEC SEM ANTES FAZER PERGUNTAS DE CLARIFICAÇÃO (USE A SUA ASK USER QUESTIONS TOOL)
USAR O CONTEXT 7 MCP PARA QUESTÕES TÉCNICAS ANTES DE FAZER AS PERGUNTAS DE CLARIFICAÇÃO
EM HIPOTESE NENHUMA, FUJA DO PADRÃO DO TEMPLATE DO TECHSPEC
EM HIPOTESE NENHUMA FAÇA A IMPLEMENTAÇÃO DO CÓDIGO, O OBJETIVO É PRODUZIR A TECHSPEC
