version: "1.0.0" name: specsfy-aux-database description: Monitorar e manter a documentação completa da persistência em .specsfy/DATABASE.md, com inventário tabular de bancos, schemas, tabelas, campos, relações e migrations. Use quando o monitor de contexto apontar persistência pendente, sempre que banco, tabela, coleção, model persistente, coluna, índice, relação, schema ou migration for criado ou alterado, e ao auditar se o mapa de dados corresponde ao código. Preserva notas e decisões humanas fora do inventário detectado.

Manter o mapa de dados

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. Quando faltar informação confirmada, sinalize o campo pendente para a etapa conversacional responsável.

1. Ler instruções locais, PROJECT.md, STACK.md e todo o DATABASE.md.
2. Inspecionar schemas, migrations, models persistentes e configurações sem

revelar valores de ambiente ou credenciais.

1. Executar node scripts/update_database.mjs --project <raiz>.
2. Conferir o inventário detectado contra as fontes executáveis.
3. Completar relações, índices, constraints, ownership, retenção e finalidade

que não possam ser inferidos com segurança; marcar desconhecidos em vez de inventar.

1. Preservar todo conteúdo fora do bloco specsfy:database.
2. Considerar a mudança de dados incompleta até DATABASE.md refletir a nova

estrutura e os testes relevantes estarem verdes.

1. Executar $specsfy-setup em modo de monitoramento antes de devolver o

handoff e exigir que .specsfy/DATABASE.md deixe de aparecer como pendência.

Quando $specsfy-data-discovery registrar respostas confirmadas, preserve a seção Informações a guardar confirmadas e compare-a com o que o código revela. A conversa descreve o produto; este mapa continua mostrando também o que já foi implementado.

Usar tabelas Markdown para permitir busca e comparação. Nunca copiar dados de produção, strings de conexão, senhas, tokens ou valores de .env.