Directorios - Reglas de la Comunidad Cursor y Windsurf y Directorio de Servidores MCP

Resumen del Proyecto

Directories es un proyecto de código abierto diseñado específicamente para las comunidades de Cursor y Windsurf, que ofrece una plataforma centralizada para la gestión y el intercambio de reglas (Rules) y servidores MCP (Model Context Protocol). Este proyecto es desarrollado y mantenido por Pontus Abrahamsson, con el objetivo de ayudar a los desarrolladores a aprovechar mejor las herramientas de programación asistida por IA.

Características Principales

1. Sistema de Gestión de Reglas

• Almacenamiento Centralizado de Reglas: Gestiona de forma centralizada diversas reglas de desarrollo y prompts en el directorio packages/data/rules/.
• Formato Estandarizado: Cada regla incluye un formato de parámetros unificado, asegurando consistencia y usabilidad.
• Gestión por Categorías: Organizado por lenguaje de programación, framework o herramienta.

2. Mecanismo de Contribución de la Comunidad

• Contribución Abierta: Cualquier desarrollador puede enviar nuevas reglas o mejorar las existentes.
• Proceso Estandarizado: Proporciona guías detalladas de contribución para asegurar la calidad y conformidad del código.
• Validación por Pruebas: Requiere que los contribuidores prueben los prompts para asegurar su correcto funcionamiento en los entornos de desarrollo relevantes.

3. Integración con Servidores MCP

• Soporte MCP: Compatible con Model Context Protocol, mejorando la capacidad de interacción de las herramientas de IA.
• Compatibilidad Multi-herramienta: Soporta simultáneamente las dos principales herramientas de programación de IA: Cursor y Windsurf.

Arquitectura Técnica

Estructura del Proyecto

directories/
├── packages/
│   └── data/
│       └── rules/
│           ├── index.ts          # Archivo de índice de reglas
│           └── rules/            # Directorio de archivos de reglas específicas
│               ├── c.ts
│               ├── nextjs.ts
│               └── ...
├── apps/
│   ├── cursor/                   # Configuración relacionada con Cursor
│   └── windsurf/                 # Configuración relacionada con Windsurf

Formato de Definición de Reglas

Cada archivo de regla debe contener los siguientes parámetros estándar:

{
  tags: ["JavaScript", "Next.js"],           // Etiquetas específicas del lenguaje
  title: "Next.js Best Practices",           // Título de la regla
  slug: "nextjs-best-practices",             // Identificador único
  content: `your amazing prompt`,            // Contenido del prompt
  author: {                                  // Información del autor
    name: "Your Name",
    url: "https://github.com/username",
    avatar: "avatar-url"
  }
}

Modo de Uso

Configuración del Entorno de Desarrollo

# Instalar dependencias
npm install

# Iniciar el servidor de desarrollo
npm run dev
# o
yarn dev
# o
pnpm dev
# o
bun dev

# Acceder a http://localhost:3000

Añadir Nuevas Reglas

1. Localizar el índice de reglas: Añadir la importación de la nueva regla en el archivo packages/data/rules/index.ts.

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

2. Crear el archivo de regla: Crear un nuevo archivo de regla en el directorio packages/data/rules/.

   // Por ejemplo: nextjs.ts
   export const nextjsRules = {
     // Definición de la regla
   };
   

3. Definir el contenido de la regla: Escribir la regla siguiendo el formato estándar, asegurando:

   • Precisión: Relevante y preciso para la regla.
   • Claridad: Redacción clara, fácil de entender y usar para los desarrolladores.
   • Operatividad: Proporciona pasos concretos o insights para resolver problemas comunes.

Actualizar Reglas Existentes

1. Encontrar el archivo de regla correspondiente.
2. Añadir nuevo contenido debajo del prompt existente.
3. Asegurar que el nuevo contenido añadido ha sido probado y validado.

Características de la Comunidad

Garantía de Calidad

• Requisitos de Prueba: Todos los prompts deben ser probados y validados.
• Garantía de Precisión: Asegura la precisión y utilidad del contenido de las reglas.
• Mejora Continua: La comunidad mantiene y mejora continuamente las reglas existentes.

Amigable para Desarrolladores

• Documentación Detallada: Proporciona guías completas de contribución e instrucciones de uso.
• Proceso Estandarizado: Formato de reglas y proceso de envío unificados.
• Mecanismo de Reconocimiento: Muestra las contribuciones de los autores a través de su información.

Integración de Herramientas

• Soporte Multi-editor: Soporta simultáneamente Cursor y Windsurf.
• Aplicación en Tiempo Real: Soporta la aplicación automática de reglas, con coincidencia inteligente de patrones de rutas de archivo.
• Integración MCP: Soporta el protocolo Model Context Protocol, mejorando la capacidad de interacción de la IA.

Ventajas del Proyecto

1. Gestión Centralizada: Centraliza la gestión de reglas y prompts dispersos, facilitando su búsqueda y uso.
2. Formato Estandarizado: El formato unificado de las reglas asegura la compatibilidad y la mantenibilidad.
3. Impulsado por la Comunidad: Un mecanismo de contribución abierto fomenta el intercambio de conocimientos y la mejora continua.
4. Independencia de Herramientas: Soporta múltiples herramientas de programación de IA simultáneamente, aumentando la aplicabilidad.
5. Garantía de Calidad: Estrictos procesos de prueba y validación aseguran la efectividad de las reglas.

Escenarios de Aplicación

• Programación Asistida por IA: Proporciona reglas de programación optimizadas para usuarios de Cursor y Windsurf.
• Colaboración en Equipo: Los equipos pueden compartir y estandarizar las normas de programación.
• Mejora de Habilidades: Los desarrolladores novatos pueden aprender las mejores prácticas.
• Optimización de Herramientas: Mejora la funcionalidad de las herramientas de IA a través del protocolo MCP.

Resumen

El proyecto Directories es una plataforma comunitaria centrada en la programación asistida por IA, que proporciona a los desarrolladores un repositorio de recursos estandarizado y de alta calidad mediante la gestión centralizada de reglas y configuraciones de servidores MCP. Este proyecto no solo mejora la eficiencia del desarrollo, sino que también promueve la difusión y aplicación de las mejores prácticas en la programación con IA.