promovaweb/specsfy

specsfy-specialist-data-modeling

Modelar dados, entidades, relações, ciclos de vida, qualidade e contratos persistentes antes de implementar mudanças.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. 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-modeling

Avant 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é.
Document Skill original

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

  1. Identifique as entidades, seus papéis e as relações observadas no código.
  2. Registre campos, tipos, obrigatoriedade, origem, ciclo de vida e quem pode

consultar ou alterar cada informação.

  1. Descreva unicidade, consistência, retenção, exclusão, histórico e migração

quando forem pertinentes.

  1. Atualize a seção de dados da spec e encaminhe respostas confirmadas para

$specsfy-aux-database e .specsfy/DATABASE.md.

  1. 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

  1. Ler stack, migrations, schemas, models e testes existentes.
  2. Separar entidades, relações, campos e estados observados.
  3. Registrar regras de unicidade, retenção, exclusão e histórico.
  4. Comparar a proposta com os contratos e consultas atuais.
  5. Encaminhar a confirmação para a skill de banco do projeto.
  6. 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-database para manter o mapa persistente do projeto.
  • $specsfy-specialist-postgres para detalhes próprios do Postgres.
  • $specsfy-specialist-laravel para migrations e models Laravel.

Leia references/standards.md para fontes de modelagem, migrations e contratos persistentes.

Tâches connexes

du même dépôt

Autres Skills

Tous les Skills
promovaweb
Communauté

specsfy-specialist-react

Projetar, implementar e revisar interfaces React com composição, estado, efeitos, concorrência, acessibilidade, performance e testes. Use quando a tarefa envolve componentes React, hooks, context, forms ou renderização cliente; use também para decidir ownership de estado entre componente, context e biblioteca externa; não use para fronteiras server/client, cache ou routing de framework — aí use a skill Next.js; para a galeria de componentes visuais prontos, use react-ui-components.

Installations / 1h
2
GitHub Stars
86
Mis à jour
14 oct.
promovaweb
Communauté

specsfy-specialist-ui-design

Projetar e revisar interfaces visuais de sistemas, dashboards e aplicações com hierarquia, layout, tokens, componentes, densidade, estados e responsividade. Use para telas, dashboards, design systems, layouts, tabelas, formulários e navegação; combine com UX e acessibilidade quando houver fluxo ou interação.

Installations / 1h
2
GitHub Stars
86
Mis à jour
14 oct.
promovaweb
Communauté

specsfy-specialist-domain-modeling

Descobrir e refinar linguagem ubíqua de domínio, invariantes, eventos, aggregates e bounded contexts a partir de cenários concretos, evitando anemic domain model. Use quando termos, regras ou ownership de dados estiverem ambíguos, dois times usarem a mesma palavra com sentido diferente, ou uma decisão de modelo for necessária; não criar documentação paralela à fonte autorizada; não use para decisão de infraestrutura ou deployment, use $specsfy-specialist-software-architecture para isso.

Installations / 1h
2
GitHub Stars
86
Mis à jour
14 oct.
promovaweb
Communauté

specsfy-specialist-reui

Criar interfaces React e Tailwind CSS com os componentes gratuitos do ReUI. Use em projetos com React, Tailwind CSS e shadcn/ui, incluindo Laravel com Inertia; não use itens premium nem introduza ReUI sem confirmar a stack.

Installations / 1h
2
GitHub Stars
86
Mis à jour
14 oct.