diff options
| author | Christophe Besson <cbesson@gmail.com> | 2026-09-10 18:45:15 +0200 |
|---|---|---|
| committer | Christophe Besson <cbesson@gmail.com> | 2026-09-10 18:45:15 +0200 |
| commit | 481d1ef89fa89366a6484a703491dee2c767cdfc (patch) | |
| tree | 5b9acc624c4c79247557c659dace24ec85f140f3 /docs/MESHBAY_NODE_PROTOCOL.md | |
| parent | d82a0e7eec97844cd5eaf8aa49315146d5ed3d33 (diff) | |
| download | meshbay-481d1ef89fa89366a6484a703491dee2c767cdfc.tar.gz | |
docs(claude): cut the architecture, keep the lessons
CLAUDE.md was half a second specification. It carried summaries of three
security reviews, the invite redesign, per-node identity, the desktop client, a
protocol-version history and a sixty-row module table — all of it now in
MESHBAY_DESIGN.md, and some of it wrong: an errata list asserted a keystore
parameter that had been raised months earlier, and the module table pointed at
two implementations that no longer exist.
An errata list beside a specification is a second specification, and the older
one wins by being read first. Those sections become a pointer table naming which
part of the design document answers which question.
What stays is what has no other home: the conventions, and the engineering
lessons — the ones that are not deducible from the design because they are what
the code and the platforms actually do. They keep every word.
The module table stays as locators, stripped of the design prose it duplicated,
with a note kept only where it is a rule about editing the code. Every path in
it was verified to exist; two were wrong, and the harness directory was wrong
throughout.
Two references to files outside the repository are gone from the reference
table — a document about this repository should not send a reader somewhere they
cannot follow. The rules about that directory stay, because they are rules about
what must never be committed.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YVoHVCcfBqud6ZjG4db3y7
Diffstat (limited to 'docs/MESHBAY_NODE_PROTOCOL.md')
0 files changed, 0 insertions, 0 deletions