🛠️ Codex Prompts

Colección de prompts reutilizables para trabajar con Codex (o agentes de código) de forma consistente, controlada y con menos errores.

---

🎯 Objetivo

Estos prompts están pensados para:

• reducir errores al modificar código
• evitar cambios innecesarios o fuera de alcance
• mantener diffs claros y revisables
• mejorar la calidad de las respuestas de Codex
• separar claramente pensamiento vs ejecución

---

📦 Contenido

Archivo	Uso
base.md	Cambios generales
bug-fix.md	Corrección de errores
ux-improvement.md	Mejoras de UX o features
refactor-safe.md	Limpieza / refactor controlado
analysis-only.md	Análisis sin modificar código
change-block.md	Cambios en múltiples métodos
validation.md	Validación posterior
example.md	Ejemplo adaptable

---

🚀 Cómo usar

1. Elegí el prompt según el tipo de tarea
2. Completá los campos (Objetivo, Archivos, etc.)
3. Pegalo en Codex
4. Revisá el diff antes de aceptar cambios

---

🔁 Workflow recomendado

Definir problema → (Chat / pensamiento)
↓
Elegir prompt
↓
Completar prompt
↓
Codex implementa
↓
Revisar diff
↓
Probar en entorno real
↓
Commit

---

🧠 Principios clave

1. Cambios acotados

“Hacer solo los cambios necesarios”

Evita que el agente:

• modifique archivos no relacionados
• introduzca refactors inesperados

---

2. Un objetivo por vez

❌ Evitar:

• arreglar bug + refactor + feature en un mismo pedido

✔️ Preferir:

• un problema → un prompt → un commit

---

3. Revisar siempre el diff

Nunca asumir que el resultado es perfecto.

Revisar:

• nombres
• imports
• consistencia
• código inesperado

---

4. No delegar decisiones importantes

Usar Codex para:

• ejecutar cambios
• explorar código
• refactor controlado

No para:

• decisiones de arquitectura
• diseño de producto
• prioridades

---

5. Preferir cambios en bloque

Si el cambio afecta varias funciones:

pedir métodos completos consistentes

Evita errores como:

• variables inexistentes
• helpers faltantes
• firmas inconsistentes

---

🧩 Ejemplos de uso

🐛 Ejemplo: Bug

Problema:
La función no valida correctamente inputs nulos.

Archivo:
- src/utils/validator.js

Comportamiento actual:
Se rompe cuando recibe undefined

Comportamiento esperado:
Debe ignorar o manejar valores nulos

→ usar bug-fix.md

---

✨ Ejemplo: Mejora UX

Objetivo:
Mejorar feedback visual en hover

Archivo:
- src/components/Button.js

→ usar ux-improvement.md

---

🔍 Ejemplo: Análisis

Analizar:
- src/services/api.js

Quiero saber:
- dónde se hacen las llamadas HTTP
- qué funciones dependen de ellas

→ usar analysis-only.md

---

⚠️ Antipatrón a evitar

Copiar código manualmente
Editar partes sueltas
Arreglar errores uno por uno

Esto suele generar:

• inconsistencias
• bugs silenciosos
• pérdida de tiempo

---

✅ Buen patrón

Definir bien el cambio
↓
Usar prompt claro
↓
Dejar que Codex modifique
↓
Revisar diff

---

🧪 Validación rápida antes de commit

Checklist mental:

• ¿El cambio cumple el objetivo?
• ¿Hay referencias rotas?
• ¿Se tocaron archivos innecesarios?
• ¿El comportamiento no relacionado sigue igual?

---

🧭 Filosofía

Estos prompts no buscan que Codex “piense por vos”, sino que:

👉 ejecute mejor lo que ya decidiste

---

📌 Recomendaciones

• Guardar estos prompts como snippets
• Adaptarlos a tu estilo de código
• Usarlos de forma consistente
• Iterarlos con el tiempo

---

🚀 Futuro

Podés extender este repo con:

• ejemplos reales antes/después
• prompts por lenguaje (JS, PHP, Python)
• prompts para testing
• prompts para documentación

---

🤝 Contribuciones

Si encontrás mejoras o variantes útiles:

• agregalas como nuevos prompts
• documentá casos reales
• mantené los cambios simples y reutilizables

---

🧠 TL;DR

Pensá primero. Usá prompts claros. Revisá siempre el diff. Hacé commits chicos.

---