[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M786CQP2SNH2BG3JZGX5CD89":3,"skill-same:01M786CQP2SNH2BG3JZGX5CD89":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M786CQP2SNH2BG3JZGX5CD89","prompt-spec",null,"allanpablo\u002Fforja","allanpablo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22358346?v=4","01M786AH79M6N27CC4HZ2AHJTQ","Allan Pablo","01M786AH80CPCTFFMSTRMGEGYF",2,"MIT","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fprompt-spec\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: prompt-spec\ndescription: Use quando passar trabalho de implementação para um agente de IA de código: transforma uma história ou requisito em prompts diretivos, prontos para colar, separados para backend e frontend, que exigem que o agente analise o código existente antes de mudar qualquer coisa e definem escopo, restrições e critérios de pronto.\n---\n\n# Especificação de Prompt\n\nUm agente de código faz o que o prompt torna fácil. Um prompt vago recebe uma implementação plausível que ignora os padrões do código, adiciona dependências e mexe em arquivos não relacionados. Um prompt diretivo declara o objetivo, obriga o agente a aprender o código antes, cerca o escopo e define \"pronto\" como comandos que passam.\n\nA saída padrão é **um prompt por lado (backend, frontend), pronto para colar**, mais a ordem de execução. Esta skill escreve prompts; não executa o agente.\n\n## Convenções\n\n- Entradas: uma história com critérios de aceite de `backlog-slicing`; o contrato de `api-design`; o modelo de `domain-modeling`; o próprio repositório (leia o README, o CLAUDE.md\u002FAGENTS.md e a estrutura antes de escrever).\n- Idioma do prompt: o do usuário, a menos que a documentação do código e os arquivos de agente estejam em outro.\n- Frases imperativas e específicas. Sem gentilezas de enchimento, sem texto motivacional.\n- Referencie caminhos, tipos e comandos reais do repositório. Leia-os antes; nunca invente um arquivo ou script.\n- Um prompt = uma história ou fatia. Um prompt que precisa de \"e também…\" são dois prompts.\n\n## Por que separar backend e frontend\n\nEles têm bases de código ou pastas, convenções, testes e revisores diferentes. O **contrato da API é a costura**: o prompt de backend o implementa, o prompt de frontend o consome. Os dois citam o mesmo contrato, então podem rodar em paralelo ou em sequência sem divergir. Rode o backend primeiro quando o contrato é novo; em paralelo quando ele já existe.\n\n## Estrutura do prompt\n\nTodo prompt tem estas seções, nesta ordem:\n\n1. **Objetivo**: uma ou duas frases, o resultado visível ao usuário. Referencie o ID da história.\n2. **Passo 0, analisar antes de implementar** (obrigatório): liste o que ler e o que relatar **antes de escrever código**:\n   - os arquivos e módulos que tratam de funcionalidades parecidas (nomeie-os);\n   - os padrões a copiar (tratamento de erro, validação, testes, nomes);\n   - os arquivos de agente (CLAUDE.md, AGENTS.md) e as configurações dos linters;\n   - um plano curto: arquivos a criar ou alterar, e por quê.\n   Instrua o agente a parar depois do relatório se algo contradisser o prompt.\n3. **Contexto**: as regras do domínio (`RN-NN`), o contrato (especificação do endpoint ou tipos), os ADRs relevantes. Cite-os; não parafraseie regras.\n4. **Requisitos**: os critérios de aceite em Dado\u002FQuando\u002FEntão, literalmente.\n5. **Restrições**:\n   - seguir as convenções encontradas no passo 0;\n   - nenhuma dependência nova sem perguntar;\n   - os testes vão junto com a mudança (conforme `testing` \u002F `ts-testing`);\n   - nada de refatorações, renomeações ou formatação não relacionadas;\n   - nenhuma mudança no contrato (o outro lado depende dele).\n6. **Fora do escopo**: o que não fazer, explicitamente (o outro lado, histórias futuras, migrações que são de outra pessoa).\n7. **Pronto quando**: comandos que precisam passar (`tsc --noEmit`, `npm test`, linters, build, como o repositório os define), e os critérios de aceite demonstrados.\n8. **Pare e pergunte se**: o contrato for impossível como escrito, uma regra for ambígua, a mudança precisar de uma migração ou de uma dependência nova, ou o passo 0 encontrar uma implementação existente.\n9. **Entregue**: um resumo dos arquivos alterados, como foi testado e uma mensagem de commit proposta (`commit-message`).\n\n## Formato\n\n````\n## Ordem de execução\n\u003Cbackend → frontend | paralelo>, porque \u003Cmotivo>\n\n## Prompt de backend\n```text\n\u003Cseções 1–9>\n```\n\n## Prompt de frontend\n```text\n\u003Cseções 1–9>\n```\n````\n\nOmita um lado quando a história só mexe no outro, e diga isso.\n\n## Próximo\n\n- Depois que o agente rodar: `ts-code-review` (ou a revisão da linguagem), depois `commit-message` e `pull-request`.\n- Se o passo 0 revelar uma questão de design: `architecture-decision-record` ou `technical-spike` antes de continuar.\n\n## No Forja\n\nNo Forja, além de colar o prompt, registre a entrega como handoff (ADR-0005), com os 7 campos: `forja hermes:handoff '\u003Cjson>'`, mapeando *context* ← Contexto, *acceptance* ← Requisitos + Pronto quando, *constraints* ← Restrições + Fora do escopo, *return* ← Entregue. Quem recebe lista os seus com `forja agent:route list --open --mine` e fecha com `forja agent:route done \u003Cid>`.\n\n## Evite\n\n- \"Implemente a funcionalidade X\" sem contexto.\n- Pular o passo 0, ou deixar o agente codificar antes de relatar a análise.\n- Um prompt só para backend e frontend juntos.\n- Caminhos, scripts ou tipos que não existem no repositório.\n- Deixar o agente mudar o contrato ou adicionar dependências em silêncio.\n- \"Pronto\" sem comandos que o provem.\n","# Especificação de Prompt\n\nUm agente de código faz o que o prompt torna fácil. Um prompt vago recebe uma implementação plausível que ignora os padrões do código, adiciona dependências e mexe em arquivos não relacionados. Um prompt diretivo declara o objetivo, obriga o agente a aprender o código antes, cerca o escopo e define \"pronto\" como comandos que passam.\n\nA saída padrão é **um prompt por lado (backend, frontend), pronto para colar**, mais a ordem de execução. Esta skill escreve prompts; não executa o agente.\n\n## Convenções\n\n- Entradas: uma história com critérios de aceite de `backlog-slicing`; o contrato de `api-design`; o modelo de `domain-modeling`; o próprio repositório (leia o README, o CLAUDE.md\u002FAGENTS.md e a estrutura antes de escrever).\n- Idioma do prompt: o do usuário, a menos que a documentação do código e os arquivos de agente estejam em outro.\n- Frases imperativas e específicas. Sem gentilezas de enchimento, sem texto motivacional.\n- Referencie caminhos, tipos e comandos reais do repositório. Leia-os antes; nunca invente um arquivo ou script.\n- Um prompt = uma história ou fatia. Um prompt que precisa de \"e também…\" são dois prompts.\n\n## Por que separar backend e frontend\n\nEles têm bases de código ou pastas, convenções, testes e revisores diferentes. O **contrato da API é a costura**: o prompt de backend o implementa, o prompt de frontend o consome. Os dois citam o mesmo contrato, então podem rodar em paralelo ou em sequência sem divergir. Rode o backend primeiro quando o contrato é novo; em paralelo quando ele já existe.\n\n## Estrutura do prompt\n\nTodo prompt tem estas seções, nesta ordem:\n\n1. **Objetivo**: uma ou duas frases, o resultado visível ao usuário. Referencie o ID da história.\n2. **Passo 0, analisar antes de implementar** (obrigatório): liste o que ler e o que relatar **antes de escrever código**:\n   - os arquivos e módulos que tratam de funcionalidades parecidas (nomeie-os);\n   - os padrões a copiar (tratamento de erro, validação, testes, nomes);\n   - os arquivos de agente (CLAUDE.md, AGENTS.md) e as configurações dos linters;\n   - um plano curto: arquivos a criar ou alterar, e por quê.\n   Instrua o agente a parar depois do relatório se algo contradisser o prompt.\n3. **Contexto**: as regras do domínio (`RN-NN`), o contrato (especificação do endpoint ou tipos), os ADRs relevantes. Cite-os; não parafraseie regras.\n4. **Requisitos**: os critérios de aceite em Dado\u002FQuando\u002FEntão, literalmente.\n5. **Restrições**:\n   - seguir as convenções encontradas no passo 0;\n   - nenhuma dependência nova sem perguntar;\n   - os testes vão junto com a mudança (conforme `testing` \u002F `ts-testing`);\n   - nada de refatorações, renomeações ou formatação não relacionadas;\n   - nenhuma mudança no contrato (o outro lado depende dele).\n6. **Fora do escopo**: o que não fazer, explicitamente (o outro lado, histórias futuras, migrações que são de outra pessoa).\n7. **Pronto quando**: comandos que precisam passar (`tsc --noEmit`, `npm test`, linters, build, como o repositório os define), e os critérios de aceite demonstrados.\n8. **Pare e pergunte se**: o contrato for impossível como escrito, uma regra for ambígua, a mudança precisar de uma migração ou de uma dependência nova, ou o passo 0 encontrar uma implementação existente.\n9. **Entregue**: um resumo dos arquivos alterados, como foi testado e uma mensagem de commit proposta (`commit-message`).\n\n## Formato\n\n````\n## Ordem de execução\n\u003Cbackend → frontend | paralelo>, porque \u003Cmotivo>\n\n## Prompt de backend\n```text\n\u003Cseções 1–9>\n```\n\n## Prompt de frontend\n```text\n\u003Cseções 1–9>\n```\n````\n\nOmita um lado quando a história só mexe no outro, e diga isso.\n\n## Próximo\n\n- Depois que o agente rodar: `ts-code-review` (ou a revisão da linguagem), depois `commit-message` e `pull-request`.\n- Se o passo 0 revelar uma questão de design: `architecture-decision-record` ou `technical-spike` antes de continuar.\n\n## No Forja\n\nNo Forja, além de colar o prompt, registre a entrega como handoff (ADR-0005), com os 7 campos: `forja hermes:handoff '\u003Cjson>'`, mapeando *context* ← Contexto, *acceptance* ← Requisitos + Pronto quando, *constraints* ← Restrições + Fora do escopo, *return* ← Entregue. Quem recebe lista os seus com `forja agent:route list --open --mine` e fecha com `forja agent:route done \u003Cid>`.\n\n## Evite\n\n- \"Implemente a funcionalidade X\" sem contexto.\n- Pular o passo 0, ou deixar o agente codificar antes de relatar a análise.\n- Um prompt só para backend e frontend juntos.\n- Caminhos, scripts ou tipos que não existem no repositório.\n- Deixar o agente mudar o contrato ou adicionar dependências em silêncio.\n- \"Pronto\" sem comandos que o provem.\n",{},"main","cfe29d604e93a4c19fd25db4289328f6ec17bb41","templates\u002Fproject\u002Fskills\u002Fprompt-spec",0,"https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja","npmjs.com\u002Fforjajs","https:\u002F\u002Fgithub.com\u002Fallanpablo","www.allanpablo.com.br","Gestor de TI","2026-11-15 05:12:58",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add allanpablo\u002Fforja --skill prompt-spec",{"tool":39,"command":40},"bunx","bunx skills add allanpablo\u002Fforja --skill prompt-spec",{"tool":42,"command":43},"pnpm","pnpm dlx skills add allanpablo\u002Fforja --skill prompt-spec","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fprompt-spec\u002FSKILL.md",true,[],[48,54,60,66,72,78],{"skillNo":49,"name":50,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M786DTCHHV8K0MZMQQA2N81Q","web-performance","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fweb-performance\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M786DQ9FDGFMJTF6WANNJ7QG","ts-testing","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-testing\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":18},"01M786DMASM9PXP0NSEZYTHA7Q","ts-module-layout","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-module-layout\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M786DH4Y3AD551JN35D2R3HY","ts-code-review","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-code-review\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M786DF1R7PCK6KB44B34110S","ts-async-patterns","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fts-async-patterns\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M786DDCF8GHQ8KY2X4DGY3XN","threat-modeling","https:\u002F\u002Fgithub.com\u002Fallanpablo\u002Fforja\u002Fblob\u002Fmain\u002Ftemplates\u002Fproject\u002Fskills\u002Fthreat-modeling\u002FSKILL.md",[],[]]