Jossue AlcaláCrear · Construir

Producto propio · Memoria para agentes

Memoria compartida para tus agentes de código,guardada en tu repositorio.

AHP+ guarda con Git el estado del proyecto, las decisiones y las pruebas en una carpeta .ahp/. Si cambias de Codex a Claude Code, Cursor u OpenCode, de cuenta o de computadora, el siguiente agente lee lo mismo y comprueba proyecto, rama y commit antes de tocar nada.

Hablar de mi flujo con agentesVer todos los comandos
npx @jossuealcala/ahp-plus@1.4.1 setup .
Demo · 36 s
0
dependencias de terceros: solo Node y Git
64
formas de comando, en 16 categorías
1.4.1
versión actual, licencia Apache-2.0

Gratis · Código abierto · 1.4.1

Qué resuelve

Al cambiar de agente, de cuenta o de computadora se pierde el contexto del proyecto

Un agente de código puede seguir una conversación, pero esa conversación no dice qué commit es el correcto, qué decisiones siguen vigentes ni qué pruebas se corrieron. AHP+ lo deja escrito en el repositorio, donde ya vive tu proyecto.

  • Cambias de agente
    Sin AHP+
    Le explicas el proyecto desde cero al siguiente.
    Con AHP+
    Lee .ahp/ y retoma con el estado actual, las decisiones vigentes y lo que ya se probó.
  • Saber qué se decidió
    Sin AHP+
    La decisión quedó en un chat que ya no abres.
    Con AHP+
    Cada decisión, tarea, bug, riesgo y evidencia es su propio archivo en el repositorio, con su historial en Git.
  • Cambió el commit o la rama
    Sin AHP+
    El agente nuevo trabaja sobre otra versión y nadie se entera.
    Con AHP+
    Antes de seguir compara proyecto, rama, commit y cambios locales. Si no coinciden, se detiene y te pide resolver la diferencia.
  • Cambias de computadora o de cuenta
    Sin AHP+
    El contexto se queda en la máquina o la cuenta anterior.
    Con AHP+
    Viaja con el repositorio. Haces pull y el siguiente agente tiene lo mismo.

Cómo funciona

Cómo pasa el trabajo de un agente a otro

Elige un paso para ver qué se escribe en .ahp/ y qué comprueba el agente que recibe. Los comandos son los reales; los identificadores y el commit del ejemplo son ilustrativos.

Qué incluye

Qué guarda en .ahp/ y qué instala en tu proyecto

  • Estado, decisiones y pruebasUn archivo por registro (decisión, tarea, bug, riesgo, QA, requisito, evidencia) dentro de .ahp/, versionado con Git.
  • Relevos que se compruebanCompara proyecto, árbol, rama, commit y cambios locales. Si no coinciden, el resultado es RECONCILIATION_REQUIRED.
  • Puntos de controlMarcan dónde quedó una sesión y cuál es la siguiente acción, para retomarla. No sustituyen tus commits ni tus respaldos.
  • Mensajes entre agentesmessage send, reply e inbox dejan avisos con una huella SHA-256, que prueba que no se alteraron. No guardan la conversación completa.
  • No ejecuta acciones sensiblesNunca hace commit, push, merge, deploy, publicación ni eliminación. Tampoco se da permisos a sí mismo.
  • Adaptadores por agenteCodex con la skill $ahp, Claude Code con CLAUDE.md, Cursor y OpenCode con /ahp, y cualquier otro agente con AGENTS.md.

Control y límites

Qué hace AHP+ con tu repositorio y qué no hace

Lo que hace

  • Escribe en .ahp/ y detiene la escritura si el commit o el estado ya no son los esperados.
  • Instala los adaptadores primero en modo plan, sin sobrescribir nada en silencio.
  • Marca cada afirmación con su certeza: verificada, confirmada por ti, inferida, sin verificar, vencida o en conflicto.
  • Corre en macOS, Windows y Linux con Node 20 o más; no pide dependencias de terceros.

Lo que no hace

  • Hacer commit, push, merge, deploy, publicar ni borrar.
  • Copiar la conversación completa ni el razonamiento del modelo.
  • Sustituir tus pruebas ni la revisión de una persona: solo registra lo que se observó.
  • Darte permisos: READY significa que el relevo coincide con el repositorio, no que algo esté autorizado.
  • Guardar tokens ni archivos .env: .ahp/ viaja con Git, trátalo como el repositorio.

Para quién es

Cuándo conviene y cuándo todavía no

Conviene si

  • Trabajas con agentes de código desde un IDE y cambias seguido de agente, de cuenta o de computadora.
  • Quieres que las decisiones y las pruebas queden en el repositorio y no en un chat.
  • Tienes Node 20 o más y un repositorio de Git con al menos un commit.

Todavía no, si

  • Buscas memoria vectorial, un orquestador de agentes o un sistema de permisos: AHP+ no es ninguna de las tres.
  • Necesitas deshacer cambios por ti: los puntos de control sirven para retomar, no para revertir.
  • Trabajas fuera de Git.

Caso relacionado

El caso completo del proyecto

Preguntas frecuentes

Lo que más me preguntan sobre AHP+

¿Hace commit o push por mí?

No. Tampoco pull, merge, deploy ni publicación. Eso lo autorizas tú.

¿Mi proyecto tiene que usar Node?

No. Necesitas Node 20 o más y Git en la máquina, y un repositorio con al menos un commit. Si falta un package.json, setup crea uno mínimo y privado.

¿Con qué agentes funciona?

Codex, Claude Code, Cursor y OpenCode tienen adaptador, y ChatGPT uno limitado de solo lectura. Cualquier otro agente con acceso al repositorio puede seguir las instrucciones de AGENTS.md.

¿Qué pasa si el relevo no coincide con el repositorio?

handoff receive compara proyecto, commit, árbol, rama y cambios locales. Si algo no coincide, el resultado es RECONCILIATION_REQUIRED y el agente debe detenerse hasta que lo resuelvas.

¿Guarda mis secretos o toda la conversación?

No copia chats ni razonamiento oculto, y las llaves privadas de dispositivo viven fuera de Git. Pero .ahp/ viaja con tu repositorio: no guardes tokens ni .env ahí.

Ficha técnica

Datos clave de AHP+

Versión
1.4.1 (4 de septiembre de 2026)
Licencia
Apache-2.0, código abierto
Requisitos
Node 20 o más, Git y un repositorio con al menos un commit
Dependencias
Ninguna de terceros
Probado en
Ubuntu, macOS y Windows, con Node 20 y 22
Instalación
npx @jossuealcala/ahp-plus@1.4.1 setup .
Precio
Gratis

¿Trabajas con varios agentes de código?

Instálalo en un repositorio de prueba y corre ahp project check. Si quieres que lo adapte a tu flujo o a tu equipo, escríbeme.

Hablar de mi flujo