Jossue AlcaláCrear · Construir

Producto propio · Código abierto

AHP+ — Agent Handoff Protocol Plus

AHP+ mantiene el hilo del trabajo dentro del proyecto: qué se hizo, qué se comprobó y qué sigue. Así puedes cambiar de asistente, cuenta o computadora sin empezar de cero.

EscríbemeVer el producto
Portada de AHP+ — Agent Handoff Protocol Plus
Captura real del proyecto
Producto propio
tipo de proyecto
Node.js · JSON
herramientas principales
10
herramientas que usé

01 · El reto

Qué estaba pasando

Contexto

Los asistentes recuerdan cada conversación de forma distinta, pero esa memoria no siempre se puede comprobar ni viaja con el código. AHP+ 1.4.1 convierte el contexto importante en archivos del repositorio, para que Codex, Cursor, Claude Code, OpenCode, ChatGPT u otro agente puedan ubicarse antes de actuar.

El problema

Que el contexto viaje con el proyecto sin volverse papeleo. Tenía que leerse fácil para una persona, tener una estructura que un agente pudiera comprobar y dejar claro que ninguna automatización toma decisiones que le tocan a una persona.

Mi parte

Lo creé y lo diseñé yo. Definí la especificación 1.4.1, el modelo de certeza y evidencia, la CLI pública, los adaptadores, los handoffs sellados, la mensajería causal, las salas de proyecto, la identidad por dispositivo y los límites de autoridad.

02 · Cómo lo resolví

Cómo decidí resolverlo

  1. 01

    Cada proyecto conserva su memoria operativa en .ahp/: estado, decisiones, pruebas, bloqueos y siguiente acción viajan con el trabajo.

  2. 02

    Cada afirmación dice qué tan segura es. Los eventos causales y los traspasos de trabajo (handoffs) se verifican antes de usarse como punto para retomar el trabajo.

  3. 03

    Le pides las cosas en lenguaje normal desde tu editor (IDE) y se ejecutan con una herramienta de terminal (CLI) que da el mismo resultado cada vez. Lo que sale del proyecto sigue necesitando que una persona lo autorice.

03 · Lo que hice

Lo que quedó hecho

  • Especificación abierta y CLI AHP+ 1.4.1, publicadas como @jossuealcala/ahp-plus bajo licencia Apache-2.0.
  • Instalación guiada con un comando, pulso de proyecto, contexto acotado, registros, checkpoints, locks cooperativos y handoffs.
  • Adaptadores para Cursor, OpenCode, Codex, Claude Code, ChatGPT y agentes genéricos, con consulta acotada y salas de proyecto.
  • Identidades Ed25519/X25519 por dispositivo, sobres AES-256-GCM y recibos firmados para transporte autorizado.

04 · Gráficos

Los números en gráficos

ahp-continuity

Cómo pasa el trabajo de una herramienta a otra

AHP+ anota lo hecho, lo probado y lo que falta en archivos que viajan junto al código.

  1. 01
    Tu proyecto

    El código, las imágenes, las pruebas y la documentación viven en el repositorio.

  2. 02
    Carpeta .ahp/

    Aquí AHP+ anota en qué punto va el proyecto, qué se probó, qué riesgos hay y qué sigue.

  3. 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.

ahp-certainty

Qué tanto se puede confiar en cada dato

Cada anotación lleva una etiqueta que distingue lo comprobado de lo que solo se supone.

  1. 01
    VERIFIED

    Comprobado con un archivo, un comando o una fuente directa. Sirve para decidir.

  2. 02
    USER_CONFIRMED

    Lo confirmó la persona responsable. También sirve para decidir.

  3. 03
    INFERRED

    Es una suposición razonable: se puede usar como hipótesis, nunca como hecho.

  4. 04
    CONFLICTED

    Dos fuentes se contradicen. Frena cualquier decisión que dependa de eso.

05 · Cómo quedó

Qué cambió al final

  • AHP+ 1.4.1 está publicado e instalable desde npm o GitHub.

  • En este portafolio se ejecutó la CLI 1.4.1: verificación estricta de 21 archivos, handoff de Claude recibido como READY y respuesta causal guardada en una sala compartida.

  • La prueba local quedó como LOCAL_CAPTURED: demuestra persistencia e integridad en el repositorio, no inyección en chats nativos ni transporte remoto.

Lo que no negocié

  • 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

Cómo instalar y usar AHP+ en tu herramienta

La guía explica qué hace AHP+ 1.4.1, muestra una ejecución real y te dice cómo instalarlo con un comando. También tiene cada instrucción lista para usar en la terminal o en el chat.

Abrir Command Atlas

07 · Tecnología

Con qué está hecho

  • Node.jsNode.js
  • JSONJSON
  • npm
  • GitHubGitHub
  • OpenAICodex
  • CursorCursor
  • ClaudeClaude Code
  • OpenCode
  • ChatGPT
  • AHP+ 1.4.1

Más casos

Otros proyectos que puedes revisar

¿Quieres algo así para tu negocio?

Si trabajas con varios asistentes de IA y pierdes el hilo al pasar de uno a otro, escríbeme y te cuento cómo lo resuelvo.

Escríbeme