Jossue AlcaláCrear y Construir

Referencia oficial · AHP+ 1.1.0

AHP+ Command Atlas

Guía para instalar AHP+ y usarlo, ya sea escribiendo en la terminal o pidiéndolo en el chat de tu asistente de IA. Todos los comandos están listos para copiar.

40comandos listos para copiar

6plataformas con instalador

Gitdonde queda guardado todo

00 / Orientación

Terminal y chat no son lo mismo.

AHP+ es uno solo. Lo que cambia es dónde lo pides y qué se puede comprobar después.

TERMINAL

Aquí se ejecuta de verdad

Escribes el comando y la terminal responde. Esa respuesta sí sirve como prueba, porque cualquiera puede repetirla y obtener lo mismo.

shell
npx ahp verify . --strict

IDE / CHAT

Aquí solo lo pides

Le pides la operación al asistente. Él tiene que ejecutar el comando y mostrarte la salida: que lo diga no significa que lo hizo.

chat
/ahp verify strict

01 / Instalación

Instalación por sistema operativo.

Necesitas un proyecto que ya use Git y tenga al menos un commit, además de Node.js 20 o más nuevo. Ejecuta los comandos desde la carpeta principal del proyecto.

Abre Terminal y colócate en la carpeta principal del proyecto antes de ejecutar cada línea.

zsh
node --version
npm install --save-dev @jossuealcala/ahp-plus@latest
npx ahp init . --owner "Tu nombre" --project mi-proyecto
npx ahp doctor .
npx ahp verify . --strict

STABLE

@latest

La opción normal: la última versión probada.

terminal
npm install --save-dev @jossuealcala/ahp-plus@latest

PINNED

@1.1.0

Fija exactamente la versión que documenta esta guía.

terminal
npm install --save-dev @jossuealcala/ahp-plus@1.1.0

DEVELOPMENT

@next

Solo para probar lo que viene y reportar fallos.

terminal
npm install --save-dev @jossuealcala/ahp-plus@next

02 / Arranque

Revisión de arranque.

Corre esta secuencia cada vez que abras el proyecto, cambies de asistente o recibas una entrega. Te dice dónde estás parado antes de tocar nada.

terminal · all OS
npx ahp root .
npx ahp doctor .
npx ahp verify . --strict
npx ahp status .
npx ahp context . --format markdown --budget 8000

Después revisa los archivos .ahp/manifest.json, .ahp/state/project.json y .ahp/INDEX.md. Si el resumen guardado y lo que respondió el comando no coinciden, gana el comando: es lo que está pasando ahora.

03 / Terminal

Todos los comandos.

Busca por lo que quieres hacer, por el nombre del comando, o filtra por categoría. Todos los ejemplos usan la copia instalada en tu proyecto, con npx ahp.

40 comandos visibles

Repositorio

Empezar

Crea la carpeta .ahp/ dentro del repositorio en el que estás.

terminal
npx ahp init . --owner "Tu nombre" --project mi-proyecto

Repositorio

Confirmar dónde estás

Te dice qué repositorio y qué carpeta .ahp/ está usando, para no anotar en el proyecto equivocado.

terminal
npx ahp root .

Repositorio

Revisión general

Comprueba de una vez el proyecto, el alcance, la estructura de archivos y si todo es válido.

terminal
npx ahp doctor .

Repositorio

Revisión a fondo

Revisa estructura, referencias e integridad, y avisa si se colaron datos secretos.

terminal
npx ahp verify . --strict

Repositorio

¿Cómo va el proyecto?

Muestra en qué punto va, el estado de Git, los avisos activos y si el trabajo ya salió de tu computadora.

terminal
npx ahp status .

Repositorio

¿Ya está respaldado?

Compara lo que tienes en local con el servidor. Con --require-remote falla si todavía no subiste nada.

terminal
npx ahp sync check . --require-remote

Contexto

Resumen para máquinas

Entrega el resumen del proyecto en JSON, listo para que otro programa lo lea.

terminal
npx ahp context . --format json --budget 8000

Contexto

Resumen para personas

El mismo resumen en texto, para leerlo tú o pegarlo en un chat.

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

Contexto

Actualizar el resumen guardado

Reescribe el archivo .ahp/INDEX.md con el estado más reciente.

terminal
npx ahp brief . --budget 8000

Contexto

Marcar dónde te quedaste

Guarda un punto de la sesión al que puedas volver después.

terminal
npx ahp checkpoint . --session mi-sesion --summary "Límite validado" --next-action "Continuar"

Contexto

Ver el historial

Lista los puntos guardados y las entregas hechas hasta ahora.

terminal
npx ahp history .

Contexto

Historial de una sesión

Filtra ese historial para ver solo una sesión de trabajo.

terminal
npx ahp history . --session mi-sesion

Contexto

Anotar el rumbo

Actualiza en qué fase va el proyecto, cuál es el objetivo y cuál es el siguiente paso.

terminal
npx ahp set-state . --phase IN_PROGRESS --objective "Objetivo" --next-action "Siguiente paso" --confidence USER_CONFIRMED

Anotaciones

Decisión

Deja por escrito una decisión, para que después nadie tenga que recordarla de memoria.

terminal
npx ahp record decision . --title "Decisión" --status ACCEPTED --confidence USER_CONFIRMED

Anotaciones

Pendiente

Anota algo por hacer y en qué estado está.

terminal
npx ahp record task . --title "Implementar mejora" --status PLANNED --confidence USER_CONFIRMED

Anotaciones

Error

Anota un error que se puede reproducir a voluntad.

terminal
npx ahp record bug . --title "Fallo reproducible" --status OPEN --confidence VERIFIED

Anotaciones

Riesgo

Deja anotado un riesgo abierto para que no se olvide.

terminal
npx ahp record risk . --title "Riesgo de migración" --status OPEN --confidence VERIFIED

Anotaciones

Revisión aprobada o rechazada

Aprueba o rechaza una revisión de calidad. Para poner PASS hay que citar una prueba concreta (EVD-...).

terminal
npx ahp record qa . --title "Gate de aceptación" --status PASS --confidence VERIFIED --source EVD-...

Anotaciones

Requisito

Anota algo que el proyecto tiene que cumplir.

terminal
npx ahp record requirement . --title "Debe ser portable" --status ACCEPTED --confidence USER_CONFIRMED

Anotaciones

Prueba de que algo pasó

Guarda el resultado real de algo que se ejecutó: el comando, lo que devolvió y si terminó bien.

terminal
npx ahp record evidence . --title "Validación local" --type test --locator "npm test" --result "PASS: 18 pruebas" --confidence VERIFIED --exit-code 0

Anotaciones

Ver anotaciones

Lista todas las anotaciones o solo las de un tipo.

terminal
npx ahp list risk .

Anotaciones

Ver solo lo abierto

Deja fuera lo que ya se cerró.

terminal
npx ahp list task . --active

Anotaciones

Cerrar una anotación

Cierra una anotación explicando por qué.

terminal
npx ahp close RISK-... . --status CLOSED --reason "Mitigación verificada"

Anotaciones

Cambiar de decisión

Sustituye una decisión ya aceptada creando una nueva: la original nunca se reescribe, queda en el historial.

terminal
npx ahp supersede DEC-... . --title "Decisión revisada" --accept --confidence USER_CONFIRMED

Entrega

Preparar la entrega

Empaqueta el contexto para pasárselo a otra herramienta.

terminal
npx ahp handoff create . --from codex --to cursor --session feature-x --summary "Continuar"

Entrega

Revisarla antes de aceptar

Abre la entrega y comprueba que esté completa, sin aceptarla todavía.

terminal
npx ahp handoff inspect HOF-... .

Entrega

Aceptar la entrega

La acepta solo si el proyecto, el contenido y el commit coinciden con lo que dice.

terminal
npx ahp handoff receive HOF-... .

Varios a la vez

Escribir sin pisar a nadie

Cancela la escritura si alguien más movió el repositorio mientras tú trabajabas.

terminal
npx ahp checkpoint . --summary "Límite" --expected-head COMMIT --expected-state DIGEST

Varios a la vez

Avisar que estás trabajando

Deja un aviso de que estás en una parte del proyecto. Es un aviso de cortesía, no un candado.

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

Varios a la vez

Retirar el aviso

Quita tu aviso al terminar. El historial se conserva.

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

Migración

Ver qué se movería

Revisa la carpeta agent/ de la versión 1.0 y te dice qué haría, sin tocar ningún archivo.

terminal
npx ahp migrate . --plan

Migración

Hacer el cambio

Crea la estructura de la versión 1.1 y conserva intacta la carpeta agent/ original.

terminal
npx ahp migrate . --apply

Instaladores

Ver qué plataformas hay

Muestra para qué programas y asistentes existe instalador.

terminal
npx ahp adapter list

Instaladores

Ver qué instalaría

Muestra qué archivos crearía y con cuáles podría chocar, sin instalar nada.

terminal
npx ahp adapter install all .

Instaladores

Instalar en todas

Instala los seis: agente genérico, Claude, Cursor, OpenCode, Codex y ChatGPT.

terminal
npx ahp adapter install all . --apply

Instaladores

Instalar en una sola

Cambia PLATFORM por generic, claude, cursor, opencode, codex o chatgpt.

terminal
npx ahp adapter install PLATFORM . --apply

Versiones

Instalar la versión estable

Instala la última versión probada. Es la opción normal.

terminal
npm install --save-dev @jossuealcala/ahp-plus@latest

Versiones

Fijar una versión exacta

Instala exactamente la 1.1.0, la misma que documenta esta guía.

terminal
npm install --save-dev @jossuealcala/ahp-plus@1.1.0

Versiones

Probar lo que viene

Instala la versión en preparación. Solo para probar y reportar fallos, no para producción.

terminal
npm install --save-dev @jossuealcala/ahp-plus@next

Versiones

Desinstalar

Quita el programa. Tus anotaciones en .ahp/ y los instaladores siguen ahí.

terminal
npm uninstall @jossuealcala/ahp-plus

04 / CHAT

Comandos por plataforma.

Primero instala el adaptador desde la terminal, una sola vez. Después ya puedes pedir las cosas dentro del chat, con las palabras que verás abajo.

IDE / APP

Cursor

Añade el comando /ahp al chat de Cursor, para pedirlo sin salir del editor.

En terminal

terminal
npx ahp adapter install cursor . --apply

Directamente en el chat

  • CHAT
    /ahp doctor
  • CHAT
    /ahp verify strict
  • CHAT
    /ahp context
  • CHAT
    /ahp checkpoint resumen="Límite validado" siguiente="Crear handoff"
  • CHAT
    /ahp handoff to codex
  • CHAT
    /ahp receive HOF-...

IDE / APP

OpenCode

Añade el mismo comando /ahp en OpenCode. Se escribe igual que en Cursor.

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
  • CHAT
    /ahp receive HOF-...

IDE / APP

Codex

Instala la habilidad $ahp y deja las reglas del proyecto en AGENTS.md.

En terminal

terminal
npx ahp adapter install codex . --apply

Directamente en el chat

  • CHAT
    Usa $ahp para revisar este repositorio y mostrarme en qué punto va el proyecto.
  • CHAT
    Usa $ahp para marcar dónde nos quedamos y preparar la entrega a Cursor.
  • CHAT
    Usa $ahp para aceptar la entrega HOF-... y no edites nada si el resultado no dice READY.

IDE / APP

Claude Code

Conecta CLAUDE.md con las instrucciones de AHP+. Aquí se pide con lenguaje normal: no hay comando con barra.

En terminal

terminal
npx ahp adapter install claude . --apply

Directamente en el chat

  • CHAT
    Antes de continuar, corre con AHP+ la revisión general, la revisión a fondo y el resumen del proyecto.
  • CHAT
    Marca dónde nos quedamos y prepara la entrega de Claude a Codex, sin hacer commit ni push.
  • CHAT
    Acepta la entrega HOF-... con AHP+ y detente si algo no coincide.

IDE / APP

ChatGPT / Mobile

Instala AHP_MOBILE.md. Si el chat tiene terminal, puede ejecutar; si solo lee, tiene que decirlo.

En terminal

terminal
npx ahp adapter install chatgpt . --apply

Directamente en el chat

  • CHAT
    Lee AHP_INSTRUCTIONS.md. Corre la revisión de arranque con AHP+ y dime el proyecto, el commit, si el trabajo ya está respaldado, qué está bloqueado y cuál es el siguiente paso.
  • CHAT
    Si no tienes terminal: lee AHP_MOBILE.md, .ahp/INDEX.md y la entrega más reciente. No digas que revisaste, probaste, hiciste commit ni push, porque no puedes.

IDE / APP

Cualquier otro agente

Instala AHP_INSTRUCTIONS.md y un bloque en AGENTS.md, para agentes que no tienen instalador propio.

En terminal

terminal
npx ahp adapter install generic . --apply

Directamente en el chat

  • CHAT
    Sigue las instrucciones de AHP+ de este repositorio. Revisa antes de escribir y toma el repositorio como fuente de verdad, no la conversación.
  • CHAT
    Corre la revisión general, la revisión a fondo y el resumen del proyecto. Muéstrame la salida real y espera mi autorización antes de cualquier acción fuera del repositorio.

05 / Entrega

Pasar el trabajo a otra herramienta.

Una entrega deja por escrito en qué punto quedó todo y a qué repositorio y commit pertenece. Git es el que la transporta, y el commit y el push los autorizas tú.

  1. 01

    Marca dónde te quedaste

    Guarda un punto al que se pueda volver, antes de cambiar de herramienta.

    terminal
    npx ahp checkpoint . --session feature-x --platform codex --actor "Codex" --summary "Límite validado" --next-action "Recibir y continuar"
  2. 02

    Crea la entrega

    Di de qué herramienta sale, a cuál va y qué falta por hacer.

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

    Súbelo tú

    La entrega tiene que quedar confirmada en Git y disponible en el servidor. AHP+ no ejecuta Git ni te da permiso de publicarla: ese paso es tuyo.

  4. 04

    Verifica antes de continuar

    Quien recibe comprueba que la entrega esté completa y que corresponda a este repositorio y a este commit. Solo entonces empieza a editar.

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

06 / Migración

Si vienes de la versión 1.0.

Los proyectos de la versión 1.0 guardaban todo en una carpeta llamada agent/. Si es tu caso, no lo instales otra vez desde cero: usa la migración.

READ ONLY

1. Mira qué se movería

terminal
npx ahp migrate . --plan

Solo te informa qué encontró, a dónde iría y qué archivos podrían chocar. No modifica nada.

WRITE

2. Hazlo cuando ya lo revisaste

terminal
npx ahp migrate . --apply
npx ahp verify . --strict

Conserva la carpeta agent/ original. Si ya existe .ahp/, AHP+ se detiene en lugar de mezclar las dos.

07 / Límites

AHP+ anota y comprueba; no autoriza.

Que una entrega diga READY significa que los datos cuadran, no que haya permiso para actuar. Estas acciones siempre las decide una persona:

  • commit
  • push
  • pull
  • merge
  • publish
  • deploy
  • acciones destructivas
GitHubnpmVer caso de producto

Esta guía se preparó a partir de la documentación y la herramienta oficiales de AHP+ 1.1.0. Antes de copiar los comandos de instalación, confirma cuál es la versión publicada y revisa el changelog oficial.