Manter o mapa de dados
Esta skill garante que .specsfy/DATABASE.md mostre a estrutura de dados que
o código realmente implementa, ao lado do que a conversa definiu. Uma mudança
de dados só está completa quando o mapa a reflete.
Pronto quando
- O bloco
specsfy:database corresponde a schemas, migrations, models e
configurações presentes.
- Relações, índices, constraints, ownership, retenção e finalidade estão
preenchidos ou marcados como desconhecidos, nunca inventados.
- Os testes relevantes à mudança de dados estão verdes.
specsfy context monitor --check não aponta mais .specsfy/DATABASE.md.
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.
Executar
Leia em paralelo as instruções locais, PROJECT.md, STACK.md e todo o
DATABASE.md.
Inspecione schemas, migrations, models persistentes e configurações sem
revelar valores de ambiente ou credenciais.
Atualize o bloco detectado:
specsfy context database --project <raiz>
Pelo MCP, use a tool context_database. Sem o binário instalado, rode o
script equivalente:
node .agents/skills/specsfy-aux-database/scripts/update_database.mjs \
--project <raiz>
Confira o resultado contra as fontes executáveis.
Complete à mão o que não pode ser inferido com segurança: relações,
índices, constraints, ownership, retenção e finalidade. Marque como
desconhecido o que nenhuma fonte sustentar.
Confirme que a persistência deixou de aparecer como pendência:
specsfy context monitor --project <raiz> --check
Pelo MCP, use a tool context_monitor. Sem o binário instalado, rode o
script equivalente:
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \
--project <raiz> --check
Conversa e código
Quando $specsfy-data-discovery tiver registrado 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 mostra também o que já
foi implementado, e divergências ficam visíveis em vez de corrigidas em
silêncio.
Limites
- Preserve todo conteúdo fora do bloco
specsfy:database.
- Use tabelas Markdown, que facilitam busca e comparação.
- Não copie dados de produção, strings de conexão, senhas, tokens ou valores
de
.env.
1---2name: specsfy-aux-database3description: "Mantém .specsfy/DATABASE.md como mapa tabular e completo da persistência: bancos, schemas, tabelas, campos, relações, índices e migrations, conferido contra o código. Use quando o monitor de contexto apontar persistência pendente, quando banco, tabela, coleção, model persistente, coluna, índice, relação, schema ou migration for criado ou alterado, ou ao auditar se o mapa corresponde ao código. Não use para descobrir com a pessoa quais dados guardar (use specsfy-data-discovery) nem para o stack (use specsfy-aux-stack)."4metadata:5 source: https://skillmd.com/skills/promovaweb/specsfy-aux-database6---78# Manter o mapa de dados910Esta skill garante que `.specsfy/DATABASE.md` mostre a estrutura de dados que11o código realmente implementa, ao lado do que a conversa definiu. Uma mudança12de dados só está completa quando o mapa a reflete.1314## Pronto quando1516- O bloco `specsfy:database` corresponde a schemas, migrations, models e17 configurações presentes.18- Relações, índices, constraints, ownership, retenção e finalidade estão19 preenchidos ou marcados como desconhecidos, nunca inventados.20- Os testes relevantes à mudança de dados estão verdes.21- `specsfy context monitor --check` não aponta mais `.specsfy/DATABASE.md`.2223## Preparação obrigatória2425Antes de executar esta skill, carregue obrigatoriamente `$specsfy-setup` na26raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.27Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma28pendência.2930## Modo de interação3132Modo de interação: `sem perguntas`.33Não formule perguntas nesta skill. Quando faltar informação confirmada,34sinalize o campo pendente para a etapa conversacional responsável.3536## Executar37381. Leia em paralelo as instruções locais, `PROJECT.md`, `STACK.md` e todo o39 `DATABASE.md`.402. Inspecione schemas, migrations, models persistentes e configurações sem41 revelar valores de ambiente ou credenciais.423. Atualize o bloco detectado:4344 ```bash45 specsfy context database --project <raiz>46 ```4748 Pelo MCP, use a tool `context_database`. Sem o binário instalado, rode o49 script equivalente:5051 ```bash52 node .agents/skills/specsfy-aux-database/scripts/update_database.mjs \53 --project <raiz>54 ```55564. Confira o resultado contra as fontes executáveis.575. Complete à mão o que não pode ser inferido com segurança: relações,58 índices, constraints, ownership, retenção e finalidade. Marque como59 desconhecido o que nenhuma fonte sustentar.606. Confirme que a persistência deixou de aparecer como pendência:6162 ```bash63 specsfy context monitor --project <raiz> --check64 ```6566 Pelo MCP, use a tool `context_monitor`. Sem o binário instalado, rode o67 script equivalente:6869 ```bash70 node .agents/skills/specsfy-setup/scripts/monitor_context.mjs \71 --project <raiz> --check72 ```7374## Conversa e código7576Quando `$specsfy-data-discovery` tiver registrado respostas confirmadas,77preserve a seção `Informações a guardar confirmadas` e compare-a com o que o78código revela. A conversa descreve o produto; este mapa mostra também o que já79foi implementado, e divergências ficam visíveis em vez de corrigidas em80silêncio.8182## Limites8384- Preserve todo conteúdo fora do bloco `specsfy:database`.85- Use tabelas Markdown, que facilitam busca e comparação.86- Não copie dados de produção, strings de conexão, senhas, tokens ou valores87 de `.env`.