How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-data-modelingBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Modelar os dados do produto
Use esta skill para entender e evoluir dados persistentes, sem escolher banco ou biblioteca por suposição. Leia a stack, o sistema atual, migrations, schemas, models, contratos e testes antes de propor alteração.
Trabalho
- Identifique as entidades, seus papéis e as relações observadas no código.
- Registre campos, tipos, obrigatoriedade, origem, ciclo de vida e quem pode
consultar ou alterar cada informação.
- Descreva unicidade, consistência, retenção, exclusão, histórico e migração
quando forem pertinentes.
- Atualize a seção de dados da spec e encaminhe respostas confirmadas para
$specsfy-aux-database e .specsfy/DATABASE.md.
- Derive cenários para criação, leitura, atualização, exclusão, autorização e
dados inválidos. A implementação usa o especialista do banco detectado.
Não invente campos, relações ou tecnologia. A pessoa confirma o que o produto precisa guardar quando o sistema atual não responder.
Quando usar
- Use ao alterar tabelas, schemas, models, migrations ou contratos persistentes.
- Use também ao mapear relações e ciclos de vida antes de criar uma spec.
- Não use para escolher uma biblioteca de banco sem dados do projeto.
Fluxo
- Ler stack, migrations, schemas, models e testes existentes.
- Separar entidades, relações, campos e estados observados.
- Registrar regras de unicidade, retenção, exclusão e histórico.
- Comparar a proposta com os contratos e consultas atuais.
- Encaminhar a confirmação para a skill de banco do projeto.
- Exigir uma tarefa
[MIGRATION]com arquivo versionado para qualquer mudança
ligada ao banco e conferir sua aplicação em uma base de teste.
Padrões
- Cada campo registra tipo, origem, presença e ciclo de vida.
- Cada relação informa cardinalidade e forma de carga.
- Toda migration preserva dados existentes ou descreve a conversão necessária.
Antipadrões
- Criar campos sem uso observado no produto.
- Alterar uma relação sem conferir queries, factories e testes.
- Escolher tecnologia antes de ler o stack existente.
Validação
- Rode os testes e validadores ligados ao modelo persistente.
- Confira a migration em uma cópia do banco e compare o schema resultante.
- Confirme o arquivo, o comando de aplicação e a consulta do estado da
migration antes de encerrar a tarefa.
- Não declare o modelo pronto sem uma saída verificável do projeto.
Skills relacionadas
$specsfy-aux-databasepara manter o mapa persistente do projeto.$specsfy-specialist-postgrespara detalhes próprios do Postgres.$specsfy-specialist-laravelpara migrations e models Laravel.
Leia references/standards.md para fontes de modelagem, migrations e contratos persistentes.

