For agents, on top of README.md, which they read first.

Notes for agents

• New decision logic goes in a native-testable file (documents.rs, household.rs, wire.rs), not in the files that touch worker::*. The runtime files stay thin.
• documents::tests runs the real whiskers-conformance hub laws over a map; keep it green before running a host.