# CLAUDE.md — `peat-mesh`

Before doing any work in this repo, read **both** of:

1. `SKILL.md` (this repo) — the per-repo workflow, verification checklist, and scope guards.
2. `peat/SKILL.md` (in the sibling `peat` repo, if checked out alongside) — the ecosystem skill: hard invariants, cross-cutting anti-rationalization, the skill router across all peat-* repos.

If `peat/SKILL.md` isn't accessible (this repo checked out without the ecosystem anchor next to it), say so before proceeding — most architectural invariants live there, not here.

`AGENTS.md` is the Codex-specific guide. It overlaps with this file's "Quick orientation" but does not duplicate the workflow content in `SKILL.md`. Do not edit `AGENTS.md` to mirror skill content; keep them separate.

## Quick orientation

- **Repo role:** Mesh networking layer for the Peat ecosystem — pluggable transport, peer discovery, topology, routing, optional Automerge/Iroh CRDT sync, optional HTTP/WS broker.
- **Primary language:** Rust (edition 2021). Standalone library plus an optional `peat-mesh-node` binary behind feature flags.
- **Cheap sanity check:** `cargo check` (default features). For a fuller check before pushing: `cargo check --features node`.

## Hard rule

A task in this repo is not done until the verification checklist in `SKILL.md` produces evidence. "Seems right" or "the diff looks correct" is never sufficient.

GPG-signed commits are required by repo policy. Cross-repo changes require one PR per repo, linked through a tracking issue — not a single PR that reaches across repos.
