Replace the system atlas with three Archify diagrams - #11
Merged
Merged
Conversation
The first atlas was one isometric scene with 34 nodes. It was hard to read and it carried more prose than a diagram can hold. The new atlas is three flat diagrams. Each one answers a different question: how a measurement reaches the page, what runs in the browser, and what happens each morning. A landing page introduces them. The diagrams come from Archify, which compiles typed JSON into a self-contained HTML file. Each one passes the showcase quality profile with 9 of 9 artifact checks, and is contained and readable at 1440x900, 1600x1000, 1920x1080, and 2048x1320. The figures describe the dashboard at commit 4337697 of 2026-09-10. The earlier atlas described 2026-08-23, when the system had 5 reservoir providers. It now has 9, and 406 reservoirs. The generated files fail six html-validate rules inside the Archify viewer chrome, never inside a diagram. A scoped .htmlvalidate.json turns those rules off for the diagrams folder only. Every hand-written page keeps the full ruleset. Verification: - node --check assets/js/site.js - npx html-validate@11.6.2 "**/*.html" - git diff --check - Checked the landing page at 320, 768, 1024, and 1440 CSS pixels, and checked every internal link and asset path. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The exemption was approved on 2026-09-11. The reason is the scope: the generated files are a portfolio artifact and no part of them ships inside the dashboard application. Write that reason down in the script and in the backlog, with a note not to reuse the exemption for application code or a hand-written page. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
The system atlas was one isometric scene with 34 nodes. It is now three flat diagrams, each answering a different question, with a landing page that introduces them.
The diagrams come from Archify (MIT). An agent writes typed JSON; Archify compiles it deterministically into a self-contained HTML file with search, relationship tracing, guided views, dark and light themes, and PNG or SVG export.
Facts are current again
The earlier atlas described 2026-08-23. These describe
origin/mainat4337697of 2026-09-10.The html-validate exemption
The generated files fail six rules inside the Archify viewer chrome, never inside a diagram:
aria-label-misuse,prefer-native-element,unique-landmark,attribute-misuse,heading-level, anddoctype-style. These are faults in the generator, and repairing 800 KB of generated markup on every publish would be fragile.scripts/publish-atlas.mjswrites a.htmlvalidate.jsonthat turns those rules off for thediagrams/folder only. Every hand-written page keeps the full ruleset. The list and the reason are in the script.Two of the six are real accessibility nits worth reporting upstream:
aria-labelon plain containers does nothing, and the card titles areh3under anh1with noh2.Verification
node --check assets/js/site.jsnpx html-validate@11.6.2 "**/*.html"passesgit diff --checkcleandeliverat the showcase profile, 9 of 9 artifact checks, 0 errors and 0 warningsvisual-check: contained and readable at 1440x900, 1600x1000, 1920x1080, and 2048x1320Notes
noindex, per the decision recorded inCONTENT-BACKLOG.mdon 2026-08-24..atlas/archify/src/in the dashboard repository. That folder is ignored by Git there, so they still exist on one Mac only. This carries forward the earlier arrangement rather than changing it.CONTENT-BACKLOG.mdalso carries a one-line folder rename fix that was already in the working tree.🤖 Generated with Claude Code