Producto propio · Código abierto

AHP+ — Agent Handoff Protocol Plus

AHP+ guarda dentro del propio proyecto lo que ya se hizo, lo que se comprobó y lo que falta. Así, cuando el trabajo cambia de asistente de IA, de programa o de computadora, nadie tiene que adivinar dónde se quedó.

Contribución: Creador y arquitecto de AHP+. Definí cómo funciona, escribí la especificación 1.1, el sistema de etiquetas que distingue lo comprobado de lo supuesto, el formato de las anotaciones, la herramienta de terminal publicada en npm, los instaladores para cada plataforma y los límites de lo que nunca hace por su cuenta.
Especialidad: Node.js · JSON · npm

Agent Handoff Protocol Plus

01 / El reto

Entender el negocio antes de diseñar la solución.

Hoy una misma persona puede trabajar con varios asistentes de IA: Codex, Cursor, Claude Code, OpenCode o ChatGPT. Cada uno recuerda la conversación a su manera, y esa memoria no se puede comprobar ni viaja con el proyecto. Al cambiar de herramienta, de cuenta o de computadora, el hilo se pierde. AHP+ 1.1.0 lo resuelve guardando ese hilo dentro del repositorio, junto al código.

Convertir ese hilo en archivos sencillos que cualquiera pueda leer y comprobar: en qué punto va el proyecto, qué decisiones siguen vigentes, qué se probó de verdad y cuál es el siguiente paso. Todo sin quitarle el control a la persona ni sustituir a Git.

02 / El enfoque

Una dirección clara para producto, experiencia y operación.

01
Cada proyecto es dueño de su propia memoria: AHP+ crea una carpeta .ahp/ dentro del repositorio y ahí guarda su estado real, sin mezclarse con otros proyectos.
02
Cada dato dice cuánta confianza merece: si se comprobó con una herramienta, si lo confirmó una persona, si es solo una suposición, si ya caducó o si dos fuentes se contradicen.
03
La entrega entre herramientas se revisa antes de aceptarse: quien recibe compara proyecto, rama y commit, y solo continúa si todo coincide.

03 / Trabajo realizado

Del criterio a una solución que el equipo puede usar.

La especificación abierta AHP+ 1.1: las reglas del formato, escritas para que cualquiera pueda implementarlas.
Una herramienta de terminal publicada en npm como @jossuealcala/ahp-plus, sin dependencias de terceros y con licencia Apache-2.0.
Instaladores para Cursor, OpenCode, Codex, Claude Code, ChatGPT y otros agentes: cada plataforma lo pide a su manera, pero el significado no cambia.
Documentación en español e inglés y pruebas automáticas en Ubuntu, macOS y Windows con Node.js 20 y 22.

04 / Gráficos

Evidencia traducida a lectura visual.

01
Tu proyecto
El código, las imágenes, las pruebas y la documentación viven en el repositorio.
02
Carpeta .ahp/
Aquí AHP+ anota en qué punto va el proyecto, qué se probó, qué riesgos hay y qué sigue.
03
La siguiente herramienta
Antes de continuar lee esas anotaciones y confirma que coincidan con el repositorio.

AHP+ deja constancia del contexto; la revisión de una persona sigue siendo necesaria.

01
VERIFIED
Comprobado con un archivo, un comando o una fuente directa. Sirve para decidir.
02
USER_CONFIRMED
Lo confirmó la persona responsable. También sirve para decidir.
03
INFERRED
Es una suposición razonable: se puede usar como hipótesis, nunca como hecho.
04
CONFLICTED
Dos fuentes se contradicen. Frena cualquier decisión que dependa de eso.

05 / Resultado

Lo que el proyecto dejó construido.

AHP+ 1.1.0 está publicado y cualquiera puede instalarlo desde npm o GitHub.
Se probó de punta a punta: instalación limpia, los seis instaladores y una entrega real de Codex a Cursor aceptada en otro proyecto.
Tiene un límite deliberado: AHP+ anota y comprueba, pero nunca hace commit, push, merge ni despliegues por su cuenta. Eso lo autoriza una persona.

Principios aplicados

El proyecto manda, no la conversación.
Nada se da por hecho sin prueba.
Lo importante lo autoriza una persona.

06 / Guía de comandos

Instala y opera AHP+ en cualquier plataforma.

Guía paso a paso: cómo instalarlo en macOS, Linux o Windows, los 40 comandos listos para copiar y qué escribir en el chat de Cursor, OpenCode, Codex, Claude Code o ChatGPT.

Abrir Command Atlas

07 / Tecnología