¿Cómo logras que un asistente de IA siga las convenciones de codificación de tu proyecto?

Question

IT Interview Practice · Accepted Answer

Una IA se ajusta por defecto a un promedio genérico de sus datos de entrenamiento, así que para obtener **tu** estilo tienes que **mostrar y reforzar** — a través de ejemplos, un archivo de reglas explícito, y un ciclo de linter que atrape lo que se escape. No confíes en que adivine tus estándares (WordPress Coding Standards, PSR-12, etc.).

## Técnicas (en orden de impacto)

- **Proporciona la configuración del linter y ejemplos** — pega tu `.eslintrc`, `phpcs.xml`, o `.editorconfig`. Estas son las reglas en forma comprobable por máquina, y la IA puede leerlas.
- **Mantén un archivo de reglas/instrucciones** — un `CLAUDE.md` o prompt del sistema que establezca el estándar explícitamente: "Este proyecto sigue **PSR-12**. Usa indentación de 4 espacios, llaves en la siguiente línea para funciones, snake_case para hooks." Las instrucciones permanentes superan repetirte a ti mismo en cada prompt.
- **Muestra código representativo existente** — uno o dos archivos limpios enseñan nombres, estructura e idiomas más rápido que cualquier descripción. La IA busca patrones en lo que ve.
- **Ejecuta el linter en el resultado de la IA y devuelve los errores** — el paso más confiable. El linter es la fuente de verdad; pega sus errores y pídele a la IA que los corrija.

## El ciclo del linter

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Este ciclo converge rápido porque el linter proporciona retroalimentación precisa a nivel de línea que la IA puede actuar directamente, en lugar de que tú describas el estilo en prosa.

## Por qué es importante

El código que ignora las convenciones del proyecto crea **fricción de revisión e inconsistencia** incluso cuando es funcionalmente correcto — los revisores pierden tiempo en formato, y la base de código se desvía. Una IA no tiene conciencia de tu estilo de casa a menos que lo suministres, así que el trabajo es hacer que las reglas sean **explícitas y comprobables**: un archivo de reglas para la intención, código representativo para los idiomas, y el linter como el ejecutor en el ciclo. La misma disciplina (configuración + ejemplos + comprobación automatizada) es cómo incorporas a un compañero humano a tus convenciones, también.

Técnicas (en orden de impacto)

El ciclo del linter

Por qué es importante

Preguntas relacionadas