Record the layered src decision and the pdu-to-message edge

2026-09-30 20:21:59 +02:00
parent 980e9d4569
commit 92479d697d
5 changed files with 17 additions and 11 deletions
@@ -795,6 +795,13 @@ rule and an index of the titles below.
  fail on every developer machine, and a committed key leaks in a public repository. Valid while the
  dev image has no openssl.

+- **`src/` is grouped by layer, and imports point down the layers.** Maintainer's call, 2026-09-30,
+  building [plan 3](comprehension-rewrite/plan-3.md): `codec/`, `protocol/`, `messages/`, `session/`,
+  `client/`, `server/`, with the [map](../AGENTS.md#architecture) naming the direction. Serves goal
+  8's reshapeable internals, which a reader has to find before reshaping: every comprehension panel
+  navigated by AGENTS.md's map rather than the flat tree it described. Rejected: `src/` flat until a
+  module has to move for another reason.
+
 - **`test/` stays flat, and a file there is named for the question it answers rather than for the
  module it covers.** Architecture review, 2026-09-08, at 18 test files: what keeps that count honest
  is the naming rule rather than a tree — `operator-receipts.test.ts` holds a corpus defined by where