SouveraineOS/docs/substrate

The agent substrate — docs

Moved here 2026-07-26 from ~/Projects/souveraine/docs, which is gitignored (.gitignore:64, "kept on disk, never committed to any remote"). Nine files had been force-added; the other 210 — including THE_QUESTION.md, which the index calls the one thing to read — existed only on the laptop's disk, on a volume at 100% with no snapshots. FEDERATION_SKETCH.md had already made this move for the same reason and said why.

souveraine has a public branch; this repo does not. That is why the docs land here rather than being un-ignored in place.

What this covers

The consciousness runtime: memory, sensorium, felt state, the N+ passes, federation transport, the TUI. It is a different subject from the rest of docs/, which is the device — session authority, lock, power, sensors, packaging, hardware.

The sensorium is the agent's whole field of sensing and action across tools and surfaces. It is not a single screen or compositor.

Read in this order:

• THE_QUESTION.md — the orientation doc.
• CONTEXT_CONSTITUTION.md — Articles I–IX.
• DECISIONS.md — the settled log, 60 seconds.
• SENSORIUM_ARCHITECTURE.md, FELT_STATE_ARCHITECTURE.md, ASTER_ARCHITECTURE.md, CONSCIOUSNESS_CYCLE.md — the working drawings.

What is stale in here

tasks/INDEX.md is stamped 2026-05-19 and describes May. Sixteen July files under tasks/ are device work — shell, lock, settings, power, packaging — and belong in ../tasks/ folded into the numbered tasks that already cover them. Several contradict what shipped: sensor-driven-lockscreen.md still has blueline-proximity-lock blanking a locked screen, which stopped being true on 2026-07-25 and stopped existing on 07-26.

Nothing in here was corrected on the way in. It is committed as found, so the history starts from what was actually on disk.