criar-techspec · git:20261022.98a207d · 2026-10-22 · sha256 ac9397adb7592f56
criar-techspec git:20261022.98a207dA
Immutable. This exact content never changes and is served at /api/v1/blob/ac9397adb7592f56.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_3iruyxy4ktqomxwg/ac9397adb7592f5650645e1fdc02a9a33a8e58df8a1d04cfc0eea9ddf424141c.json
Then /plugin install criar-techspec@markdownregistry-3iruyxy4ktqomxwg in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- 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.