AHP+ 1.4.1 · Command Atlas

Que el contexto viaje con el trabajo.

AHP+ guarda dentro del proyecto lo que se hizo, lo que se comprobó y lo que sigue. Así puedes cambiar de asistente, cuenta o computadora sin volver a explicar todo desde cero.

1comando para empezar

6superficies con adaptador

Túautorizas lo importante

00 / En una frase

La conversación ayuda. El repositorio recuerda.

AHP+ no es otro chatbot. Es una capa de continuidad que convierte el contexto importante en archivos que se pueden leer, comprobar y llevar junto al código.

TERMINAL

Aquí ocurre la operación

El comando devuelve una salida reproducible. Esa salida puede convertirse en evidencia.

shell
npx ahp project verify . --strict

IDE / CHAT

Aquí expresas la intención

El adaptador traduce la petición al CLI y el agente debe enseñarte el resultado. Su texto por sí solo no demuestra ejecución.

chat
Usa $ahp para comprobar este proyecto. No edites.

01 / Qué permite

Continuidad que se puede revisar.

La versión 1.4.1 amplía el protocolo sin convertirlo en una caja negra. Cada capacidad conserva una salida, un límite y una autoridad identificable.

01

El proyecto recuerda.

Estado, decisiones, pruebas y siguiente paso viven en .ahp/, junto al trabajo que describen.

02

El relevo se comprueba.

Un handoff sellado se inspecciona y solo se recibe cuando coincide con el proyecto y su frontera Git.

03

Los asistentes pueden conversar.

Mensajes causales, consultas de solo lectura y salas compartidas dejan una huella durable.

04

La certeza se etiqueta.

VERIFIED no significa lo mismo que una inferencia. AHP+ conserva esa diferencia para que el equipo decida mejor.

05

La identidad viaja cifrada.

La versión 1.4.1 incorpora identidades por dispositivo, sobres cifrados y recibos firmados para transporte autorizado.

06

La persona conserva el control.

AHP+ no concede permiso para commit, push, merge, deploy, publicación, pagos, borrado ni secretos.

02 / Prueba real

Este proyecto ya hizo el recorrido.

El 12 de septiembre de 2026 ejecutamos la CLI instalada en jossue-portfolio, verificamos el repositorio, recibimos un handoff de Claude y respondimos dentro de una sala compartida.

VERSIÓN EJECUTADA

1.4.1CLI instalada dentro de jossue-portfolio.

VERIFICACIÓN ESTRICTA

PASS21 archivos revisados; 0 errores y 0 advertencias.

HANDOFF

READYHOF-20260912-6BF37A9D

SALA COMPARTIDA

LOCAL_CAPTUREDconv-room-20260912-c233f7d7

03 / Instalación

Un comando para empezar.

Necesitas Git, Node.js 20 o superior y al menos un commit. setup fija la versión, prepara .ahp/, instala las superficies elegidas y ejecuta doctor más verify --strict.

Abre Terminal en la raíz del repositorio. El mismo comando instala y configura.

zsh
npx @jossuealcala/ahp-plus@1.4.1 setup .
npx ahp project check .

DEFAULT

Codex + Claude

setup instala las dos superficies y sus identidades locales.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup .

FOCUSED

Una plataforma

Limita la instalación si no necesitas todas las integraciones.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup . --platforms codex

04 / Uso cotidiano

Primero ubícate. Después actúa.

Usa el pulso al abrir el proyecto, cambiar de asistente o recibir trabajo. Te evita decidir con un resumen viejo o con el repositorio equivocado.

terminal · all OS
npx ahp project check . --platform codex
npx ahp project status .
npx ahp session context . --format markdown --budget 8000

Lee la salida antes de editar. LOCAL_READY habla de esta máquina; REMOTE_READY exige que la continuidad ya esté disponible en el remoto.

05 / Atlas

Busca por intención.

No memorices la CLI. Busca lo que quieres lograr y copia el ejemplo. La sintaxis es la gramática oficial de AHP+ 1.4.1: categoría, acción, objetivo y opciones.

41 comandos visibles

Empezar

Instalar y configurar

Fija AHP+ 1.4.1, prepara .ahp/, Codex y Claude, crea identidades locales y ejecuta las comprobaciones iniciales.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup .

Empezar

Instalar solo para Codex

Evita integraciones que no usarás y deja únicamente la superficie de Codex.

terminal
npx @jossuealcala/ahp-plus@1.4.1 setup . --platforms codex

Empezar

Ver el catálogo oficial

Lista la gramática y los comandos disponibles en la versión instalada.

terminal
npx ahp catalog

Proyecto

Pulso recomendado

Resume de una vez identidad, estructura, verificación, preparación y transporte del proyecto.

terminal
npx ahp project check . --platform codex

Proyecto

Confirmar la raíz

Muestra qué repositorio y qué carpeta .ahp/ está usando antes de escribir.

terminal
npx ahp project root .

Proyecto

Diagnosticar la instalación

Comprueba identidad, estructura y portabilidad sin alterar el proyecto.

terminal
npx ahp project doctor .

Proyecto

Diagnosticar Git

Añade una lectura del estado Git del host al diagnóstico.

terminal
npx ahp project doctor . --diagnose-git

Proyecto

Verificar a fondo

Valida estructura, referencias, integridad y advertencias.

terminal
npx ahp project verify . --strict

Proyecto

Ver el estado

Explica la fase, el estado de Git, los bloqueos y la portabilidad.

terminal
npx ahp project status .

Proyecto

Separar local de remoto

Distingue que el proyecto esté listo aquí de que ya pueda continuar en otra máquina.

terminal
npx ahp project ready . --platform codex

Proyecto

Aceptar el commit actual

Confirma deliberadamente la frontera canónica después de revisar el diff; no hace commit ni push.

terminal
npx ahp project state . --accept-head

Sesión

Leer el contexto

Genera un resumen acotado para una persona o un agente.

terminal
npx ahp session context . --format markdown --budget 8000

Sesión

Actualizar el brief

Regenera el resumen guardado dentro del repositorio.

terminal
npx ahp session brief . --budget 8000

Sesión

Crear un checkpoint

Guarda dónde terminaste y cuál es la siguiente acción verificable.

terminal
npx ahp session checkpoint . --summary "Límite validado" --next-action "Crear handoff"

Sesión

Revisar el historial

Lista checkpoints y handoffs de la sesión.

terminal
npx ahp session history .

Conversación

Enviar un mensaje causal

Guarda un mensaje operativo con huella verificable dentro del proyecto.

terminal
npx ahp message send "Continúa desde el límite verificado" --from codex --to claude

Conversación

Leer el inbox

Muestra los mensajes dirigidos a una plataforma.

terminal
npx ahp message inbox . --for claude

Conversación

Responder un mensaje

Vincula la respuesta con el evento que la originó.

terminal
npx ahp message reply EVT-... "Recibido y verificado" --from claude

Conversación

Verificar una huella

Comprueba que un evento no cambió después de crearse.

terminal
npx ahp message verify EVT-... .

Conversación

Pedir una segunda opinión

Solicita una sola respuesta de solo lectura a Claude desde Codex.

terminal
npx ahp agent ask claude "¿Qué riesgo ves en este cambio?" --from codex

Conversación

Abrir una sala

Crea una conversación durable para participantes del mismo proyecto.

terminal
npx ahp conversation open "Revisión de arquitectura" --participants codex,claude --from codex

Conversación

Enviar a la sala

Añade un evento nuevo a una sala compartida.

terminal
npx ahp conversation send conv-... "Revisa el siguiente paso" --from codex --to claude

Conversación

Esperar una respuesta

Hace una espera explícita; no despierta ni escribe en el chat nativo de otra app.

terminal
npx ahp conversation wait conv-... --for codex --timeout 60

Evidencia

Guardar evidencia

Registra el resultado observado de una prueba o artefacto.

terminal
npx ahp record add evidence . --title "Verificación local"

Evidencia

Guardar una decisión

Deja una decisión explícita y revisable dentro del proyecto.

terminal
npx ahp record add decision . --title "Mantener autoridad humana"

Evidencia

Listar pendientes activos

Muestra solo lo que todavía requiere atención.

terminal
npx ahp record list task . --active

Evidencia

Cerrar un registro

Cierra un registro con un estado explícito; el historial se conserva.

terminal
npx ahp record close TASK-... . --status CLOSED

Continuidad

Crear la entrega

Sella el contexto necesario para continuar en otra plataforma.

terminal
npx ahp handoff create . --from codex --to claude --summary "Continuar desde el límite validado"

Continuidad

Inspeccionar la entrega

Comprueba contenido e integridad sin aceptarla todavía.

terminal
npx ahp handoff inspect HOF-... .

Continuidad

Recibir la entrega

La acepta solo si corresponde con el proyecto y su frontera Git.

terminal
npx ahp handoff receive HOF-... .

Continuidad

Comprobar transporte

Verifica si la continuidad ya está disponible en el remoto; no ejecuta Git.

terminal
npx ahp sync check . --require-remote

Continuidad

Reservar un alcance

Publica un lock cooperativo para evitar que dos agentes pisen la misma zona.

terminal
npx ahp lock acquire . --scope src/editor --owner codex

Continuidad

Liberar el alcance

Retira el lock cooperativo al terminar.

terminal
npx ahp lock release LOCK-... . --owner codex

Seguridad

Listar identidades

Muestra las identidades locales de dispositivo disponibles.

terminal
npx ahp identity list .

Seguridad

Verificar una identidad

Comprueba la identidad de firma y cifrado de un dispositivo.

terminal
npx ahp identity verify DEV-... .

Seguridad

Enviar cifrado por red

Cifra y firma un evento para un dispositivo concreto mediante un hub autorizado.

terminal
npx ahp secure network send EVT-... --from-device DEV-... --to-device DEV-... --url HTTPS_URL --token-file FILE

Seguridad

Recibir cifrado

Descarga y abre mensajes destinados a una identidad local.

terminal
npx ahp secure network receive --as-device DEV-... --url HTTPS_URL --token-file FILE

Seguridad

Confirmar con recibo

Devuelve un recibo firmado por el dispositivo receptor.

terminal
npx ahp secure network confirm --as-device DEV-... --url HTTPS_URL --token-file FILE

Integración

Ver plataformas

Lista los adaptadores que la versión instalada reconoce.

terminal
npx ahp adapter list

Integración

Previsualizar adaptadores

Muestra qué archivos se instalarían y detecta conflictos, sin escribir.

terminal
npx ahp adapter install all .

Integración

Aplicar adaptadores

Instala las superficies para los asistentes elegidos.

terminal
npx ahp adapter install all . --apply

06 / CHAT

Pídelo en palabras humanas.

El adaptador se instala desde terminal. Después puedes expresar la intención en el chat; el agente debe ejecutar el CLI local y mostrar evidencia.

IDE / APP

Cursor

Instala /ahp en Cursor. El adaptador traduce la intención al CLI local y debe mostrar la salida real.

En terminal

terminal
npx ahp adapter install cursor . --apply

Directamente en el chat

  • CHAT
    /ahp project check
  • CHAT
    /ahp session checkpoint resumen="Límite validado" siguiente="Crear handoff"
  • CHAT
    /ahp conversation inbox room=conv-... for=cursor
  • CHAT
    /ahp receive HOF-...

IDE / APP

OpenCode

Instala el mismo vocabulario /ahp en OpenCode.

En terminal

terminal
npx ahp adapter install opencode . --apply

Directamente en el chat

  • CHAT
    /ahp status
  • CHAT
    /ahp verify strict
  • CHAT
    /ahp handoff to claude

IDE / APP

Codex

Instala la skill $ahp y conserva el contrato del proyecto en AGENTS.md.

En terminal

terminal
npx ahp adapter install codex . --apply

Directamente en el chat

  • CHAT
    Usa $ahp para comprobar este proyecto y mostrar project_id, commit, portabilidad, bloqueos y siguiente acción. No edites archivos.
  • CHAT
    Usa $ahp para preguntarle a Claude qué riesgo ve en este cambio, solo lectura.
  • CHAT
    Usa $ahp para recibir HOF-... y no edites si el resultado no es READY.

IDE / APP

Claude Code

Conecta CLAUDE.md con AHP_INSTRUCTIONS.md. Se usa con lenguaje natural, no con un slash command propio.

En terminal

terminal
npx ahp adapter install claude . --apply

Directamente en el chat

  • CHAT
    Usa AHP+ para ejecutar el pulso del proyecto y mostrarme la salida real antes de continuar.
  • CHAT
    Usa AHP+ para pedirle a Codex una revisión de solo lectura y una sola respuesta.
  • CHAT
    Recibe HOF-... con AHP+ y detente si requiere reconciliación.

IDE / APP

ChatGPT / Mobile

Con repositorio y terminal puede ejecutar. Si solo lee archivos, debe declarar esa limitación.

En terminal

terminal
npx ahp adapter install chatgpt . --apply

Directamente en el chat

  • CHAT
    Lee AHP_INSTRUCTIONS.md. Ejecuta el pulso de inicio y muéstrame la salida real.
  • CHAT
    Si no tienes terminal, usa AHP_MOBILE.md y no digas que verificaste, probaste, hiciste commit ni push.

IDE / APP

Cualquier otro agente

Instala instrucciones neutrales para cualquier agente con acceso al repositorio.

En terminal

terminal
npx ahp adapter install generic . --apply

Directamente en el chat

  • CHAT
    Sigue las instrucciones AHP+ de este repositorio. Verifica antes de escribir y usa Git confirmado como fuente canónica.
  • CHAT
    Muéstrame la evidencia real y espera mi autorización antes de cualquier acción externa.

07 / Handoff

Cambiar de asistente sin empezar de cero.

El handoff sella el contexto y lo vincula con el proyecto. Git lo transporta y una persona autoriza cada acción externa.

  1. 01

    Marca el límite

    Guarda dónde terminaste y qué debería ocurrir después.

    terminal
    npx ahp session checkpoint . --summary "Límite validado" --next-action "Crear handoff"
  2. 02

    Crea la entrega

    Declara origen, destino y resumen. AHP+ la sella contra cambios.

    terminal
    npx ahp handoff create . --from codex --to claude --summary "Continuar desde el límite validado"
  3. 03

    Transporta con autorización

    Revisa el diff y decide si haces commit y push. AHP+ no ejecuta ni autoriza Git.

  4. 04

    Inspecciona antes de recibir

    El receptor comprueba integridad, proyecto y frontera Git antes de editar.

    terminal
    npx ahp project verify . --strict
    npx ahp handoff inspect HOF-... .
    npx ahp handoff receive HOF-... .
    npx ahp sync check . --require-remote

08 / Límites

AHP+ informa. Tú decides.

READY dice que la continuidad cuadra. No significa que exista permiso para actuar. Estas acciones siempre quedan fuera del protocolo:

  • commit
  • push
  • pull
  • merge
  • publish
  • deploy
  • delete
  • payments
  • secrets

Contenido contrastado con la CLI y la documentación incluidas en @jossuealcala/ahp-plus 1.4.1. La evidencia de esta página corresponde a una ejecución local observada el 12 de septiembre de 2026; no presenta adopción externa como hecho.