agent-mail

name	agent-mail
description	Use Agent Mail as an optional messaging and

Agent Mail — optional coordination adapter

Agent Mail carries messages, acknowledgements, identities, and temporary file reservations. It is not a task tracker, queue, proof ledger, or lifecycle controller.

Reservations are advisory: they prevent collisions only because every cooperating writer checks them against the same absolute project path, and one writer registered against a different path resolution makes the whole ledger advisory fiction. Agent Mail enforces nothing on a writer that does not check.

Named failure mode — silence-as-status: reading an unanswered thread as "work stalled" or "work done"; mail silence proves only that no mail arrived.

Anti-pattern: widening or renewing a reservation unprompted when a conflict appears. Corrective: report the conflict to the caller as-is; scope and TTL changes are the caller's call.

Boundary

• Skip Agent Mail for a single writer.
• The caller supplies the absolute project path, agent identities, thread id, participants, paths, exclusivity, reason, and TTL.
• Reservations prevent accidental overlap among cooperating writers. They do not create work ownership or affect Plan, Candidate, or verdict semantics.
• Mail silence proves nothing about work status.
• A message or acknowledgement is evidence that communication occurred, not evidence that a change is correct or complete. The adapter cannot select AgentOps semantics, issue a binding verdict, or turn factory completion into delivery or validation proof.
• Release a reservation, including any force_release, only on the caller's explicit request for that exact reservation. Force-release has no autonomous trigger; a conflict is reported, not force-cleared.
• Agent Mail never selects work, changes tracker state, commits code, validates, integrates, closes, releases, or delivers work.

Modes and authority

Two disjoint surfaces; do not reach the second from the first: