specsfy-data-discovery
Conversa em linguagem cotidiana sobre as informações que o produto precisa guardar, sugere uma forma simples de registrar cada uma e grava somente respostas confirmadas em .specsfy/DATABASE.md. Use quando backlog, importação do MVP ou spec dependerem de informações lembradas pelo sistema que ainda estão ausentes ou ambíguas. Não use para mapear o banco já existente no código (specsfy-aux-database), escolher tecnologia ou modelar tabelas.
How do I install this agent skill?
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-data-discoveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a developer tool used to document data requirements through a conversational interface. It facilitates the discovery of what information a system needs to store and records the confirmed results into a Markdown file within the project. The skill includes explicit instructions to avoid recording sensitive data and employs basic sanitization to ensure data integrity.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/promovaweb/specsfy/specsfy-data-discovery">View specsfy-data-discovery on skillZs</a>