feature-sliced/skills

O que skills faz?

Habilidades para agentes de IA que aplicam o Feature-Sliced Design (FSD) v2.1 em projetos frontend.

Visão Geral

Este pacote de habilidades permite que agentes de IA (como Claude Code, Cursor e Codex) entendam e apliquem os princípios do Feature-Sliced Design (FSD) versão 2.1. O FSD é uma metodologia arquitetural que organiza o código frontend em uma hierarquia de camadas, fatias e segmentos, garantindo modularidade e escalabilidade.

Como usar

Inclua este arquivo no contexto do seu agente ou use o comando /skill feature-sliced/skills para carregar as instruções.

Estrutura principal

O FSD define as seguintes camadas (layers):

• app — Configuração da aplicação
• processes (opcional) — Processos de negócio
• pages — Páginas da aplicação
• features — Funcionalidades de negócio
• widgets — Componentes independentes
• entities — Entidades de negócio
• shared — Código compartilhado (UI, helpers, API)

Regras de importação

• Uma camada pode importar apenas de si mesma ou de camadas abaixo na hierarquia (ex.: features pode importar de entities e shared, mas não de pages).
• Fatias (slices) dentro de uma mesma camada podem importar entre si, mas com cuidado para evitar dependências cíclicas.
• Segmentos públicos (public segments) como ui, model, api e lib devem ser expostos via index.js.

Comandos do agente

• /fsd scaffold <nome-da-fatia> — Cria a estrutura de diretórios para uma nova fatia
• /fsd check — Verifica se o projeto segue as regras do FSD
• /fsd explain — Explica a arquitetura atual no contexto do FSD

Exemplo de uso

# Solicitar ao agente que crie uma fatia de autenticação
/fsd scaffold auth

O agente criará a estrutura:

features/auth/
  ui/
    LoginForm/
    LogoutButton/
  model/
    store.ts
  api/
    authApi.ts
  index.ts

Contribuição

Sinta-se à vontade para abrir issues ou pull requests no repositório original.

Licença

MIT