🔌 Proyecto 2: MCP y hooks entre Claude y Codex

Objetivo: reproducir el inventario en tu máquina antes de cambiar cualquier cosa, para tener una línea de base.

# MCP que Claude ve (global + por proyecto)
claude mcp list
# esperado en esta máquina: magnific, metricool

# los MCP por proyecto están en el .mcp.json de cada repo
ls ~/projetos/wifi/.mcp.json ~/projetos/2cerebrox/.mcp.json 2>/dev/null

# MCP que Codex ve
codex mcp list
# esperado HOY: lista vacía — esta es la brecha del proyecto

# hooks de ambos lados
grep -rho '"SessionStart"\|"PostToolUse"\|"Stop"' ~/.claude/settings.json ~/.claude/plugins/cache 2>/dev/null | sort | uniq -c
grep -o '"SessionStart"\|"PostToolUse"\|"Stop"' ~/.codex/hooks.json | sort | uniq -c

Cómo verificar: anota las dos listas en context/overview.md del proyecto en el que estás trabajando. Al final de este módulo, codex mcp list tiene que dejar de estar vacío, y esa es la única métrica que importa en el tema 2.

Objetivo: registrar magnific y metricool en Codex referenciando las keys del .env, sin guardar ningún valor.

# 1. wrapper que carga el .env en runtime y le pasa la posta al servidor
mkdir -p ~/.local/bin
cat > ~/.local/bin/mcp-magnific.sh <<'SH'
#!/usr/bin/env bash
set -euo pipefail
set -a; . "$HOME/projetos/openpcbotv2/.env"; set +a   # carga, no copia
exec npx -y @magnific/mcp-server                      # reemplázalo por el comando real de tu MCP
SH
chmod 700 ~/.local/bin/mcp-magnific.sh

# 2. registrar en Codex: la config guarda una RUTA, nunca una key
codex mcp add magnific  -- "$HOME/.local/bin/mcp-magnific.sh"
codex mcp add metricool -- "$HOME/.local/bin/mcp-metricool.sh"

# 3. verificar
codex mcp list

Cómo verificar: codex mcp list deja de salir vacío y muestra los dos nombres. Después abre codex en cualquier carpeta y pide "lista las herramientas de MCP disponibles": los nombres tienen que aparecer en la respuesta, no solo en el archivo.

Objetivo: probar que ningún secreto terminó en la configuración; esta es la prueba que cierra el tema.

# busca prefijos típicos de key dentro de la config de Codex
grep -rIl -e 'sk-' -e 'API_KEY=' -e 'TOKEN=' ~/.codex 2>/dev/null
# esperado: NINGUNA línea de salida

# verifica que el wrapper no sea legible por otros usuarios
stat -c '%a %n' ~/.local/bin/mcp-*.sh
# esperado: 700 en todos

# verifica que el .env siga siendo la única fuente
grep -c '=' ~/projetos/openpcbotv2/.env   # solo el conteo; nunca imprimas el contenido

Cómo verificar: el primer comando tiene que terminar en silencio. Si imprime cualquier ruta, detén todo: alguna key fue copiada. Elimina el registro con codex mcp remove <nome>, rota la key y rehazlo con el wrapper.

Objetivo: clasificar automáticamente tus skills entre "reutilizable" y "adaptador", para saber qué portar hoy.

# adaptador = el SKILL.md menciona MCP, plugin o subagente
cd ~/.claude/skills
for d in */; do
  s="${d%/}"
  if grep -qE 'mcp__|AskUserQuestion|subagent_type|superpowers:|context-mode:' "$s/SKILL.md" 2>/dev/null; then
    echo "ADAPTADOR  $s"
  else
    echo "portavel   $s"
  fi
done | sort | tee ~/classificacao-skills.txt | awk '{print $1}' | uniq -c

# ver solo las bloqueadas y por qué dependencia
grep '^ADAPTADOR' ~/classificacao-skills.txt | awk '{print $2}' | while read s; do
  echo "== $s"; grep -ohE 'mcp__[a-z0-9_]+' "$s/SKILL.md" | sort -u
done

Cómo verificar: el conteo debe coincidir con el orden de magnitud del diagnóstico: decenas de portables frente a unos 15 adaptadores. Si salen 80 adaptadores, tu grep está captando menciones en ejemplos; ajústalo para que mire solo las líneas de instrucción.

Objetivo: leer lo que realmente está registrado en ambos lados, en lugar de suponerlo.

# qué eventos tiene registrados Codex en esta máquina
python3 -c "import json;print(list(json.load(open('$HOME/.codex/hooks.json'))['hooks']))"
# esperado: ['PostToolUse', 'Stop']

# el matcher y el timeout de cada uno
grep -E '"matcher"|"timeout"|"statusMessage"' ~/.codex/hooks.json

# ¿existe el destino de los dos hooks? (el hook está escrito para fallar en silencio si no existe)
ls -l ~/.agents/skills/impeccable/scripts/hook.mjs

# lo que Claude dispara en el SessionStart — esto es lo que NO tiene equivalente
grep -rl '"SessionStart"' ~/.claude/settings.json ~/.claude/plugins/cache 2>/dev/null

Cómo verificar: la lista de Codex sale con dos nombres y ninguno es SessionStart. Si el ls del hook.mjs falla, los hooks de Codex están registrados pero inertes: el [ ! -f ... ] || al inicio del comando hace que terminen sin decir nada.

Objetivo: agregar la regla de ritmo al ~/.codex/AGENTS.md, reemplazando el hook por lectura.

# respaldo antes de tocar la base global (el Proyecto 1 creó este archivo)
cp ~/.codex/AGENTS.md ~/.codex/AGENTS.md.bak-$(date +%Y%m%d)

cat >> ~/.codex/AGENTS.md <<'MD'

## Regla de ritmo (era el hook fable-mindset en Claude)

- **Piensa antes de actuar.** Antes de la primera edición, di en una frase
  cuál es el problema y cuál es el cambio mínimo que lo resuelve. Si no
  lo sabes, lee más; no empieces a editar para descubrirlo.
- **Cierra el ciclo verificando.** Todo cambio termina con un comando que
  demuestra el resultado (test, `grep`, `status`, readback) y con la salida
  pegada en la respuesta. "Debería funcionar" no cierra el ciclo.
- **Una corrección a la vez.** Si la respuesta fue reescribirlo todo,
  probablemente faltaba una protección: regístralo en el FALHAS.md.
MD

# comprobar que se agregó y que el archivo sigue siendo corto
tail -14 ~/.codex/AGENTS.md
wc -l ~/.codex/AGENTS.md

Cómo verificar: ejecuta codex exec "Antes de editar cualquier archivo, ¿qué debes decir primero? Cita la fuente." desde ~. La respuesta tiene que mencionar la frase sobre el problema y el cambio mínimo, citando el AGENTS.md. Si responde bien sin citar la fuente, es coincidencia del modelo, no lectura, y no cuenta como aceptación.

Objetivo: convertir los 7 subagentes en skills de rol, preservando el cuerpo del prompt y cambiando solo el encabezado.

mkdir -p ~/.agents/skills
for a in advogado-do-diabo analista-neutro estrategista-otimista \
         mestre-do-conselho diretor-ecossistema web-research-assistant \
         triple-x-responder; do
  src=~/.claude/agents/$a.md
  [ -f "$src" ] || { echo "falta: $a"; continue; }
  mkdir -p ~/.agents/skills/papel-$a
  {
    echo "---"
    echo "name: papel-$a"
    echo "description: Asume el rol de $a. Úsalo cuando la tarea pida esa voz explícitamente."
    echo "---"
    echo
    echo "> Rol derivado del subagente \`$a\` de Claude Code."
    echo "> Aquí NO hay ejecución paralela: asume el rol en el contexto actual y"
    echo "> deja claro en la respuesta cuándo estás hablando por él."
    echo
    sed '1{/^---$/!b}; 1,/^---$/d' "$src"   # quita solo el front-matter antiguo
  } > ~/.agents/skills/papel-$a/SKILL.md
  echo "papel-$a"
done

Cómo verificar: ls ~/.agents/skills | grep -c '^papel-' devuelve 7. Después, codex exec "Usa el papel-advogado-do-diabo para atacar esta decisión: migrar todo de una vez.": la respuesta tiene que citar el archivo de la skill y sostener la voz de la contradicción de principio a fin.