Descobrir as informações que o sistema precisa guardar
Descubra, com a pessoa e nas palavras dela, o que o sistema precisa lembrar,
quem usa cada informação e quando ela muda ou deixa de valer. O resultado é um
registro confirmado em .specsfy/DATABASE.md que backlog e spec usam como
contexto.
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: perguntas.
Antes de formular qualquer pergunta, leia e aplique o
Contrato de perguntas numeradas de .specsfy/Spec.md.
Converse em Português do Brasil sem pedir que a pessoa descreva banco de dados, tabela, campo, chave ou relacionamento. Use as palavras do produto: o que será lembrado, quem usa, o que muda e quando deixa de ser necessário.
Pronto quando
- Cada informação a guardar aplicável está confirmada, adiada ou encerrada pela pessoa, dentro do limite de oito perguntas por área.
- Cada resposta confirmada foi gravada pelo comando na seção
Informações a guardar confirmadasde.specsfy/DATABASE.md, com fontes. - Nenhuma hipótese, dado real, credencial ou informação pessoal sensível foi gravada.
- O controle voltou à skill que chamou esta descoberta.
Preparar a conversa
- Leia em paralelo a origem da descoberta (Inbox,
MVP.md, backlog, spec ou pedido),PROJECT.mde.specsfy/DATABASE.mdquando existirem. - Separe o que já está confirmado do que ainda precisa de conversa.
- Considere só informações que o sistema precise guardar, consultar, comparar, mostrar, compartilhar, corrigir ou apagar. Dado que não altera a jornada nem a operação fica fora da conversa.
- Preserve fontes e formulações da pessoa. Hipótese não entra no arquivo como conteúdo confirmado.
Perguntar sem linguagem técnica
Mantenha uma lista das informações a guardar ausentes ou ambíguas. Em cada rodada, escolha a de maior impacto ainda não confirmada. Depois de cada resposta, atualize a lista e siga para a próxima. Ajuste ao contexto perguntas como:
- "O que você precisa lembrar sobre cada pedido, pessoa ou atendimento?"
- "Quem pode ver ou mudar essa informação?"
- "O que precisa continuar ligado quando uma pessoa fizer mais de um pedido?"
- "Quando essa informação muda, deixa de valer ou precisa ser apagada?"
- "Que informação não pode aparecer para outras pessoas?"
Não explique a mecânica interna. Se a pessoa usar termos técnicos, confirme o efeito no trabalho dela antes de registrar.
Sugerir como cada informação será registrada
Depois de entender a finalidade, proponha uma forma simples de registro, escolhida pelo uso esperado e sem citar tecnologia:
| Uso | Sugestão |
|---|---|
| nomes, títulos e códigos lidos rapidamente | texto curto |
| observações e descrições maiores | texto livre |
| quantidades, medidas e contagens | número |
| preços, cobranças e descontos | valor em dinheiro |
| agendamentos, prazos e acontecimentos | data ou horário |
| situação, categoria ou prioridade | escolha entre opções |
| confirmações | sim ou não |
| comprovantes e anexos | arquivo ou imagem |
Apresente a sugestão como hipótese, explique o motivo em uma frase e pergunte
se ela representa o uso real. Registre o formato sugerido só depois da
confirmação. Uma informação com usos distintos gera um registro por uso.
Registrar o que foi confirmado
Depois de cada resposta confirmada, chame o script com nome do domínio e frases curtas que quem opera o produto entenda:
specsfy context data \
--project <raiz> \
--name "<informação do produto>" \
--purpose "<finalidade>" \
--store "<informações necessárias>" \
--format "<forma confirmada de registrar>" \
--links "<o que permanece ligado a quê>" \
--access "<quem consulta ou altera>" \
--lifecycle "<quando muda, deixa de valer ou é apagado>" \
--sources "<caminhos de Inbox, backlog, MVP ou spec>"
Pelo MCP, use a tool context_data. Sem o binário instalado, rode o script
equivalente:
node .agents/skills/specsfy-data-discovery/scripts/\
registrar_dados_conversados.mjs \
--project <raiz> \
--nome "<informação do produto>" \
--para-que-serve "<finalidade>" \
--o-que-guardar "<informações necessárias>" \
--formato-sugerido "<forma confirmada de registrar>" \
--ligacoes "<o que permanece ligado a quê>" \
--acesso "<quem consulta ou altera>" \
--ciclo-de-vida "<quando muda, deixa de valer ou é apagado>" \
--fontes "<caminhos de Inbox, backlog, MVP ou spec>"
Registre somente respostas confirmadas na seção Informações a guardar confirmadas, separada do que foi observado no código. O trecho detectado
automaticamente pertence a $specsfy-aux-database e fica intocado.
Handoffs
| Origem | Quando chamar esta skill |
|---|---|
$specsfy-02-backlog |
antes de declarar o brief pronto, se a jornada depender de informações guardadas |
$specsfy-mvp-milestone-interviewer |
para cada informação a guardar ausente ou ambígua em um backlog importado, preservando MVP.md como fonte |
$specsfy-03-specify |
quando a fonte de dados não explicar o que a jornada precisa lembrar ou quem consulta cada informação |
$specsfy-01-inbox |
nunca chama: a Inbox não pergunta, só preserva sinais para esta etapa |
Limites
- Não escolher tecnologia, estrutura interna ou implementação.
- Não criar backlog, spec, tarefas, testes ou código.
- Não preencher lacunas por inferência.
- Não registrar conteúdo sensível.