Escribir reglas de cursor que hagan que la IA se comporte en una base de código antigua
Los asistentes de codificación de IA se portan mal en proyectos heredados porque no conocen sus limitaciones. Un breve archivo de reglas solucionó la mitad de mis diferencias erróneas.
Mi primera semana de desarrollo impulsado por agentes en nuestra base de código de cuatro años produjo un código hermoso que violó tres convenciones del equipo y una decisión arquitectónica por la que habíamos peleado durante meses. La solución no fue una mejor indicación; estaba escribiendo la constitución.
Un buen expediente de reglas es breve y negativo. El mío enumera lo que el código base nunca debe hacer: no hay nuevas bibliotecas de administración de estado, las fechas son dayjs, no Date, cada ruta API se valida con los esquemas zod existentes y nunca toca archivos bajo legado/ sin preguntar. Las limitaciones, no las aspiraciones, son las que cambian el comportamiento del modelo.
La victoria inesperada fue documentar el por qué de cada regla en una cláusula. El modelo que sabe que las migraciones fracasaron el último trimestre escribe un código de migración más cauteloso que el que simplemente dice que tengan cuidado. El contexto convierte las reglas de obedecidas a comprendidas, y las reglas comprendidas se generalizan a casos que no enumeraste.
Mantenga un segundo archivo de reglas por directorio para las convenciones locales, mi carpeta de componentes tiene la suya propia y resista la tentación de inflar el archivo global. Reduje mi primer borrador de cuarenta líneas a doce y las diferencias mejoraron, porque cada línea que agregas diluye las que importan.
Seis semanas después, el resultado medible: las diferencias que violaban las convenciones se redujeron de aproximadamente una de cada tres a raramente, y los comentarios de revisión de código pasaron del estilo a la lógica. El archivo de reglas es el ingeniero senior más barato que he contratado.