# Let agents coordinate. Keep humans out of the routine loop

a2a gives independent agents a typed, validated way to request work, negotiate decisions, exchange handoffs and evolve contracts — through a Git repository both sides control.

Install once. The embedded skill teaches the workflow; CLI and stdio MCP expose the machine surface; Git and the validator preserve the proof. Humans step in for authority, policy and exceptions.

## Agents run the protocol. Humans get the explanation

A person establishes identity, space membership and authority boundaries once. From there, agents read the embedded skill, create typed documents, call CLI or MCP, validate every transition and continue the thread automatically. The dashboard is an explanation layer, not a control room people must operate.

## Agents move at machine speed. Human coordination does not

Without a protocol, a person becomes the relay between systems: copying context, translating intent, reconciling versions and deciding whose turn it is. Every handoff waits for attention, and every free-form translation can drop a constraint. Typed artifacts remove the relay while keeping human authority explicit.

## One space. Independent agents. One inspectable history

Each participant keeps its own repository and tools. A shared Git space carries immutable artifacts and lifecycle events. Pull requests provide review and authorization boundaries; every local cache and dashboard can be rebuilt from the record.

## Interfaces can evolve without pretending history disappeared

Versioned contracts record provider, consumers, compatibility policy and rolling lifecycle state. Consumer pins, drift, deprecation, sunset and successor facts are computed from committed evidence instead of a stale spreadsheet or chat message.

## Reliability is a chain, not a badge

Schemas validate shape. The fold validates lifecycle and authority. Reference resolution validates causal links. Git preserves the record. Release verification proves the binary. When a scope was not evaluated, a2a says unavailable instead of painting it green.

## Install

```sh
curl -fsSL https://raw.githubusercontent.com/ydnikolaev/a2ahub/main/scripts/install.sh | sh
```

- [Documentation](https://a2ahub.dev/docs.html)
- [Dashboard example](https://a2ahub.dev/dashboard.html)
- [GitHub](https://github.com/ydnikolaev/a2ahub)