Diretórios - Regras da Comunidade Cursor e Windsurf e Diretório do Servidor MCP

Visão Geral do Projeto

Directories é um projeto de código aberto projetado especificamente para as comunidades Cursor e Windsurf, fornecendo uma plataforma centralizada para gerenciar e compartilhar regras (Rules) e servidores MCP (Model Context Protocol). Este projeto é desenvolvido e mantido por Pontus Abrahamsson, com o objetivo de ajudar os desenvolvedores a utilizar melhor as ferramentas de programação assistida por IA.

Principais Funcionalidades

1. Sistema de Gerenciamento de Regras

• Armazenamento Centralizado de Regras: Gerencia centralmente várias regras de desenvolvimento e prompts no diretório packages/data/rules/.
• Formato Padronizado: Cada regra inclui um formato de parâmetro unificado, garantindo consistência e usabilidade.
• Gerenciamento por Categoria: Organizado por linguagem de programação, framework ou ferramenta.

2. Mecanismo de Contribuição da Comunidade

• Contribuição Aberta: Qualquer desenvolvedor pode enviar novas regras ou aprimorar as existentes.
• Processo Padronizado: Fornece diretrizes detalhadas de contribuição para garantir a qualidade e a conformidade do código.
• Validação por Teste: Exige que os contribuidores testem os prompts para garantir seu funcionamento adequado nos ambientes de desenvolvimento relevantes.

3. Integração com Servidor MCP

• Suporte MCP: Suporta o Model Context Protocol, aprimorando a capacidade de interação das ferramentas de IA.
• Compatibilidade com Múltiplas Ferramentas: Suporta simultaneamente as duas principais ferramentas de programação de IA, Cursor e Windsurf.

Arquitetura Técnica

Estrutura do Projeto

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # Arquivo de índice de regras
│           └── rules/            # Diretório de arquivos de regras específicas
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Configurações relacionadas ao Cursor
│   └── windsurf/                 # Configurações relacionadas ao Windsurf

Formato de Definição de Regras

Cada arquivo de regra deve conter os seguintes parâmetros padrão:

{
  tags: ["JavaScript", "Next.js"],           // Tags específicas da linguagem
  title: "Next.js Best Practices",           // Título da regra
  slug: "nextjs-best-practices",             // Identificador único
  content: `your amazing prompt`,            // Conteúdo do prompt
  author: {                                  // Informações do autor
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

Como Usar

Configuração do Ambiente de Desenvolvimento

# Instalar dependências
npm install

# Iniciar o servidor de desenvolvimento
npm run dev
# Ou
yarn dev
# Ou
pnpm dev
# Ou
bun dev

# Acessar http://localhost:3000

Adicionar Novas Regras

1. Localizar o índice de regras: Adicione a importação da nova regra no arquivo packages/data/rules/index.ts.

   import { cRules } from "./rules/c";
   

2. Criar arquivo de regra: Crie um novo arquivo de regra no diretório packages/data/rules/.

   // Por exemplo: nextjs.ts
   export const nextjsRules = {
     // Definição da regra
   };
   

3. Definir o conteúdo da regra: Escreva a regra no formato padrão, garantindo:

   • Precisão: Relevante e preciso para a regra.
   • Clareza: Redação clara, fácil para os desenvolvedores entenderem e usarem.
   • Acionabilidade: Fornece etapas ou insights específicos para resolver problemas comuns.

Atualizar Regras Existentes

1. Encontre o arquivo de regra relevante.
2. Adicione novo conteúdo abaixo do prompt existente.
3. Certifique-se de que o conteúdo recém-adicionado foi testado e validado.

Características da Comunidade

Garantia de Qualidade

• Requisito de Teste: Todos os prompts devem ser testados e validados.
• Garantia de Precisão: Garante a precisão e a utilidade do conteúdo das regras.
• Melhoria Contínua: A comunidade mantém e aprimora continuamente as regras existentes.

Amigável ao Desenvolvedor

• Documentação Detalhada: Fornece diretrizes completas de contribuição e instruções de uso.
• Processo Padronizado: Formato de regra e processo de envio unificados.
• Mecanismo de Reconhecimento: Exibe as contribuições dos colaboradores através das informações do autor.

Integração de Ferramentas

• Suporte a Múltiplos Editores: Suporta simultaneamente Cursor e Windsurf.
• Aplicação em Tempo Real: Suporta a aplicação automática de regras, correspondendo inteligentemente a padrões de caminho de arquivo.
• Integração MCP: Suporta o protocolo Model Context Protocol, aprimorando a capacidade de interação da IA.

Vantagens do Projeto

1. Gerenciamento Centralizado: Gerencia centralmente regras e prompts dispersos, facilitando a localização e o uso.
2. Formato Padronizado: O formato de regra unificado garante compatibilidade e manutenibilidade.
3. Orientado pela Comunidade: O mecanismo de contribuição aberta promove o compartilhamento de conhecimento e a melhoria contínua.
4. Independente de Ferramentas: Suporta simultaneamente várias ferramentas de programação de IA, aumentando a aplicabilidade.
5. Garantia de Qualidade: Processos rigorosos de teste e validação garantem a eficácia das regras.

Cenários de Aplicação

• Programação Assistida por IA: Fornece regras de programação otimizadas para usuários de Cursor e Windsurf.
• Colaboração em Equipe: Equipes podem compartilhar e padronizar normas de programação.
• Aprimoramento de Habilidades: Desenvolvedores iniciantes podem aprender as melhores práticas.
• Otimização de Ferramentas: Aprimora a funcionalidade das ferramentas de IA através do protocolo MCP.

Resumo

O projeto Directories é uma plataforma comunitária focada em programação assistida por IA, que, ao gerenciar centralmente regras e configurações de servidor MCP, oferece aos desenvolvedores um repositório de recursos padronizado e de alta qualidade. Este projeto não só aumenta a eficiência do desenvolvimento, mas também promove a disseminação e aplicação das melhores práticas de programação de IA.