Tu repo debe explicarle al agente de IA por qué el código es así, no solo qué hace
Ten harness patterns that you can apply to a real repo
El equipo de deepsense.ai ganó un hackathon de OpenAI Codex con HyperCode y ahora comparte su playbook de diez patrones de harness para agentes de programación. La idea central: el modelo solo ve el código, no las decisiones que lo moldearon. Un AGENTS.md breve en la raíz, mensajes de commit que expliquen el porqué y tests con docstrings que documenten qué protegen convierten el repo en una base de conocimiento legible para el agente.
Tu asistente de programación puede leer tu código. Lo que no puede inferir por su cuenta es por qué el código está estructurado como está, qué compromisos se hicieron, qué abstracciones son intencionales y qué partes son minas terrestres heredadas.