La memoria de tu proyecto, para cualquier agente.
AHP+ es la alternativa a MADRE para quien prefiere seguir en su IDE. Guarda en tu repositorio, con Git, el estado del proyecto, las decisiones y las pruebas, para que Codex, Claude Code, Cursor u OpenCode continúen exactamente donde quedó el anterior, aunque cambies de modelo, de editor o de computadora.
MADRE o AHP+
¿Cuál te conviene?
Los dos son gratis, de código abierto y corren en tu computadora. La diferencia es dónde trabajas tú.
| MADRE | AHP+ | |
|---|---|---|
| Dónde trabajas | En una sala que se abre en tu navegador. | En tu IDE de siempre: Codex, Claude Code, Cursor u OpenCode. |
| Cómo colaboran los agentes | Conversan en el mismo chat y se pasan el turno. | Cada uno desde su chat, leyendo el mismo estado del proyecto. También pueden abrir una sala compartida. |
| Qué guarda | La memoria de la conversación: decisiones, datos y preferencias. | El estado del proyecto: fase, decisiones, pruebas, checkpoints y relevos entre agentes. |
| Dónde vive | En tu computadora. | Dentro de tu repositorio (en .ahp/), así que viaja con Git a otras máquinas. |
| Ideal si… | Quieres ver a varios agentes opinar y trabajar en un solo lugar. | Cambias seguido de IDE, de cuenta o de computadora y no quieres perder el hilo. |
| Necesitas | Node 22.5 o superior. | Git, Node 20 o superior y un repositorio con al menos un commit. |
¿No quieres elegir? MADRE trae AHP+ como módulo opcional: lo activas en MODULES y usas /ahp status, /ahp check y /ahp context desde la sala.
Qué guarda
Lo que tu próximo agente necesita saber.
Un chat se olvida al cerrarlo. AHP+ deja por escrito, en tu repositorio, lo que importa para continuar.
El estado del proyecto. En qué fase va, cuál es el objetivo, qué sigue y qué está bloqueado.
Las decisiones. Qué se decidió, quién lo confirmó y si sigue vigente.
Las pruebas. Qué comandos se ejecutaron y qué resultado dieron. Un «aprobado» necesita evidencia.
Los checkpoints. Puntos de la sesión a los que puedes volver.
Los relevos. La entrega de un agente a otro, que el siguiente verifica antes de continuar.
Qué tan cierto es cada dato. Si está verificado, confirmado por ti o solo supuesto. Así nadie confunde un hecho con una suposición.
Instalar
Se instala con un comando.
Desde la carpeta raíz de tu proyecto. Necesitas Git, Node 20 o superior y un repositorio con al menos un commit; no hace falta que el proyecto use Node.
-
Instálalo en tu proyecto
Deja AHP+ fijado en tu repositorio, configura Codex y Claude Code y comprueba que todo esté bien.
npx @jossuealcala/[email protected] setup . -
¿Usas un solo IDE?
Limita la configuración a ese. Por ejemplo, solo Codex:
npx @jossuealcala/[email protected] setup . --platforms codex -
Revisa el proyecto
Confirma que AHP+ ve el repositorio, la rama y el commit correctos.
npx ahp project check . npx ahp project status .
La primera vez debe decir AHP_READY. Revisa los archivos que creó antes de confirmarlos en Git: AHP+ nunca hace commit ni push por ti.
En tu IDE
Pídeselo a tu agente, como le hablas siempre.
Abre el proyecto en tu IDE y pídele a tu agente que use AHP+. Por ejemplo: «Usa AHP+ para comprobar este proyecto y mostrar el commit, los bloqueos y la siguiente acción. No edites archivos.»
- Terminal
npx ahp project check .- Codex
- «Usa
$ahppara revisar el proyecto y leer mis mensajes» - Claude Code
- «Usa AHP+ para correr doctor y la verificación estricta»
- Cursor
/ahp message inbox for=cursor- OpenCode
/ahp message send to=claude text="Continúa"
Entre agentes
Que un agente le pase el trabajo a otro, sin perder nada.
Guardas un checkpoint en un IDE y se lo entregas a otro. El que recibe comprueba que el proyecto, la rama y el commit coincidan antes de seguir.
Guardas un punto
Un checkpoint con lo que se hizo y lo que sigue.
Lo entregas
Un relevo, por ejemplo de Codex a Cursor, con un resumen.
El otro lo verifica
Si todo coincide dice READY; si no, pide conciliar antes de tocar nada.
Continúa
Desde el punto exacto donde quedó el anterior.
Una segunda opinión. Pídele a Claude que revise lo que hizo Codex: responde una sola vez, en solo lectura, y queda registrado.
Salas compartidas. Codex y Claude pueden conversar sobre el proyecto, cada uno desde su propio chat.
Entre computadoras, cifrado. Para mandar el estado a otra máquina, AHP+ firma y cifra cada envío.
Lo que nunca hace
Lo que AHP+ no hace.
No hace commit ni push. Ni merge, ni despliegues, ni publicaciones. Tú revisas y confirmas.
No se da permisos. Un relevo o un checkpoint no autoriza nada: la autoridad viene de ti.
No lee tus secretos. No abre tus archivos
.enva propósito. Y nunca pegues claves en sus registros.Sin dependencias. Solo necesita Node y Git. Nada de paquetes de terceros.
¿Cuándo no lo necesitas? Para una pregunta rápida sin repositorio o un script que vas a tirar, AHP+ es demasiado. Sirve cuando un proyecto pasa entre agentes, IDEs, personas o computadoras.
Tu opinión
¿Qué le falta a AHP+ para tu forma de trabajar?
Cuéntanos qué IDE, qué paso o qué dato te gustaría que AHP+ cubriera. Por el formulario, sin crear cuenta y con seguimiento privado; o en GitHub, si prefieres una conversación pública.
AHP+ dentro de MADRE
También funciona dentro de MADRE.
MADRE trae AHP+ como módulo opcional. Actívalo en MODULES y usa /ahp status, /ahp check y /ahp context desde la sala. Es el único módulo que escribe en tu proyecto, y antes te muestra el comando y te pide confirmación.
Prueba AHP+ en tu proyecto.
npx @jossuealcala/[email protected] setup .