EN Instalar

La memoria de tu proyecto, para cualquier agente.

Si prefieres quedarte en tu IDE, AHP+ es la alternativa a MADRE. Guarda en tu repositorio, con Git, en qué va el proyecto, qué se decidió y qué pruebas se corrieron. Así Codex, Claude Code, Cursor u OpenCode siguen justo donde se quedó el anterior, aunque cambies de modelo, de editor o de computadora.

Basado en el README de AHP+ 1.4.1

Recorrido de AHP+ en video, 36 segundos, sin audio. 1. Tu proyecto guarda su estado, sus decisiones y sus pruebas en .ahp/, con Git. 2. Codex, Claude Code, Cursor u OpenCode siguen donde quedó el anterior. 3. Quien recibe el trabajo comprueba proyecto, rama y commit antes de seguir. 4. Un «aprobado» solo cuenta si quedan el comando y su resultado. 5. AHP+ nunca hace commit ni push. Tú revisas y confirmas.

En corto

  • AHP+ guarda en tu repositorio, con Git, en qué va el proyecto: qué se decidió y qué pruebas corrieron.
  • Así Codex, Claude Code, Cursor u OpenCode siguen el trabajo sin que se los expliques otra vez, dentro o fuera de MADRE.
  • En MADRE se llama Continuidad y se enciende en Módulos. Fuera de MADRE se instala con un comando.
  • Es gratis y de código abierto, como MADRE.

MADRE o AHP+

¿Cuál te conviene?

Los dos corren en tu compu y son gratis para personas y equipos pequeños. Lo que cambia es dónde trabajas tú.

MADRE y AHP+, lado a lado
MADREAHP+
Dónde trabajasEn tus proyectos, que se abren en tu navegador.En el IDE que ya usas: Codex, Claude Code, Cursor u OpenCode.
Cómo trabajan juntos los agentesPlatican en el mismo chat y se pasan el turno.Cada uno en su chat, leyendo el mismo estado del proyecto. También pueden abrir una sala compartida.
Qué guardaLa memoria de la conversación: decisiones, datos y preferencias.El estado del proyecto: fase, decisiones, pruebas, checkpoints y relevos entre agentes.
Dónde viveEn tu compu.Dentro de tu repositorio (en .ahp/), así que se va con Git a tus otras computadoras.
Te va mejor si…Quieres ver a varios agentes opinar y trabajar en el mismo chat.Cambias seguido de IDE, de cuenta o de computadora y no quieres perder el hilo.
NecesitasNode 22.5 o más nuevo.Git, Node 20 o más nuevo y un repositorio con al menos un commit.

¿No quieres escoger? MADRE trae AHP+ como módulo opcional. Lo prendes en Módulos, donde se llama Continuidad, y usas /ahp status, /ahp check y /ahp context desde el proyecto.

Qué guarda

Lo que tu próximo agente necesita saber.

Un chat se olvida en cuanto lo cierras. AHP+ apunta en tu repositorio lo que hace falta para seguir.

  • 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 en pie.

  • Las pruebas. Qué comandos se corrieron y qué dieron. Un «aprobado» solo vale con evidencia.

  • Los checkpoints. Puntos de la sesión a los que puedes regresar.

  • Los relevos. Cuando un agente le pasa el trabajo a otro. El que sigue lo verifica antes de continuar.

  • Qué tan cierto es cada dato. Si está verificado, si tú lo confirmaste o si nada más se supone. Así nadie confunde un hecho con una suposición.

Instalar

Se instala con un comando.

Lo corres desde la carpeta raíz de tu proyecto. Necesitas Git, Node 20 o más nuevo y un repositorio con al menos un commit. Tu proyecto no tiene que usar Node.

  1. Instálalo en tu proyecto

    Deja AHP+ fijo en tu repositorio, configura Codex y Claude Code y revisa que todo esté bien.

    npx @jossuealcala/[email protected] setup .
  2. ¿Usas un solo IDE?

    Configura nada más ese. Por ejemplo, solo Codex:

    npx @jossuealcala/[email protected] setup . --platforms codex
  3. Revisa el proyecto

    Checa que AHP+ esté viendo el repositorio, la rama y el commit correctos.

    npx ahp project check .
    npx ahp project status .

La primera vez te tiene que decir AHP_READY. Antes de hacer commit de los archivos que creó, revísalos. AHP+ nunca hace commit ni push por ti.

En tu IDE

Pídeselo a tu agente como siempre.

Abre el proyecto en tu IDE y dile 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 $ahp para 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

Un agente le pasa el trabajo a otro y no se pierde nada.

Guardas un checkpoint en un IDE y se lo pasas a otro. El que lo recibe revisa que el proyecto, la rama y el commit coincidan antes de seguir.

  1. Guardas un punto

    Un checkpoint con lo que se hizo y lo que sigue.

  2. Lo entregas

    Haces un relevo, por ejemplo de Codex a Cursor, con un resumen.

  3. El otro lo verifica

    Si todo coincide, dice READY. Si no, pide conciliar antes de tocar nada.

  4. Sigue

    Justo desde donde se quedó el anterior.

  • Una segunda opinión. Pídele a Claude que revise lo que hizo Codex. Contesta una sola vez, en solo lectura, y queda apuntado.

  • Salas compartidas. Codex y Claude pueden platicar sobre el proyecto, cada uno desde su propio chat.

  • Entre computadoras, cifrado. Para mandar el estado a otra compu, AHP+ firma y cifra cada envío.

Lo que nunca hace

Lo que AHP+ no hace.

  • No hace commit ni push. Tampoco hace merge, ni despliega, ni publica nada. Tú revisas y confirmas.

  • No se da permisos. Un relevo o un checkpoint no autoriza nada. Quien autoriza eres tú.

  • No lee tus secretos. No abre tus archivos .env a propósito. Y tú nunca pegues claves en sus registros.

  • Sin dependencias. Nada más necesita Node y Git. Ningún paquete de terceros.

¿Cuándo no te hace falta? Para una pregunta rápida sin repositorio, o un script que vas a tirar, AHP+ sale sobrando. 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éntame qué IDE, qué paso o qué dato te gustaría que AHP+ cubriera. Puedes usar el formulario, que no pide cuenta y te da seguimiento privado, o GitHub, si prefieres platicarlo en público.

Sugerir una mejora a AHP+ Abrir un issue en GitHub

AHP+ dentro de MADRE

También funciona dentro de MADRE.

MADRE trae AHP+ como módulo opcional. Préndelo en Módulos, donde se llama Continuidad, y usa /ahp status, /ahp check y /ahp context desde el proyecto. Es el único módulo que escribe en tu proyecto, y antes de hacerlo te enseña el comando y te pide que confirmes.

Ver AHP+ 1.4.1 en npm Leer la guía de inicio

Prueba AHP+ en tu proyecto.

npx @jossuealcala/[email protected] setup .

¿Prefieres el navegador? Conoce MADRE