Una fuente de verdad, tres harnesses que la leen

Ningún nombre de archivo lo descubren los tres

Claude Code carga CLAUDE.md. OpenCode y Codex cargan AGENTS.md. Mantener dos documentos completos y compararlos en CI no elimina el drift: lo detecta tarde, después de que alguien ya trabajó con la copia vieja.

Por eso la relación se invirtió. AGENTS.md es el único cuerpo de instrucciones y CLAUDE.md quedó en once bytes. Ese @ es la sintaxis de import documentada de Claude Code: trae el archivo al contexto de la sesión. Se eligió por encima de un symlink justamente porque un checkout de Windows lo trata igual que uno de macOS o Linux.

Claude Code OpenCode Codex artefacto generado

# CLAUDE.md — el archivo entero, sin recortar
@AGENTS.md

Qué consume cada harness, superficie por superficie

Cinco superficies por tres harnesses. Lo marcado como nativo lo descubre el harness por su cuenta; lo marcado como generado es salida de un script y no se edita a mano.

Lo generado nunca se edita a mano ni se commitea

Hay un solo store de skills, .agents/skills/, versionado, con las 19 skills adentro. Todo lo demás que un harness necesita ver son punteros hacia ahí. Si un puntero se rompe, se regenera; nunca se parchea.

Los slash commands son transporte, no workflow

Antes cada comando llevaba el workflow entero escrito adentro. adapt-framework solo tenía 590 líneas. Eso era instrucción duplicada que ningún harness fuera de Claude podía descubrir, y que se desincronizaba de su skill en cuanto alguien editaba una de las dos copias.

Los diez nombres sobreviven como alias. El wrapper solo selecciona skill y modo, y reenvía $ARGUMENTS sin tocarlo. Este es un archivo completo, no un fragmento:

# .claude/commands/business-data-map.md — las 7 líneas, enteras
---
description: Generate or refresh the business data and flow map.
argument-hint: [project-path]
---

Invoke skill `project-context` in mode `data`.
Forward `$ARGUMENTS` unchanged.

Un emisor, tres adaptadores

El contrato de personalidad que se reinyecta en cada prompt vive una sola vez, en .agents/hooks/personality-reinject.mjs. El archivo exporta la constante y además la escribe a stdout cuando se lo ejecuta como script. Esas dos formas de consumirlo son las que necesitan los tres harnesses.

El validador de contrato rechaza, con nombre y línea:

• Rutas absolutas personales dentro de cualquier comando de hook, que romperían en la máquina de cualquier otra persona.
• Un emisor compartido que trate CLAUDE.md como el archivo canónico, que es exactamente la inversión que este release deshizo.
• Un plugin de OpenCode que reemplace output.system en vez de mutarlo, lo que descartaría el system prompt del harness.
• La reaparición de los archivos de hook duplicados que se eliminaron.

El adaptador de Codex además carga commandWindows para PowerShell y resuelve la raíz del repositorio con git rev-parse --show-toplevel, en vez de asumir el directorio de trabajo.

Seis servidores, tres formatos, paridad semántica

Los seis servidores canónicos existen en las tres configuraciones. La comparación no puede ser textual: los archivos ni siquiera comparten lenguaje.

Si venís de la versión anterior

Un proyecto creado cuando las instrucciones vivían en CLAUDE.md y las skills en .claude/skills/ recibe una migración preflight la primera vez que corre bun run up — antes de que se sincronice un solo componente, porque sincronizar primero sobre una estructura vieja es exactamente cómo se pierde trabajo.

Lo que todavía no está cerrado

Cuatro cosas que conviene saber antes de apoyarse en esto, dichas como límites y no como notas al pie.

• El adaptador de OpenCode usa experimental.chat.system.transform. Es una API oficial, pero marcada como experimental por el proyecto. Claude y Codex están sobre APIs de hook estables. Hay que re-verificar al actualizar OpenCode.
• El junction de Windows está cubierto por tests unitarios de construcción de ruta y de comando. La verificación en una máquina Windows real sigue pendiente.
• Codex necesita que el repositorio esté marcado como confiable. La configuración de proyecto bajo .codex/ y sus hooks no cargan si no lo está. bun run setup:doctor reporta esa confianza por separado de la corrección de los archivos, porque es estado de runtime que no se puede verificar leyendo el disco.
• Lanzá siempre con bun run claude, bun run opencode o bun run codex. Cada uno pasa por dotenv -o, que fuerza que .env gane sobre una variable heredada del proceso padre. Ejecutar el binario pelado se saltea eso y puede dejar un valor viejo tapando el del archivo.