# Agent Handoffs

Write gotchas, API discoveries, and decisions here.
Other agents read this before starting work.

## Schema (enforced)

Every new HANDOFF entry MUST use the canonical labeled format below. `/task-done`
and `/go` (Phase 10) validate entries with `bin/ayf-validate-handoff.sh` before
writing them here; malformed entries are rejected.

Required fields (one per line): **To, From, Task, Date, Summary**. `Detail` is
optional. `Date` must match `YYYY-MM-DD HH:MM`.

```
---
To: target-agent (or "all")
From: agent-name
Task: 63
Date: 2026-07-11 18:30
Summary: one-line summary
Detail: what you discovered, why it matters, what to do about it
---
```

Validate an entry manually:

```bash
printf 'To: all\nFrom: me\nTask: 63\nDate: 2026-07-11 18:30\nSummary: x\n' \
  | bin/ayf-validate-handoff.sh -
```