Guía para Marcos · Codex + HAZ LO TUYO

Codex no es un chat. Es un taller.

Una explicación clara de cómo funcionan los proyectos en Codex y qué estamos construyendo nosotros: un sistema creativo para convertir ideas, archivos y procesos en entregables reales.

01 · Qué es Codex

Un agente que trabaja dentro de tus archivos.

Codex es el agente de OpenAI pensado para ayudar a escribir, revisar y publicar código. Pero usado con cabeza no sirve solo para “programar”: también sirve para construir sistemas de trabajo, guías, automatizaciones, webs, HTMLs, scripts y documentación.

1

Lee contexto

Puede mirar carpetas, documentos, scripts, instrucciones y resultados anteriores para entender qué hay montado.

2

Propone cambios

No solo responde con texto: puede crear archivos, editar código, preparar estructuras y dejar cambios revisables.

3

Ejecuta pruebas

Puede correr comandos, validar salidas, detectar errores y corregirlos. No es fe ciega: se revisa y se prueba.

La clave no es pedirle “hazme algo”. La clave es darle contexto, reglas y un objetivo verificable.

02 · Qué es un proyecto en Codex

Una carpeta con memoria, reglas y herramientas.

Un proyecto no es una conversación suelta. Es una zona de trabajo donde viven los archivos, las instrucciones, los scripts, las pruebas y las salidas. Codex trabaja dentro de ese contexto.

Chat normal

  • Sirve para pensar: ideas, textos, estrategia, prompts, dudas.
  • Depende del mensaje: si no le das contexto, improvisa más.
  • Entrega principalmente texto: útil, pero no siempre ejecutable.

Proyecto en Codex

  • Sirve para construir: archivos, HTML, scripts, docs, herramientas.
  • Depende de una carpeta: lee lo que ya existe y trabaja encima.
  • Entrega cambios: resultados que se pueden abrir, probar y guardar.
Instrucciones
Documentos tipo AGENTS.md, design.md o guías internas que dicen cómo debe trabajar el proyecto.
Entradas
PDFs, webs, imágenes, textos, capturas, briefs o datos que queremos transformar.
Herramientas
Scripts, paquetes, comandos y pequeños programas que convierten entradas en salidas.
Salidas
HTMLs, Markdown, ZIPs, informes, guías, assets, carpetas finales o documentación para usar.
Validación
Tests, revisiones, checklist de calidad y comprobación humana. Codex acelera, pero el criterio manda.
03 · Qué estamos haciendo nosotros

Estamos creando un sistema operativo creativo.

La idea no es hacer piezas sueltas. Es construir una infraestructura propia para HAZ LO TUYO: un conjunto de carpetas, reglas, agentes, skills y herramientas que repiten procesos con coherencia.

HLT Agency OS

Sistema para analizar marcas, webs, perfiles o casos y convertirlos en diagnósticos, documentos internos, previews para cliente y materiales reutilizables.

HLT Academia OS

Sistema para transformar fuentes, PDFs o Markdown en guías HTML claras, educativas y con estética HLT. Menos PDF muerto. Más guía útil.

HLT Análisis

Base para leer material, ordenar evidencias, separar hechos de interpretación y generar informes, infografías o dossiers con prudencia.

Herramientas propias

Scripts y mini apps para automatizar tareas repetibles: construir casos, procesar fuentes, generar HTML, validar estructura o empaquetar salidas.

IA aplicada Dirección visual Automatización Documentación HTMLs Prompts Sistemas reutilizables
04 · Anatomía de una carpeta

Lo importante es que cada cosa tenga su sitio.

Una estructura clara hace que Codex no vaya a ciegas. Si todo está ordenado, el proyecto se vuelve repetible: entra material, se procesa, se revisa y sale algo usable.

HLT_AGENCY_OS/
├─ AGENTS.md                  # Reglas de cómo debe trabajar Codex
├─ design.md                  # Estilo visual y editorial del proyecto
├─ inbox/                     # Fuentes que entran: PDFs, webs, capturas, textos
├─ docs/                      # Documentación del sistema
├─ skills/                    # Habilidades reutilizables del agente
├─ tools/                     # Herramientas y scripts propios
│  └─ hlt-case-builder/       # Ejemplo: constructor de casos
├─ output/                    # Resultados generados
│  ├─ html/                   # Guías, previews, páginas
│  ├─ markdown/               # Documentos editables
│  └─ final_cases/            # Carpetas finales preparadas
└─ README.md                  # Cómo se usa el proyecto
05 · Flujo real de trabajo

Entrada → criterio → producción → revisión.

El flujo bueno no consiste en “tirarle prompts”. Consiste en definir qué entra, qué se quiere conseguir, qué puede hacer la IA, qué debe decidir una persona y cómo se comprueba que la salida sirve.

01EntradaBrief, web, PDF, imagen, carpeta, idea o problema.
02DiagnósticoQué hay, qué falta, qué falla, qué oportunidad existe.
03DirecciónFormato, tono, estilo, estructura y resultado esperado.
04ProducciónCodex crea archivos, HTML, Markdown, scripts o assets.
05RevisiónTests, lectura, coherencia, calidad y utilidad real.
06EntregaCarpeta final, ZIP, guía, preview, prompt o sistema reutilizable.

La IA acelera la producción. El criterio decide si aquello merece existir.

06 · Ejemplo explicado fácil

De una web a un caso presentable.

Imagina que queremos analizar una marca. Antes lo haríamos a mano: abrir web, tomar notas, ordenar capturas, escribir diagnóstico, preparar documentos y montar una preview. Ahora intentamos convertir eso en un sistema.

1

Capturamos

La web, textos, estructura, imágenes o referencias de la marca.

2

Ordenamos

Codex separa contenido, secciones, hallazgos, problemas y oportunidades.

3

Generamos

HTML interno, Markdown editable, preview cliente y carpeta de salida.

4

Revisamos

Miramos si tiene sentido, si suena HLT, si sirve y si no hay humo.

07 · Reparto de papeles

Codex no sustituye el criterio. Lo multiplica.

Codex hace bien

  • Crear estructura de carpetas y archivos.
  • Escribir y modificar código.
  • Convertir datos en HTML o Markdown.
  • Ejecutar comandos y tests.
  • Documentar procesos repetibles.
  • Detectar errores técnicos.

Nosotros decidimos

  • Qué problema merece resolverse.
  • Qué tono y enfoque tiene sentido.
  • Qué es útil y qué es solo ruido.
  • Qué se enseña, qué se descarta y qué se mejora.
  • Si el resultado encaja con HAZ LO TUYO.
  • Cuándo parar. Bastante importante, por cierto.
08 · Glosario para no marearse

Palabras raras, traducción humana.

Proyecto
La carpeta de trabajo con sus archivos, reglas y salidas.
Repo
Repositorio. Una carpeta controlada con historial de cambios. La carpeta seria, vaya.
Commit
Guardar un punto de avance para poder volver atrás o saber qué se cambió.
Diff
La comparación entre lo que había antes y lo que Codex ha cambiado.
Build
Generar una versión final: una web, un HTML, una carpeta compilada o un paquete listo.
Test
Comprobación automática para ver si algo funciona o si se ha roto.
Skill
Una habilidad reutilizable: instrucciones, recursos y a veces scripts para que Codex repita un proceso mejor.
AGENTS.md
El documento de normas de la casa: cómo debe comportarse el agente dentro del proyecto.
Output
La carpeta donde salen los resultados finales o intermedios.
09 · Lo que hay que evitar

El peligro no es la IA. Es trabajar sin método.

Pedir sin contexto

Si la instrucción es vaga, el resultado suele ser genérico. Basura elegante sigue siendo basura.

No revisar

Codex puede equivocarse. Todo lo importante se abre, se lee, se prueba y se valida.

No documentar

Si algo funciona y no se documenta, se pierde. Si se documenta, se convierte en sistema.

10 · Explicación corta para Marcos

Para contarlo en 30 segundos.

“Estamos usando Codex como un taller de producción. No es solo preguntarle cosas a una IA. Le damos una carpeta con instrucciones, archivos y reglas; Codex crea herramientas, documentos, HTMLs y pruebas; y nosotros revisamos con criterio. La idea es convertir procesos creativos repetibles en sistemas propios para HAZ LO TUYO.”

Versión todavía más corta: ChatGPT nos ayuda a pensar. Codex nos ayuda a construir.