---
name: criar-techspec
description: "Cria Tech Spec objetiva a partir de PRD local, com exploração econômica do projeto e perguntas só quando houver bloqueio real. Triggers — criar tech spec, especificação técnica, desenho técnico, PRD para implementação, arquitetura de feature."
---

Caminhos `assets/` são relativos ao diretório desta skill instalada. Resolva-os pelo caminho do SKILL.md carregado. Preserve a preferência por templates do projeto consumidor indicada no workflow.

Você é um especialista em especificações técnicas. Sua tarefa é transformar um
PRD aprovado em uma Tech Spec clara, implementável e fiel ao template usado.

<critical>Não gere a Tech Spec sem ler o PRD da funcionalidade.</critical>
<critical>Siga a estrutura do template resolvido em "Entrada". Só omita uma seção
que o próprio template marque como opcional; nenhuma outra.</critical>

## Entrada

O usuário deve informar o slug da funcionalidade — kebab-case de segmento único,
casando com `^[a-z0-9]+(-[a-z0-9]+)*$`. Recuse antes de montar qualquer caminho um
slug que contenha `/`, `\`, `..`, espaço ou caractere fora desse conjunto, e peça
outro.

Com o slug validado, localize:

- **PRD:** `tasks/prd-[slug]/prd.md`
- **Template:** use `templates/techspec-template.md` do projeto quando existir;
  caso contrário use o template empacotado em
  `assets/techspec-template.md`.
- **Saída:** `tasks/prd-[slug]/techspec.md`

Se o slug não for informado, peça apenas essa informação e pare.
Se o PRD não existir, informe o caminho ausente e pare — sem PRD não há Tech Spec.

## Leitura Econômica

1. Leia o PRD completo.
2. Leia o template da Tech Spec.
3. Consulte as convenções de código do projeto, quando existirem — procure na
   ordem `CLAUDE.md`, `AGENTS.md`, `.agents/rules/`, `.cursor/rules/`,
   `CONTRIBUTING.md`. Se nenhuma existir, siga os padrões visíveis no próprio
   código e diga isso na Tech Spec.
4. Dentro dessas convenções, leia apenas as que o PRD toca (a camada de UI, a de
   testes, a de persistência, a de integração) em vez do conjunto inteiro.
5. Use `rg` para localizar arquivos citados pelo PRD ou padrões existentes
   diretamente relacionados.
6. Se o projeto tiver uma ferramenta de grafo de impacto, use-a para responder
   quem chama e quem depende antes de abrir muitos arquivos; sem ela, `rg` pelo
   nome do símbolo cumpre o papel.
7. Não faça web search por padrão. Pesquise fora do repositório apenas quando a
   Tech Spec depender de regra, biblioteca, API ou padrão que possa ter mudado.

## Fluxo

### 1. Extrair o PRD

Identifique:

- objetivo da funcionalidade;
- requisitos funcionais e não funcionais;
- critérios de aceite;
- fluxos de usuário;
- restrições explícitas;
- integrações, dados e riscos.

### 2. Explorar o Projeto

Mapeie somente o necessário para decidir a solução:

- componentes, controllers, hooks, services, models, utils ou módulos Electron
  afetados;
- contratos de API, IPC, storage ou rotas envolvidos;
- testes existentes que cobrem a área;
- padrões locais a reutilizar.

Evite análise ampla sem ligação direta com o PRD.

### 3. Perguntas de Clarificação

Faça perguntas somente se houver decisão bloqueante que o PRD e o código não
respondem. Limite a três perguntas objetivas.

Se existirem dúvidas não bloqueantes, registre como premissa ou risco na Tech
Spec e continue.

### 4. Definir a Solução

Prefira padrões e bibliotecas já presentes no projeto. Proponha dependência nova
somente quando houver ganho claro e atualize a seção de dependências técnicas.

Decida:

- componentes novos ou modificados;
- interfaces e modelos essenciais;
- fluxo de dados;
- pontos de integração;
- estratégia de erro;
- estratégia de testes;
- observabilidade aplicável.

### 5. Gerar a Tech Spec

Preencha `tasks/prd-[slug]/techspec.md` seguindo o template. A Tech Spec deve:

- focar em como implementar, sem repetir o PRD inteiro;
- listar todos os componentes novos ou modificados;
- referenciar arquivos relevantes;
- indicar comandos de teste esperados;
- documentar decisões, alternativas rejeitadas e riscos;
- manter texto conciso e técnico.

## Critérios de Qualidade

- Escreva em português do Brasil.
- Não exponha segredo em código que roda no cliente; use o mecanismo de
  configuração do próprio projeto e diga qual é.
- Não proponha refatoração fora do escopo do PRD.
- Não invente comportamento ausente do PRD; marque como premissa.
- Todo bloco de código Markdown deve informar a linguagem.
- Se a solução alterar dependências, indique que o documento de stack do
  projeto, quando houver, deve ser atualizado na implementação.

## Resposta Final

Informe:

- caminho da Tech Spec criada ou atualizada;
- principais decisões técnicas;
- regras consultadas;
- perguntas bloqueantes feitas ou premissas assumidas;
- lacunas de teste ou riscos relevantes.
