Jossue AlcaláCreate · Build

Owned product · Open source

AHP+ — Agent Handoff Protocol Plus

AHP+ keeps the thread of the work inside the project: what was done, what was checked, and what comes next. You can switch assistant, account, or computer without starting over.

Write to meSee the product
AHP+ — Agent Handoff Protocol Plus home page
Real screenshot of the project
Own product
type of project
Node.js · JSON
main tools
10
tools I used

01 · The challenge

What was going on

Context

Assistants remember each conversation differently, but that memory cannot always be checked and does not travel with the code. AHP+ 1.4.1 turns important context into repository files so Codex, Cursor, Claude Code, OpenCode, ChatGPT, or another agent can orient itself before acting.

The problem

Let context travel with the project without turning into paperwork. It had to be easy for a person to read, have a structure an agent could check, and make clear that no automation takes decisions that belong to a person.

My part

I created and designed AHP+. I defined the 1.4.1 specification, certainty and evidence model, public CLI, adapters, sealed handoffs, causal messaging, project rooms, per-device identity, and authority boundaries.

02 · How I solved it

How I decided to solve it

  1. 01

    Every project keeps its operating memory in .ahp/: state, decisions, proof, locks, and the next action travel with the work.

  2. 02

    Every claim says how certain it is. Causal events and handoffs are verified before they are used as the point to resume work from.

  3. 03

    You ask in plain language from your editor (IDE), and it runs through a command-line tool (CLI) that gives the same result every time. Anything that leaves the project still needs a person to authorize it.

03 · What I made

What got built

  • Open specification and AHP+ 1.4.1 CLI, published as @jossuealcala/ahp-plus under Apache-2.0.
  • One-command setup, project pulse, bounded context, records, checkpoints, cooperative locks, and handoffs.
  • Adapters for Cursor, OpenCode, Codex, Claude Code, ChatGPT, and generic agents, with bounded consultation and project rooms.
  • Per-device Ed25519/X25519 identities, AES-256-GCM envelopes, and signed receipts for authorized transport.

04 · Charts

The numbers as charts

ahp-continuity

How the work moves from one tool to the next

AHP+ records what was done, what was checked, and what is left in files that travel with the code.

  1. 01
    Your project

    The code, images, tests, and documentation live in the repository.

  2. 02
    .ahp/ folder

    Here AHP+ records where the project stands, what was tested, what the risks are, and what comes next.

  3. 03
    The next tool

    Before continuing, it reads those records and confirms they match the repository.

AHP+ keeps a record of the context; review by a person is still required.

ahp-certainty

How much each entry can be trusted

Every record carries a label that separates what was checked from what is only assumed.

  1. 01
    VERIFIED

    Checked against a file, a command, or a direct source. Safe to decide on.

  2. 02
    USER_CONFIRMED

    The person in charge confirmed it. Also safe to decide on.

  3. 03
    INFERRED

    A reasonable assumption: usable as a hypothesis, never as fact.

  4. 04
    CONFLICTED

    Two sources disagree. It halts any decision that depends on it.

05 · How it turned out

What changed in the end

  • AHP+ 1.4.1 is published and installable from npm or GitHub.

  • In this portfolio, the 1.4.1 CLI was executed: strict verification of 21 files, a Claude handoff received as READY, and a causal reply stored in a shared room.

  • The local proof remains LOCAL_CAPTURED: it proves persistence and integrity in the repository, not native chat injection or remote transport.

What I would not compromise on

  • The project is the source of truth, not the chat.
  • Nothing counts as done without proof.
  • A person authorizes what matters.

06 · Command guide

How to install and use AHP+ in your tool

The guide explains what AHP+ 1.4.1 does, shows a real run and tells you how to install it with one command. It also has every instruction ready to use in the terminal or in the chat.

Open Command Atlas

07 · Technology

What it is made with

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

More cases

Other projects you can review

Want something like this for your business?

If you work with several AI assistants and lose the thread when switching between them, write to me and I will show you how I solve it.

Write to me