PTENES
Playbook + CLI · Claude Code × Codex

Un cerebro, dos agentes

Usa el mismo segundo cerebro con Claude Code y Codex: el agente y el modelo adecuados para cada tarea, manuales y skills siempre iguales, uso registrado. Bash puro, sin dependencias.

Un cerebro con luz ámbar conectado por haces a dos terminales de computadora
Qué es

El mismo cerebro, sin convertirse en dos

Tu segundo cerebro (la carpeta Markdown del kit astra-2cerebro) puede ser leído por Claude Code y Codex. Cada uno entra por una puerta diferente: CLAUDE.md e .claude/skills de un lado, AGENTS.md e .agents/skills en el otro. cerebro-duplo mantiene iguales las interfaces y decide cuál usar.

🪞 Paridad

duplo.sh verificar comprueba que AGENTS.md = CLAUDE.md, que cada skill está reflejada byte por byte y que cada una tiene el openai.yaml de Codex. sync lo corrige. La skill duplo-verificar informa y propone, sin hacer cambios por sí sola.

🧭 Enrutamiento

La skill qual-agente lee la solicitud, elige agente + modelo + esfuerzo con una tabla (MCP configurado, repo abierto, razonamiento pesado, tarea rutinaria barata) y devuelve el comando. Los perfiles .env guardan el modelo y el esfuerzo por tipo de tarea.

📒 Uso y cuota

uso registrar anota cada sesión en registro-uso.md; uso resumo suma por agente y perfil. Sin inventar precios: aquí, minutos y sesiones; el dinero, en la tabla del proveedor.

Cómo funciona

Del pedido al registro

Un ciclo corto, repetido en cada sesión. Las flags de modelo y esfuerzo son las reales de ambos CLI (leídas de --help): --model/--effort en Claude Code, -m/-c model_reasoning_effort en Codex.

solicitud→ /qual-agente o $qual-agente→ agente + perfil→ duplo.sh claude|codex <perfil>→ trabajo en el cerebro→ duplo.sh sync→ duplo.sh uso registrar
1

Enrutar

MCP específico → el agente que lo tiene. Código → donde está abierto el repo. Auditoría, arquitectura, wiki extensa → raciocinio. Buscar, resumir, redactar → rotina.

2

Abrir

duplo.sh claude raciocinio imprime y ejecuta cd cérebro && claude --model fable --effort high. --so-mostrar solo imprime.

3

Sincronizar

¿Editaste el manual o una skill? sync vuelve a generar el espejo a partir del canónico (AGENTS.md, .claude/skills). Nunca borra; avisa.

4

Registrar

Una línea por sesión: agente, perfil, modelo, esfuerzo, minutos, tarea. El jueves, uso resumo indica dónde se fue la cuota.

Requisitos previos

Lo que debe existir

Un cerebro de astra-2cerebro y bash. Los agentes solo son necesarios al abrir una sesión.

Un cerebro

Carpeta creada por el kit astra-2cerebro, con AGENTS.md, CLAUDE.md, .claude/skills/ e .agents/skills/.

# si todavía no tienes
git clone https://github.com/inematds/astra-2cerebro.git
# sigue el INSTALAR.md del kit

bash + coreutils

Linux, macOS, Git Bash o WSL. diff, awk, cp. Nada de Node, Python ni paquetes.

bash --version   # 4+
diff --version
awk --version

Claude Code y/o Codex

Opcionales. verificar, sync e uso funcionan sin ninguno de los dos.

claude --version   # probado: 2.1.263
codex --version    # probado: 0.153.3
Guía de uso · paso a paso

Instalar, verificar, enrutar, registrar

Comandos reales. Reemplaza ~/meu-cerebro por la carpeta de tu cerebro.

1

Instalar en el cerebro

Clona el repo y copia las dos skills en .claude/skills e .agents/skills, e o duplo.sh (con perfis/ e modelos/) para scripts/. Ejecuta el verificar al final.

git clone https://github.com/inematds/cerebro-duplo.git
cd cerebro-duplo
bash instalar.sh ~/meu-cerebro
2

Verificar la paridad

Manual idéntico, skills sincronizadas, openai.yaml presente, rutas del manual válidas. Código 1 si hay un PROBLEMA; una ruta rota es solo una ADVERTENCIA (el /iniciar crea varios archivos después).

cd ~/meu-cerebro
bash scripts/duplo.sh verificar
# OK: AGENTS.md y CLAUDE.md son idénticos
# OK: 10 skills idénticas en ambos lados
# == resultado: 0 problema(s), 6 aviso(s)
3

Ajustar los perfiles a tu plan

Los nombres de modelo que vienen en el repo son los de esta máquina. Edita scripts/perfis/*.env. Fuentes confiables: claude --help (aliases fable, opus, sonnet; esfuerzo low…max) y tu ~/.codex/config.toml.

bash scripts/duplo.sh perfis
#   codigo       claude: claude-opus-5-5/high     codex: gpt-6-astra/high
#   predeterminado       claude: sonnet/medium  codex: gpt-6-astra/medium
#   razonamiento   claude: claude-opus-5-5/high   codex: gpt-6-astra/high
#   rutina       claude: sonnet/low     codex: gpt-6-astra/low
nano scripts/perfis/padrao.env
4

Preguntar qué agente usar

En cualquier sesión. La skill responde en cuatro líneas: agente · perfil · modelo/esfuerzo, dos motivos, el comando y la línea de registro para el final.

# en Claude Code
/qual-agente preciso auditar o cérebro, faz um mês que não rodo
# en Codex
$qual-agente preciso auditar o cérebro, faz um mês que não rodo

# respuesta típica:
# codex · raciocinio · gpt-6-astra/high
# La auditoría requiere un razonamiento intenso: un modelo barato infla la calificación.
# Codex porque Claude Code ya consumió más cuota esta semana.
# bash scripts/duplo.sh codex raciocinio
# al cerrar: bash scripts/duplo.sh uso registrar codex raciocinio 25 "auditoria mensual"
5

Abrir el agente con el perfil

El script imprime el comando antes de ejecutarlo. Con --so-mostrar solo imprime (útil para revisar las flags sin gastar cuota).

bash scripts/duplo.sh claude raciocinio --so-mostrar
# comando: cd ~/meu-cerebro && claude --model fable --effort high --name duplo:raciocinio

bash scripts/duplo.sh codex rotina --so-mostrar
# comando: codex -C ~/meu-cerebro -m gpt-6-astra -c model_reasoning_effort=\"low\"

bash scripts/duplo.sh codex raciocinio      # se abre de verdad
6

Sincronizar después de editar

Edita siempre el canónico (AGENTS.md, .claude/skills/...). O sync vuelve a generar el otro lado. --fonte claude invierte el sentido del manual cuando la edición buena está en el CLAUDE.md.

bash scripts/duplo.sh sync                  # AGENTS.md → CLAUDE.md; .claude/skills → .agents/skills
bash scripts/duplo.sh sync --fonte claude   # CLAUDE.md → AGENTS.md
bash scripts/duplo.sh verificar             # 0 problema(s)
7

Registrar el uso y leer el resumen

Una línea por sesión en registro-uso.md (creado a partir de la plantilla la primera vez). El resumen es lo que alimenta la regla de cuota: si la semana está apretada, se baja un nivel o se cambia de agente.

bash scripts/duplo.sh uso registrar codex raciocinio 25 "auditoria mensal"
bash scripts/duplo.sh uso registrar claude rotina 8 "resumo reunião 06/09"
bash scripts/duplo.sh uso resumo
# | Agente | Sesiones | Minutos |
# | claude | 1 | 8 |
# | codex  | 1 | 25 |
# total: 2 sesiones, 33 minutos
8

Informe de paridad del agente

La skill duplo-verificar ejecuta el verificar y convierte la salida en un informe breve con una corrección por elemento. No corrige por sí sola: termina preguntando si puede aplicar los cambios.

/duplo-verificar       # Claude Code
$duplo-verificar       # Codex

Tabla de enrutamiento (resumen)

La versión completa, con justificaciones y reglas de cuota, está en docs/roteamento.md.

TareaAgentePerfil
Usa un MCP específico (calendario, correo electrónico, navegador)lo que tiene el MCP configuradopadrao
Código extenso, refactorización, script de conexióndónde el repo ya está abiertocodigo
Auditoría, arquitectura, decisión difícil, wiki extensacualquiera (con más cuota disponible)raciocinio
Encontrar un documento, resumir una reunión, redactar un correocualquierarotina
Entrevista, conversación de descubrimientocon quien prefieres conversarpadrao
Rutina programada, sin supervisiónlo que ya tiene la programaciónrotina
Ejemplos

Resultados reales

Capturadas en esta máquina contra test/fixture, un cerebro pequeño del kit.

Paridad rota y reparada

Una línea más en el CLAUDE.md y una skill editada solo en el espejo.

$ duplo.sh --dir cerebro verificar
PROBLEMA: AGENTS.md e CLAUDE.md divergem (diff abaixo)
    +- linha só no CLAUDE.md
PROBLEMA: skill 'rotina' difere entre .claude/skills e .agents/skills:
    Files .claude/skills/rotina/SKILL.md and .agents/skills/rotina/SKILL.md differ
== resultado: 2 problema(s), 6 aviso(s)

$ duplo.sh --dir cerebro sync
manual: CLAUDE.md gravado a partir de AGENTS.md
skills: 1 sincronizada(s) .claude/skills -> .agents/skills

$ duplo.sh --dir cerebro verificar
OK: AGENTS.md e CLAUDE.md são idênticos
OK: 8 skills idênticas nos dois lados
== resultado: 0 problema(s), 6 aviso(s)

Pruebas

bash test/testes.sh: 38 aserciones que cubren verificar, sync, uso, perfiles e instalador.

PASS: verificar passa na fixture íntegra
PASS: verificar falha quando AGENTS.md e CLAUDE.md divergem
PASS: sync conserta o manual a partir de AGENTS.md
PASS: verificar acusa skill sem cópia no espelho
PASS: sync não apaga skill só no espelho
PASS: uso resumo soma por agente (claude 2 sessões, 45 min)
PASS: claude --so-mostrar imprime cd + claude --model --effort
PASS: codex --so-mostrar imprime codex -C -m -c model_reasoning_effort
PASS: duplo.sh instalado verifica o cérebro com as 10 skills
...
== resultado: 38 passaram, 0 falharam
Roadmap

Lo que existe y lo que viene

La versión 1.0.0 cierra el ciclo verificar → enrutar → registrar. El resto es opcional y depende del uso real.

1.0.0
Ciclo completo (hecho)duplo.sh con verificar, sync, claude/codex por perfil, uso; skills qual-agente e duplo-verificar; 4 perfiles; instalador; 38 pruebas; 6 documentos.
siguiente
Hook de pre-commit listoScript opcional que instala el verificar como pre-commit en el cerebro versionado (hoy es un fragmento en docs/paridade.md).
siguiente
Tercer agenteBloque DUPLO_<AGENTE>_* en los perfiles y cmd_<agente> en el script para cualquier runtime que lea AGENTS.md (la ruta está en docs/migracao.md).
idea
Resumen semanal como rutinaUna /rotina del kit que ejecuta uso resumo cada viernes y anota la lectura en rotinas/registro.md.