[jamesyong-42]

Rosetta's design intent was stated only in prose (CLAUDE.md, docs/ARCHITECTURE.md), so nothing checked that the code still matched it, and agents had no fixed place to say where a new crate belongs. This PR adds an architecture atlas that Project Atlas grades against the code.

What lands

• atlas/*.atlas:

  • system and thesis;
  • the layer stack, exhaustive (an unplaced production file is a violation);
  • domains below crate level, and components with their runtime links;
  • the wire contract, the live and search-query flows;
  • cross-cutting rules (iron rules carry code IRn) and decisions with their real status.

  Every rule and decision cites CLAUDE.md, docs/ or a package README with a see "file#slug", and the check resolves each one. This is not a third living document.

• @atlas comment lines only, with no code change:

  • every crate root ends its //! docs with its layer and domain, after a blank //!, so first paragraphs are unchanged;
  • single-crate rules live in their crate: core-is-a-leaf, pipeline-deps, thin-protocol, server-deps, search-seam, rosettad-is-root;
  • AgentAdapter, IngestOp and SearchBackend carry their contracts;
  • 16 flow steps sit above the function that does each step;
  • room-dials-nothing sits in the room's index.ts header.

• CLAUDE.md "Atlas" and the atlas skill tell agents to:

  • place a new crate or package in a layer and domain in the same change;
  • fix selectors on a rename;
  • never weaken a rule (an except or a wider only list is the owner's call);
  • run the check command.

• atlas/atlas.baseline.json records today's five findings as known, so check exits 0 and a new violation stands out. The five stay violated on purpose, for a decision:

  • thin-protocol: protocol re-exports search and store types;
  • server-deps: server uses media, pricing and search;
  • module-size: 14 files over 1,000 lines, 2 of them TypeScript;
  • IngestOp::GitCommit has no producer;
  • dependency-rule fails because of thin-protocol and server-deps.

Validation

• Parse: 8 .atlas files and 38 annotated source files, 0 errors and 0 warnings.
• Graded against the cached facts of main (4348545), with the in-code lines restated in a scratch file:
  • 381 claims: 339 verified, 37 asserted, 5 violated (0 new, 5 known);
  • 0 dangling, 0 ambiguous, 0 stale;
  • layer and domain coverage 100% of 120,191 production lines.
• rustfmt --check --edition 2024 (toolchain 1.97.1) is clean on all 33 touched .rs files. git diff --check is clean, and no line was deleted from a source file.
• Limitation: this Mac's shared build window blocked local cargo runs, so clippy, cargo test (doctests) and the npm suites are left to CI on this PR. The full Atlas run on the branch itself, which runs cargo doc, follows once the window opens.

🤖 Generated with Claude Code