Llevo dos años y medio practicando programación con IA, comparto tres prompts de nivel superior imprescindibles, ¡y sugiero añadirlos manualmente sin importar la herramienta de desarrollo!

En dos años y medio utilizando IA para asistir en la programación, he probado varios asistentes de código de IA (como Codex, Cursor, Windsurf, etc.) y he pasado por el proceso de adaptación desde "la IA escribe código incorrecto" hasta "colaboración eficiente entre humanos y máquinas".

En el desarrollo real, el mayor punto débil de la IA a menudo no es que no pueda escribir código, sino que **la documentación está desordenada, los planes de diseño desaparecen en un instante y no se puede rastrear qué código se ha modificado**. Para que la IA se comporte y mantenga una estructura de ingeniería extremadamente rigurosa en el directorio raíz del proyecto, he resumido **tres indicaciones de nivel superior (System Prompt / Instructions) esenciales**.

¡Sugiero que todos agreguen estas indicaciones manualmente a sus instrucciones personalizadas a nivel de usuario, independientemente de la herramienta de desarrollo que utilicen!


### 1: Documentación General

La IA a menudo genera instrucciones como configuración del entorno, pasos de implementación, guías de llamada a API, etc., según nuestras solicitudes. Si no se restringe, se imprimen directamente en la ventana de chat y son difíciles de encontrar, o se colocan al azar en el directorio raíz del proyecto. Esta indicación obliga a la IA a unificar toda la documentación de orientación, creando una biblioteca de activos `docs` de nivel de cuidador para el proyecto.

**Indicación en inglés:**

> If I ask you to provide some instructions or guides, please save them to the "docs" folder in the root directory.

**Traducción al español:**

> Si te pido que proporciones algunas instrucciones o guías, por favor, guárdalas en la carpeta "docs" del directorio raíz.


### 2: Documentación de Diseño

Antes de empezar a escribir código, los buenos desarrolladores primero realizan el diseño de la arquitectura y la revisión de los planes. Al hacer que la IA genere planes de diseño (Design Proposal), necesitamos solidificarlos en documentos para facilitar la verificación posterior o la colaboración en equipo. Esta indicación asegura que todos los pensamientos de diseño central, el diseño del esquema de la base de datos, las definiciones de interfaz, etc., sean rastreables.

**Indicación en inglés:**

> If I ask you to provide some design proposal documents, please save them to the "design" folder in the root directory.

**Traducción al español:**

> Si te pido que proporciones algunos documentos de propuesta de diseño, por favor, guárdalos en la carpeta "design" del directorio raíz.


### 3: Registro de Cambios

¡Esta es la que más me ha beneficiado después de usar IA intensivamente para programar! La IA modifica el código extremadamente rápido, a veces modificando varios archivos en secuencia, y luego uno olvida qué lógica ha cambiado. Esta instrucción exige que la IA genere automáticamente registros de cambios numerados en orden cronológico en el directorio `changelog` después de cada modificación de código (por ejemplo, `001-fix-auth-bug.md`). Esto no solo hace que la evolución del proyecto sea clara de un vistazo, sino que también sirve como una referencia perfecta para la revisión y reversión cuando la IA ocasionalmente "se equivoca".

**Indicación en inglés:**

> Each time code is modified, a new document is created to record the changes in chronological order. Filenames begin with a sort number for easy organization. These documents are saved to the `changelog` folder in the root directory.

**Traducción al español:**

> Cada vez que se modifica el código, se crea un nuevo documento para registrar los cambios en orden cronológico. Los nombres de archivo comienzan con un número de orden para facilitar la organización. Estos documentos se guardan en la carpeta `changelog` del directorio raíz.


### ¿Cómo usarlos?

**Cursor**: Ve a `Settings -> Features`, e introduce directamente **`Rules for AI`**.

**Claude Code**: Modifica **`~/.clauderc`** en tu directorio de usuario (o configura instrucciones globales a través del comando `claude config set`).

**Windsurf**: Ve a `Settings`, busca e introduce **`Global Rules for AI`**.

**Claude Code**: Modifica **`~/.claude/settings.json`** en tu directorio de usuario (añadiendo al campo `globalInstructions`), o crea un **`~/.claude/CLAUDE.md`** global en el directorio raíz.

**Plugins universales de VS Code (como Continue)**: Abre el `settings.json` global, modifica el campo **`systemPrompt`** del plugin correspondiente.

### Conclusión

Mi experiencia de dos años programando con IA me dice: **es mejor tratar a la IA como un "desarrollador junior que necesita estrictas regulaciones" que como un programador**. Las indicaciones de nivel superior excelentes son la especificación final del proyecto; no necesitas hablar mucho, la IA puede gestionar la documentación, el diseño y los registros del proyecto de manera ordenada por sí sola. ¡Añádelas a tu herramienta de desarrollo ahora!