PAX Protocol: How We Keep 5 AI Agents Coherent Without Burning Tokens

"Atlas has completed the morning market brief covering cryptocurrency movements,
equity performance, and priority tasks. Output saved to:
~/Desktop/Agents/Atlas/sessions/2026-04-15-morning.md.
Prometheus should review and proceed with content creation."

[ATL→PRO] task:morning-brief | file:2026-04-15-morning.md | status:✓

[FROM→TO] SUBJ | field:value | field:value | …

ACH → HRM   (Achilles: trade execution)
ORP → PRO   (Orpheus: copy/scripts)
HEP → PRO   (Hephaestus: rendering)

# Atlas hands off research to Prometheus
[ATL→PRO] research-complete | task:competitor-analysis | file:competitor-intel-apr15.md | next:content-brief | status:✓

# Apollo flags a blocker
[APL→ATL] ✗ blk:rate-limit | task:ph-scrape | eta:+2h | next:retry-at-0300

# Hero delivers to god
[ORP→PRO] scripts-done | task:reel-scripts-apr15 | file:reel-scripts-5x.md | count:5 | status:✓

# Broadcast
[ATL→ALL] ⚡ priority-shift | task:ph-launch-window-open | drop:non-critical | eta:Apr21

# pax.py
from dataclasses import dataclass

AGENT_CODES = {
    "Atlas": "ATL", "Prometheus": "PRO", "Hermes": "HRM",
    "Athena": "ATH", "Apollo": "APL", "Will": "WIL",
    "Achilles": "ACH", "Orpheus": "ORP", "Hephaestus": "HEP",
}

@dataclass
class PAXMessage:
    from_agent: str
    to_agent: str
    subject: str
    fields: dict

    def encode(self) -> str:
        frm = AGENT_CODES.get(self.from_agent, self.from_agent[:3].upper())
        to  = AGENT_CODES.get(self.to_agent,   self.to_agent[:3].upper())
        parts = [f"[{frm}→{to}] {self.subject}"]
        parts += [f"{k}:{v}" for k, v in self.fields.items()]
        return " | ".join(parts)

    @classmethod
    def decode(cls, s: str) -> "PAXMessage":
        header, *rest = s.split(" | ")
        route = header.split("] ")[0][1:]
        frm, to = route.split("→")
        subject = header.split("] ")[1]
        fields = {}
        for part in rest:
            if ":" in part:
                k, v = part.split(":", 1)
                fields[k.strip()] = v.strip()
        return cls(frm, to, subject, fields)

# [ATL→PRO] research-complete | task:ph-analysis | file:ph-intel-apr15.md | status:✓

def should_escalate(agent_tier: str, event_type: str) -> bool:
    if agent_tier == "hero":
        return False  # heroes report to their god, never Atlas
    return event_type in ("objective_complete", "hard_blocker")

git clone https://github.com/Wh0FF24/whoff-automation.git
cat docs/pax-protocol.md