Archivo .cursorrules (Reglas del Proyecto para IA)

1. Visión general del concepto y problema sistémico

Al trabajar en un proyecto junto con inteligencia artificial, rápidamente notará sus hábitos problemáticos:

• De repente decide instalar una versión obsoleta de una biblioteca que no se ha soportado en tres años.
• Escribe código en JavaScript en lugar de TypeScript estricto.
• Inventa su propia estructura de carpetas, rompiendo la arquitectura de su sitio.

El archivo .cursorrules es la ley de su proyecto. Es un conjunto breve de reglas en formato de texto plano o Markdown que coloca una vez en la raíz del proyecto. Cada vez que la IA intenta escribir o modificar una línea de código, debe consultar este archivo.

Principio ingenieril clave: la forma más sencilla de mantener el código limpio y ordenado sin lecciones diarias aburridas para el modelo.

2. Taxonomía arquitectónica y modelo mental

Aquí hay una plantilla lista para copiar en su proyecto ahora mismo:

# Stack tecnológico y estándares del proyecto
- Lenguaje: TypeScript (modo estricto strict: true)
- Framework: Next.js (App Router)
- Estilos: Tailwind CSS (sin estilos en línea ni CSS convencional)
- Base de datos: Drizzle ORM + PostgreSQL / SQLite

# Reglas para el agente:
1. Siempre escribe implementaciones completas de archivos. Nunca dejes comentarios perezosos como "// ... aquí va el resto del código".
2. Todos los textos y botones de usuario deben estar en ucraniano.
3. Antes de crear un nuevo paquete npm, verifica si ya hay un análogo instalado en package.json.
4. Si ves un error en la arquitectura, primero explica el riesgo y luego sugiere cambios.

3. Cuatro cosas que deben prohibirse

1. Prohibición de comentarios perezosos: Lo peor es cuando el modelo borra parte de su código de trabajo y escribe // ... keep existing code. Escriba una prohibición directa para esto.
2. Fijación de versiones de bibliotecas: Indique, por ejemplo: “Usa solo Lucide-React para íconos”, para que el modelo no importe FontAwesome y HeroIcons al mismo tiempo.
3. Reglas de nombramiento de componentes: Indique: “Los nombres de los componentes se escriben en PascalCase, los nombres de las utilidades en camelCase”.
4. Requisitos de tipos: Prohíba el uso del tipo any en TypeScript.

4. Escenarios prácticos de ingeniería en producción

01. Integración de un nuevo paquete npm

Al agregar un nuevo paquete npm, la IA consultará el archivo .cursorrules para asegurarse de que no haya conflictos con las bibliotecas ya instaladas, evitando así duplicaciones innecesarias.

02. Mantenimiento de estándares de codificación

La IA aplicará automáticamente las reglas de estilo definidas en el archivo .cursorrules, asegurando que todo el código generado cumpla con los estándares de calidad y estilo del proyecto.

03. Prevención de errores arquitectónicos

Cuando la IA detecte un error en la arquitectura, consultará el archivo .cursorrules para seguir el protocolo establecido, permitiendo una comunicación clara sobre los riesgos y las soluciones propuestas.

5. Errores comunes, trampas y seguridad

Uno de los errores más comunes es no actualizar el archivo .cursorrules cuando cambian los estándares del proyecto. Esto puede llevar a que la IA genere código que no cumpla con las nuevas directrices. Además, es crucial asegurarse de que el archivo esté correctamente ubicado en la raíz del proyecto, ya que cualquier error en la ubicación puede resultar en que la IA no lo consulte.