Registrar uma entrada na Inbox
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: sem perguntas.
Não formule perguntas nesta skill. Registre pontos ausentes para uma etapa
posterior sem interromper a captura.
Registre imediatamente o texto recebido em specs/inbox/. Trate a Inbox como
uma entrada durável anterior ao backlog: ela preserva intenção e
organiza sinais úteis, mas não decide requisitos nem autoriza implementação.
Não interromper a captura
- Não faça perguntas, mesmo quando a ideia estiver vaga, contraditória ou
incompleta.
- Não peça confirmação antes de escrever.
- Não bloqueie a captura por duplicata, falta de contexto ou incerteza.
- Registre lacunas em
Pontos a revisar no futuro; não tente resolvê-las com o
usuário nesta etapa.
- Depois de salvar, informe somente o caminho, um resumo breve do que foi
processado e o próximo passo opcional. Não inicie o próximo passo
automaticamente.
Preservar e pré-processar
- Faça uma verificação silenciosa de credenciais, tokens, chaves privadas e
dados pessoais sensíveis evidentes. Se encontrar algum, não grave o arquivo
nem faça perguntas; informe que a política de privacidade exige remover o
dado sensível e reenviar a ideia.
- Use como texto original todo o input que expressa a ideia. Preserve sua
formulação integral, sem “corrigi-la” ou substituir palavras.
- Derive silenciosamente um título curto, concreto e fiel. Gere o slug a
partir dele.
- Separe a análise nas categorias:
- Declaração: conteúdo explicitamente presente no texto original;
- Inferência: interpretação plausível, sempre identificada como tal;
- A revisar: lacuna, conflito ou decisão que poderá ser revista depois.
- Extraia somente quando houver evidência:
- resumo em uma frase;
- problema ou oportunidade;
- pessoas afetadas ou beneficiadas;
- resultado ou valor esperado;
- sinais de escopo, regra, restrição, canal ou solução mencionada;
- riscos, dependências e relações evidentes;
- possíveis direções de backlog ou spec, sem promovê-las.
- informações que o sistema talvez precise guardar, consultar, compartilhar
ou apagar, como sinal para conversa futura.
- Use
Não identificado no texto original. quando não houver base. Não
invente stakeholder, prioridade, prazo, regra, solução ou critério de aceite.
Criar o arquivo
Execute uma única vez:
node <diretório-da-skill>/scripts/capturar_inbox.mjs \
--input "<texto original integral>" \
--title "<título derivado>" \
--summary "<resumo>" \
--problem "<problema ou oportunidade>" \
--people "<pessoas afetadas>" \
--value "<resultado ou valor>" \
--signals "<sinais extraídos>" \
--data "<sinais sobre informações que talvez precisem ser guardadas>" \
--risks "<riscos ou dependências>" \
--directions "<direções futuras possíveis>" \
--review "<pontos a revisar futuramente>" \
[--root <raiz>]
O script usa .specsfy/templates/custom/Inbox.md quando presente e recorre a
.specsfy/templates/Inbox.md caso contrário. Ele cria
specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md e nunca sobrescreve uma captura
existente. Se o template estiver ausente, relate a instalação incompleta; não
crie um template paralelo dentro da skill.
Ciclo da captura
A captura nasce com Status: Capturada e permanece em specs/inbox/, a fila
ativa, enquanto qualquer parte do pedido estiver sem destino. Ela só sai dali
quando specs com Definition Gate: Passed cobrirem o pedido inteiro: nesse
momento $specsfy-04-validate executa specsfy inbox process, que a move para
specs/inbox/processed/ com Status: Processada, o texto original intacto e
as specs derivadas registradas. Esta skill nunca executa esse comando: capturar
e processar são atos de etapas diferentes.
Orquestrar a conversa
Esta skill é uma exceção deliberada ao handoff automático do framework:
capturar é o resultado final do pedido e precisa ocorrer sem perguntas nem
transições. Após escrever, apenas sugira um destes próximos passos:
- manter a entrada na Inbox;
- usar
$specsfy-02-backlog para refiná-la ou aprofundá-la.
- usar
$specsfy-data-discovery quando a entrada indicar informações que o
sistema precisará guardar. Essa conversa posterior registra somente o que
for confirmado em .specsfy/DATABASE.md.
Somente carregue outra skill se o mesmo pedido também ordenar explicitamente
esse trabalho. Nesse caso, anuncie
Transição automática: $specsfy-01-inbox → $<destino> — motivo: <motivo> — resultado esperado: <resultado> depois de a captura estar segura.
Limites
- Não pesquisar duplicatas antes de salvar.
- Não alterar nem apagar capturas anteriores. Não mover uma captura para
specs/inbox/processed/; essa saída pertence à validação, depois do
Definition Gate.
- Não transformar inferência em declaração do usuário.
- Não criar
specs/backlog/, qualquer pasta de estado de spec, tarefas,
research, testes ou
código.
- Não usar a ideia como fonte normativa de comportamento.
1---2name: specsfy-01-inbox-23description: "Use quando o usuário enviar uma ideia, pensamento, necessidade, oportunidade ou texto livre para guardar, capturar, anotar ou retomar depois. Preserve o input integral, faça pré-processamento silencioso e crie imediatamente um arquivo timestampado em `specs/inbox/`. Não faça perguntas, não peça confirmação e não crie backlog, spec, tarefas, testes ou código."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-01-inbox-26---78# Registrar uma entrada na Inbox910## Preparação obrigatória1112Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na13raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.14Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma15pendência.1617## Modo de interação1819Modo de interação: `sem perguntas`.20Não formule perguntas nesta skill. Registre pontos ausentes para uma etapa21posterior sem interromper a captura.2223Registre imediatamente o texto recebido em `specs/inbox/`. Trate a Inbox como24uma entrada durável anterior ao backlog: ela preserva intenção e25organiza sinais úteis, mas não decide requisitos nem autoriza implementação.2627## Não interromper a captura2829- Não faça perguntas, mesmo quando a ideia estiver vaga, contraditória ou30 incompleta.31- Não peça confirmação antes de escrever.32- Não bloqueie a captura por duplicata, falta de contexto ou incerteza.33- Registre lacunas em `Pontos a revisar no futuro`; não tente resolvê-las com o34 usuário nesta etapa.35- Depois de salvar, informe somente o caminho, um resumo breve do que foi36 processado e o próximo passo opcional. Não inicie o próximo passo37 automaticamente.3839## Preservar e pré-processar40411. Faça uma verificação silenciosa de credenciais, tokens, chaves privadas e42 dados pessoais sensíveis evidentes. Se encontrar algum, não grave o arquivo43 nem faça perguntas; informe que a política de privacidade exige remover o44 dado sensível e reenviar a ideia.452. Use como texto original todo o input que expressa a ideia. Preserve sua46 formulação integral, sem “corrigi-la” ou substituir palavras.473. Derive silenciosamente um título curto, concreto e fiel. Gere o slug a48 partir dele.494. Separe a análise nas categorias:50 - **Declaração:** conteúdo explicitamente presente no texto original;51 - **Inferência:** interpretação plausível, sempre identificada como tal;52 - **A revisar:** lacuna, conflito ou decisão que poderá ser revista depois.535. Extraia somente quando houver evidência:54 - resumo em uma frase;55 - problema ou oportunidade;56 - pessoas afetadas ou beneficiadas;57 - resultado ou valor esperado;58 - sinais de escopo, regra, restrição, canal ou solução mencionada;59 - riscos, dependências e relações evidentes;60 - possíveis direções de backlog ou spec, sem promovê-las.61 - informações que o sistema talvez precise guardar, consultar, compartilhar62 ou apagar, como sinal para conversa futura.636. Use `Não identificado no texto original.` quando não houver base. Não64 invente stakeholder, prioridade, prazo, regra, solução ou critério de aceite.6566## Criar o arquivo6768Execute uma única vez:6970```bash71node <diretório-da-skill>/scripts/capturar_inbox.mjs \72 --input "<texto original integral>" \73 --title "<título derivado>" \74 --summary "<resumo>" \75 --problem "<problema ou oportunidade>" \76 --people "<pessoas afetadas>" \77 --value "<resultado ou valor>" \78 --signals "<sinais extraídos>" \79 --data "<sinais sobre informações que talvez precisem ser guardadas>" \80 --risks "<riscos ou dependências>" \81 --directions "<direções futuras possíveis>" \82 --review "<pontos a revisar futuramente>" \83 [--root <raiz>]84```8586O script usa `.specsfy/templates/custom/Inbox.md` quando presente e recorre a87`.specsfy/templates/Inbox.md` caso contrário. Ele cria88`specs/inbox/AAAA-MM-DD-HHMMSS-<slug>.md` e nunca sobrescreve uma captura89existente. Se o template estiver ausente, relate a instalação incompleta; não90crie um template paralelo dentro da skill.9192## Ciclo da captura9394A captura nasce com `Status: Capturada` e permanece em `specs/inbox/`, a fila95ativa, enquanto qualquer parte do pedido estiver sem destino. Ela só sai dali96quando specs com `Definition Gate: Passed` cobrirem o pedido inteiro: nesse97momento `$specsfy-04-validate` executa `specsfy inbox process`, que a move para98`specs/inbox/processed/` com `Status: Processada`, o texto original intacto e99as specs derivadas registradas. Esta skill nunca executa esse comando: capturar100e processar são atos de etapas diferentes.101102## Orquestrar a conversa103104Esta skill é uma exceção deliberada ao handoff automático do framework:105capturar é o resultado final do pedido e precisa ocorrer sem perguntas nem106transições. Após escrever, apenas sugira um destes próximos passos:107108- manter a entrada na Inbox;109- usar `$specsfy-02-backlog` para refiná-la ou aprofundá-la.110- usar `$specsfy-data-discovery` quando a entrada indicar informações que o111 sistema precisará guardar. Essa conversa posterior registra somente o que112 for confirmado em `.specsfy/DATABASE.md`.113114Somente carregue outra skill se o mesmo pedido também ordenar explicitamente115esse trabalho. Nesse caso, anuncie116`Transição automática: $specsfy-01-inbox → $<destino> — motivo: <motivo> —117resultado esperado: <resultado>` depois de a captura estar segura.118119## Limites120121- Não pesquisar duplicatas antes de salvar.122- Não alterar nem apagar capturas anteriores. Não mover uma captura para123 `specs/inbox/processed/`; essa saída pertence à validação, depois do124 Definition Gate.125- Não transformar inferência em declaração do usuário.126- Não criar `specs/backlog/`, qualquer pasta de estado de spec, tarefas,127 research, testes ou128 código.129- Não usar a ideia como fonte normativa de comportamento.