8. Archivos de Contexto: Adiestrando a la IA con .cursorrules y Reglas de Repositorio
Configura archivos .cursorrules y .github/copilot-instructions.md para que la IA conozca tu stack, librerías y estándares en cada prompt.
¿Qué son los Archivos de Reglas de Proyecto?
Uno de los problemas más agotadores al programar con IA es tener que repetir las mismas instrucciones una y otra vez en cada conversación: "recuerda que uso PHP 8.3 estricto", "no uses jQuery", "usa sentencias preparadas de PDO".
Herramientas como Cursor, Windsurf y GitHub Copilot resuelven esto permitiendo colocar archivos de configuración dedicados en la raíz de tu proyecto:
.cursorrules: Archivo en la raíz del repositorio que Cursor inyecta de forma invisible como prefijo a cada prompt que envías..github/copilot-instructions.md: Estándar de GitHub Copilot para definir pautas de codificación y estilo para todo el equipo.
Diagrama 8.1: El flujo de ensamblaje de contexto: cómo los archivos de reglas guían a la IA en tu repositorio.
Secciones Esenciales que Debe Tener tu Archivo de Reglas
- Stack Tecnológico Exacto: Versiones mayores de lenguajes y librerías para evitar funciones obsoletas o incompatibles.
- Librerías Prohibidas: Lista negra explícita de paquetes que no deseas que la IA introduzca en tu código.
- Patrones de Arquitectura y Nombrado: Dónde se colocan controladores, modelos, vistas y migraciones.
- Seguridad por Defecto: Requerir sentencias preparadas, escape en HTML y tipado estricto.
⚡ Archivo .cursorrules de Producción para un Proyecto Web Fullstack
Plantilla lista para usar en la raíz de tu repositorio que adiestra a la IA sobre las convenciones de Kilopolis Academia.
# Reglas Oficiales de Desarrollo de Kilopolis (.cursorrules)
## 1. Stack Tecnológico del Proyecto
- Lenguaje Backend: PHP 8.3 con `declare(strict_types=1);` obligatorio en la línea 2 de cada archivo.
- Lenguaje Frontend: JavaScript ES2022 moderno (Vanilla), sin transpiladores pesados.
- Framework CSS: Bootstrap 5.3 (utilizar clases utilitarias nativas).
- Base de Datos: MySQL 8.0 vía PDO con sentencias preparadas.
## 2. Restricciones y Librerías Prohibidas
- ❌ PROHIBIDO usar jQuery o librerías heredadas (`$`, `$.ajax`).
- ❌ PROHIBIDO concatenar variables en consultas SQL. Usa siempre marcadores `:param` o `?`.
- ❌ PROHIBIDO usar `eval()` o `innerHTML` con datos provenientes de inputs o URLs sin sanitizar.
## 3. Convenciones de Código y Estilo
- En PHP: Seguir estándar PSR-12. Nombres de clases en `PascalCase`, métodos en `camelCase`.
- Retorno de vistas: Usar siempre el helper `e($variable)` para escapar HTML antes de imprimir.
- Respuestas de API: Devolver siempre JSON con cabecera `Content-Type: application/json` y claves `success`, `data` y `error`.
## 4. Política de Edición de Archivos
- No elimines comentarios explicativos ni licencias de archivos existentes.
- Provee código completo o bloques delimitados claramente; nunca dejes marcadores vagos como `// ... resto del código igual`.Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cuál es la función del archivo .cursorrules o copilot-instructions.md en un repositorio de código?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar IA como Copiloto: Aprendizaje & Desarrollo Web y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.
🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.