promovaweb/specsfy

specsfy-specialist-data-modeling

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

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-data-modeling

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

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.

Verwandte Aufgaben

aus demselben Repository

Weitere Skills

Alle Skills
promovaweb
Community

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.

Installationen / 1h
2
GitHub Stars
86
Aktualisiert
14. Okt.
promovaweb
Community

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.

Installationen / 1h
2
GitHub Stars
86
Aktualisiert
14. Okt.
promovaweb
Community

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.

Installationen / 1h
2
GitHub Stars
86
Aktualisiert
14. Okt.
promovaweb
Community

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.

Installationen / 1h
2
GitHub Stars
86
Aktualisiert
14. Okt.