Directories - Règles de la communauté Cursor et Windsurf et répertoire du serveur MCP

Aperçu du projet

Directories est un projet open source conçu spécifiquement pour les communautés Cursor et Windsurf, offrant une plateforme centralisée pour la gestion et le partage des règles (Rules) et des serveurs MCP (Model Context Protocol). Ce projet est développé et maintenu par Pontus Abrahamsson, et vise à aider les développeurs à mieux utiliser les outils de programmation assistée par IA.

Fonctionnalités principales

1. Système de gestion des règles

• Stockage centralisé des règles: Gère de manière centralisée diverses règles de développement et invites (prompts) dans le répertoire packages/data/rules/
• Format standardisé: Chaque règle inclut un format de paramètres unifié, garantissant cohérence et utilisabilité
• Gestion par catégorie: Organise les règles par langage de programmation, framework ou outil

2. Mécanisme de contribution communautaire

• Contribution ouverte: Tout développeur peut soumettre de nouvelles règles ou améliorer celles existantes
• Processus normalisé: Fournit des directives de contribution détaillées pour assurer la qualité et la conformité du code
• Validation par test: Exige des contributeurs qu'ils testent les invites pour s'assurer de leur bon fonctionnement dans les environnements de développement pertinents

3. Intégration du serveur MCP

• Support MCP: Prend en charge le Model Context Protocol, améliorant les capacités d'interaction des outils d'IA
• Compatibilité multi-outils: Prend en charge simultanément les deux principaux outils de programmation IA, Cursor et Windsurf

Architecture technique

Structure du projet

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # Fichier d'index des règles
│           └── rules/            # Répertoire des fichiers de règles spécifiques
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Configuration liée à Cursor
│   └── windsurf/                 # Configuration liée à Windsurf

Format de définition des règles

Chaque fichier de règle doit inclure les paramètres standard suivants :

{
  tags: ["JavaScript", "Next.js"],           // Balises spécifiques au langage
  title: "Next.js Best Practices",           // Titre de la règle
  slug: "nextjs-best-practices",             // Identifiant unique
  content: `your amazing prompt`,            // Contenu de l'invite (prompt)
  author: {                                  // Informations sur l'auteur
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

Mode d'emploi

Configuration de l'environnement de développement

# Installer les dépendances
npm install

# Démarrer le serveur de développement
npm run dev
# Ou
yarn dev
# Ou
pnpm dev
# Ou
bun dev

# Accéder à http://localhost:3000

Ajout d'une nouvelle règle

1. Localiser l'index des règles: Ajouter l'importation de la nouvelle règle dans le fichier packages/data/rules/index.ts

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

2. Créer le fichier de règle: Créer un nouveau fichier de règle dans le répertoire packages/data/rules/

   // Par exemple : nextjs.ts
   export const nextjsRules = {
     // Définition de la règle
   };
   

3. Définir le contenu de la règle: Rédiger la règle selon le format standard, en s'assurant :

   • Précision: Pertinente et précise par rapport à la règle
   • Clarté: Formulation claire, facile à comprendre et à utiliser pour les développeurs
   • Opérabilité: Fournit des étapes ou des informations concrètes pour résoudre les problèmes courants

Mise à jour d'une règle existante

1. Trouver le fichier de règle pertinent
2. Ajouter le nouveau contenu sous l'invite existante
3. S'assurer que le nouveau contenu a été testé et validé

Caractéristiques de la communauté

Assurance qualité

• Exigence de test: Toutes les invites doivent être testées et validées
• Garantie de précision: Assurer la précision et l'utilité du contenu des règles
• Amélioration continue: La communauté maintient et améliore continuellement les règles existantes

Convivialité pour les développeurs

• Documentation détaillée: Fournit des guides de contribution et des instructions d'utilisation complets
• Processus standardisé: Format de règle et processus de soumission unifiés
• Mécanisme de reconnaissance: Met en valeur les contributions des auteurs via leurs informations

Intégration d'outils

• Prise en charge de plusieurs éditeurs: Prend en charge simultanément Cursor et Windsurf
• Application en temps réel: Prend en charge l'application automatique des règles, avec correspondance intelligente des modèles de chemins de fichiers
• Intégration MCP: Prend en charge le protocole Model Context Protocol, améliorant les capacités d'interaction de l'IA

Avantages du projet

1. Gestion centralisée: Gère de manière centralisée les règles et invites dispersées, facilitant la recherche et l'utilisation
2. Format standardisé: Le format de règle unifié assure la compatibilité et la maintenabilité
3. Piloté par la communauté: Le mécanisme de contribution ouvert favorise le partage des connaissances et l'amélioration continue
4. Indépendant des outils: Prend en charge simultanément plusieurs outils de programmation IA, augmentant l'applicabilité
5. Assurance qualité: Des processus de test et de validation rigoureux garantissent l'efficacité des règles

Scénarios d'application

• Programmation assistée par IA: Fournit des règles de programmation optimisées pour les utilisateurs de Cursor et Windsurf
• Collaboration en équipe: Les équipes peuvent partager et standardiser les conventions de programmation
• Amélioration des compétences: Les développeurs débutants peuvent apprendre les meilleures pratiques
• Optimisation des outils: Améliore les fonctionnalités des outils d'IA via le protocole MCP

Résumé

Le projet Directories est une plateforme communautaire axée sur la programmation assistée par IA. En gérant de manière centralisée les règles et les configurations de serveur MCP, il offre aux développeurs une bibliothèque de ressources standardisée et de haute qualité. Ce projet améliore non seulement l'efficacité du développement, mais favorise également la diffusion et l'application des meilleures pratiques en matière de programmation IA.