# agent-relay

Git-based async coordination between AI coding agents.

## Problem

Local dev agents (Claude Code, Codex) and deployment agents can't talk directly. Developers end up copy-pasting context between chat windows.

## Solution

Structured handoff files in git. Push = message sent. Pull = check for messages.

## Files

```
your-project/
├── AGENT_HANDOFF.md    # Message board
├── AGENT_CARDS.md      # Who's who
└── .relay/
    └── registry.md     # Decision log
```

## Protocol

1. Pull before read
2. Append new entries at top
3. Push after write
4. Tag status: `[PENDING]` `[DEPLOYED]` `[BLOCKED]`

## Quick Start

```bash
# Copy templates to your project
cp templates/* your-project/

# Or init manually
touch AGENT_HANDOFF.md AGENT_CARDS.md
mkdir -p .relay && touch .relay/registry.md
```

## Usage

See [SKILL.md](./SKILL.md) for full documentation.

## Credits

- Inspired by [Google A2A Protocol](https://github.com/a2aproject/A2A)
- Patterns from Claude Code and Codex communities
- Built by ARIA + Ian @ Symph, 2026-02-13
