mcpField
S
specsfy-aux-database

specsfy-aux-database

github.com/promovawebData & databases87440 installsUpdated 1w ago
Repository

About specsfy-aux-database

specsfy-aux-database is an agent skill for maintaining a project's data map. It inspects schemas, migrations, models, and configuration, then updates DATABASE.md while preserving existing content and marking unknown details rather than guessing.

Key features

  1. 01Inspects schemas and migrations
  2. 02Updates DATABASE.md inventory
  3. 03Documents relationships and constraints
  4. 04Preserves content outside managed section
  5. 05Avoids copying secrets or production data

Use cases

  1. 01Refreshing a data map after schema changes
  2. 02Checking documented structures against source files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-aux-database

After installing, type/specsfy-aux-databasein Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlscripts/update_database.mjs

Details

From the project README

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.
  3. Executar node scripts/update_database.mjs --project <raiz>.
  4. Conferir o inventário detectado contra as fontes executáveis.
  5. 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.
  6. Preservar todo conteúdo fora do bloco specsfy:database.
  7. Considerar a mudança de dados incompleta até DATABASE.md refletir a nova estrutura e os testes relevantes estarem verdes.
  8. 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.

Comments

Markdown supported