Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-data-modelingAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
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.

