FSD Skills: fazer um agente de código estratificar por v2.1 em vez de cortar features primeiro

Para quem

Se está a reorganizar diretórios de um projeto front-end, ou hesita repetidamente se um pedaço de código vai para app, pages, features, entities ou shared, este conjunto de skills de Agent encaixa melhor. Serve para ensinar um agente de código a aplicar Feature-Sliced Design (FSD) v2.1: camadas, regras de import, decisões de colocação e padrões habituais. Corpo da metodologia:

https://fsd.how/

Assume que já tem um repositório front-end e aceita acrescentar as skills a um agente de código com npx. Quem só quer ler a metodologia e não planeia deixar um agente alterar diretórios começa pela documentação acima. A página não dá uma lista de clientes nem escreve FSD como plugin exclusivo de um framework, por isso não invente uma ligação de framework.

Conclua a primeira tentativa em 3 minutos

O comando oficial de instalação é só este:

npx skills add feature-sliced/skills

Escreve skills no seu ambiente de Agent. Confirme primeiro que esta máquina tem npx e que este é o agente de código que quer alterar, depois execute.

Depois de instalar, primeiro uma verificação só de leitura; não reorganize o repositório de imediato. Faça o agente confrontar a estrutura front-end atual com FSD v2.1: o que já está em app/, pages/, shared/, que direções de import parecem suspeitas. Sinal de sucesso: consegue falar de camadas e regras de import e mostra um viés pages-first — olhar primeiro estas três camadas, em vez de criar já features/ ou entities/. Se começar a mover ficheiros em lote, pare primeiro.

SKILL.md é a entrada. Exige que o agente leia ficheiros de referência só quando a tarefa os precisar, para manter o contexto inicial pequeno. A primeira pergunta deve ficar concreta em «verificar estrutura / para onde vai este código» e evitar que carregue todas as referências de uma vez.

Casos de uso

Caso 1: Montar ou reorganizar a estrutura de um projeto front-end. A página oficial lista este tipo de tarefa como momento de uso. O agente deve aplicar camadas v2.1 e padrões habituais, mas o viés é pages-first: começar por app/, pages/, shared/, e só abrir features ou entities quando uma responsabilidade partilhada já estável merecer uma fronteira. O excerto não dá um arquivo de modelo de diretórios nem um script de migração. Por isso a primeira reorganização deve primeiro produzir uma nota de confronto a listar os caminhos a mover; você confirma e depois altera ficheiros.

Caso 2: Julgar o ponto de queda do código. Outro momento de uso é decidir se o código pertence a app, pages, features, entities ou shared. Entregue um módulo existente ao agente e só pergunte «segundo FSD v2.1 que camada, os imports violam?». Não escreve regras de reparação automática nem uma tabela de confronto com uma biblioteca de rotas concreta. A aceitação só vê: uma sugestão de camada e uma razão de import; se sugerir cortar já um feature/entity, tem de explicar ao mesmo tempo por que essa responsabilidade partilhada já é estável. Abrir uma fronteira nova sem essa explicação fica fora deste material.

Limites de uso

Este conjunto ensina FSD v2.1, não uma FSD oral de qualquer ano. Os detalhes de metodologia seguem

https://fsd.how/

A página não cobre a estratificação de backend nem autoriza o agente a renomear em grande escala sem confirmação.

O caminho de instalação é npx skills add feature-sliced/skills. Não ponha dois instaladores lado a lado. A entrada é sempre SKILL.md; os ficheiros de referência leem-se a pedido. Não pode nomear esses ficheiros de referência a partir deste excerto, por isso não finja que já conhece um inventário completo.

Na primeira vez, pare na verificação de estrutura e no juízo de colocação. Qualquer movimentação de diretórios, criação de features/entities ou alteração de aliases de import deve primeiro fazer o agente listar os ficheiros que vai alterar e as razões; você confirma e depois continua.