Skills especialistas do Specsfy por tecnologia usada

As skills base conduzem a metodologia. As specsfy-specialist-* acrescentam orientação para a tecnologia encontrada no projeto, como Laravel, Astro, Next.js, Postgres ou Redis. Assim, você instala somente o conhecimento técnico usado pela aplicação.

Na interface, cada uma usa o padrão Specsfy - Especialista - Nome, como Specsfy - Especialista - Laravel. O identificador de comando continua specsfy-specialist-laravel.

Para criar ou alterar interfaces, specsfy-specialist-interface-experience coordena a entrega e carrega specsfy-specialist-design-system antes dos especialistas de UX, UI e componentes. O design system mantém as regras macro, defaults e cenários CRUD, a experiência examina a stack e o sistema atual, organiza as perguntas sobre telas e menus e garante uma fase específica de interface nas tarefas.

Detectar e instalar

O comando detect lê o projeto e mostra recomendações sem instalar arquivos. O catálogo local só deve ser alterado depois que você revisar os nomes retornados:

1
specsfy skills detect

Depois da revisão, instale apenas os especialistas usados pela aplicação. A instalação sempre usa npx skills add e registra cada escolha no skills-lock.json, permitindo conferir depois quais arquivos são gerenciados:

1
npx skills add https://github.com/promovaweb/specsfy \
2
  --skill specsfy-specialist-laravel \
3
  --skill specsfy-specialist-postgres \
4
  --skill specsfy-specialist-redis \
5
  --agent universal --copy --full-depth

As skills base podem sugerir um especialista. Quando ele já estiver instalado, a transição é anunciada e continua na mesma conversa. Quando estiver ausente, o agente informa o especialista, a finalidade e as dependências, avisa que usará npx skills add e pede autorização específica para instalar. A transição entre skills nunca instala o catálogo inteiro automaticamente.

Instalação no setup

Ao iniciar o setup, você autoriza o Specsfy a detectar e instalar os especialistas diretamente ligados à stack encontrada, além de um núcleo comum para modelar dados, domínio, arquitetura e interfaces ReUI. Ele mostra os itens e usa npx skills add no projeto atual. Tecnologias sem sinal no código não entram na instalação.

Instalação manual

Você pode instalar qualquer especialista do catálogo fora do setup. Essa opção serve para uma necessidade pontual que a stack ainda não revela, como revisão, acessibilidade ou pesquisa técnica:

1
npx skills add https://github.com/promovaweb/specsfy \
2
  --skill specsfy-specialist-web-accessibility --agent universal --copy --full-depth

O setup não remove especialistas instalados manualmente. Eles permanecem no projeto e podem ser usados quando a entrega precisar deles.

Para usar os componentes gratuitos do ReUI, instale o especialista e suas dependências resolvidas pelo catálogo:

1
npx skills add https://github.com/promovaweb/specsfy \
2
  --skill specsfy-specialist-reui --agent universal --copy --full-depth

Ele prepara o registry ReUI para React 19, Tailwind CSS v4 e shadcn/ui, atende Laravel com Inertia e Vite e preserva o padrão de outros frameworks React. Nos CRUDs e dashboards compatíveis, ReUI é a base para consulta, filtros, formulários, indicadores, ações contextuais, anexos e mensagens de retorno. A skill consulta o catálogo gratuito antes de permitir a criação de componente manual equivalente.

Gestor de pacotes Laravel

specsfy-specialist-laravel-package-manager recebe a URL de um repositório GitHub, lê seu contrato Composer e sua documentação e compara o pacote com o que já existe no projeto. Quando a solicitação autoriza a instalação, executa composer require na raiz Laravel e confere o lockfile atualizado.

O resultado documental fica em docs/packages/:

• README.md é o índice dos pacotes Composer diretos, com versão, finalidade e link para cada ficha,
• <vendor>-<nome>.md explica instalação, configuração, uso local, testes e fontes consultadas,
• .specsfy/PACKAGES.md continua sendo a relação completa, incluindo dependências transitivas.

O especialista não repete uma instalação quando o pacote já aparece no manifest, no lockfile ou em vendor/. Se o repositório não expuser um pacote Composer compatível com Laravel, ele registra a lacuna e não altera os arquivos.

Contrato de interfaces React

Em Laravel com React, shadcn/ui e ReUI trabalham juntos: shadcn/ui fornece as primitives e ReUI fornece as composições gratuitas. Toda tela é construída por componentes React. A rota ou página coordena dados e compõe blocos, não reúne grade, formulário, filtros, diálogos, painel lateral e cartões reutilizáveis no mesmo arquivo.

O setup cria INTERFACE.md e DESIGNSYSTEM.MD na raiz do projeto quando eles estão ausentes. O primeiro registra tokens, registries, telas e todos os blocos criados ou reaproveitados. O arquivo DESIGNSYSTEM.MD guarda as regras macro, defaults, padrões de CRUD e dashboard, estados e exceções com alcance, a skill especialista o mantém. Para cada bloco, informe arquivo, origem, finalidade, props e eventos, estados, acessibilidade, consumidores e como reaproveitar ou estender. A seção 10 de cada spec com interface usa a mesma relação para declarar os blocos React e os componentes shadcn/ui e ReUI escolhidos. As tarefas de interface atualizam o mapa antes de serem concluídas.

Antes de desenvolver uma tela React, o planejamento e a implementação carregam $specsfy-specialist-react-ui-components. A skill procura primeiro os blocos existentes, orienta o reaproveitamento ou a adaptação e mantém INTERFACE.md alinhado ao código. Se ela ainda não estiver instalada, o fluxo retorna ao setup e instala o especialista detectado antes de escrever JSX ou TSX.

Nas superfícies CRUD, a regra padrão é PageHeader e DataGrid para listas, com a linha inteira abrindo o detalhe por clique ou teclado, PageHeader e DetailLists para detalhes, e PageHeader com seções de formulário em duas colunas responsivas para criar e editar. Botões, checkboxes e menus internos ficam independentes da navegação da linha. Erros de campo ficam vermelhos e recebem mensagem abaixo do campo. Toda tela também exibe Breadcrumb com a equipe ativa, o módulo e o título atual. Em Laravel, o padrão reaproveita o Breadcrumb ou Breadcrumbs existente no layout.

Catálogo por domínio

Cada especialista explica o fluxo de trabalho e as validações próprias da sua tecnologia. Uma mudança em Eloquent pode combinar Laravel e Postgres, por exemplo, mas uma alteração isolada em uma página Astro não precisa carregar orientações de todo o catálogo.

Relação com as bases

• specsfy-02-backlog identifica a necessidade.
• specsfy-03-specify registra requisitos e atributos de qualidade.
• specsfy-04-validate seleciona lentes de revisão.
• specsfy-05-tasks usa checklists técnicos para decompor trabalho.
• specsfy-06-tdd-bdd preserva RED/GREEN.
• specsfy-07-implement executa de acordo com a stack.
• specsfy-update-spec revisa requisitos e atributos de qualidade afetados por uma mudança posterior.
• specsfy-progress identifica a orientação técnica aplicável e executa a transição automática.

A presença de um especialista não aprova gates. O Plan Gate ainda exige um RED válido, e o Delivery Gate depende dos testes e das evidências registradas na spec.