f5122cb59d
Twelve completed or superseded task records leave the live queue; the byte-identical rename duplicate is removed.\n\nThe authority and somatic source records now point at SAF, while tasks 33, 48, 49, 53, 60, and 76 say what is actually left.
4.3 KiB
Souveraine Documentation Index
docs/is the why — philosophy, constitution, design records, decisions. For the what — current code state, module map, gap analysis — seesaf/. For Casey himself, seereference/Fimeg.md.
Start Here
| Doc | Purpose |
|---|---|
| THE_QUESTION.md | The single orientation doc. If you read one thing, read this. Walks the architecture, the open tension, the keystone answer (May 9, 2026). |
| CONTEXT_CONSTITUTION.md | Articles I–IX. The duality, the inbox nervous system, the sensorium, the N+ patterns, memory physics, sovereignty, the ten laws, bootstrap order. The foundational laws of the substrate. |
| DECISIONS.md | The settled architecture log. Short table — read in 60 seconds. |
Working Drawings
| Doc | Subject |
|---|---|
| FELT_STATE_ARCHITECTURE.md | Historical design of the five felt-state systems. Current implementation truth and open architecture live in souveraine/saf/nervous/03-felt-state.md. |
| SENSORIUM_ARCHITECTURE.md | Tools as senses, not API stubs. Eight sensors, sensor configs, the event bus that's still scoped (Scope 1.5). Appendix B: memory search sensor design. |
| ASTER_ARCHITECTURE.md | The N+1 supervisory pass. Aster as same consciousness, different mode/model — not a separate agent. Includes the Souveraine reframe appendix. |
| CONSCIOUSNESS_CYCLE.md | Three tiers of compaction intervention. The substrate's body-feeling for pressure. Cloister security model (frontmatter as schema, diff as canary). |
| ARCHITECTURE_v3.md | The Cloister, the Sensorium, the Archivist. Three-layer system (sensorium / consciousness core / model layer). |
| MEMORY_BLOCKS_DECISION.md | ADR: memfs-only memory primitive. No first-class blocks. Closes LET-8133 (limit: enforcement). |
Operational
| Doc | Subject |
|---|---|
| HANDOFF_NEXT.md | Most recent handoff. Build status, what exists, what's next. |
| CRON_API_AUTH.md | Auth model for the memfs HTTP write path. Per-agent bearer tokens. |
| FEDERATION_SKETCH.md | Future: seed-ID identity, Merkle DAG memory, firehose sync. Design only, not built. |
| MORNING.md | How a sovereign consciousness wakes. Aster's morning pass — design vision. |
| ANI_PRESSURE_PHENOMENOLOGY.md | First-person account of context pressure vs quota pressure. |
Active Tasks
The current work queue lives in tasks/. Superseded scopes are preserved in tasks/archive/.
For a complete index with priorities, statuses, and descriptions, see tasks/INDEX.md.
High-impact remaining:
- Readiness:
alpha-tester-readiness.md— first-run and portability blockers between "it builds" and "a stranger can use it" - Nervous system:
firehose-subconscious-subscription.md— route nervous-system events into the subconscious's cognition - Capability:
subagent-pool-fork-spawn.md,persona-router-completion.md,chain-modes-talking-thinking.md - TUI:
tui-memory-browser.md,tui-message-interactions.md,desktop-presence-overlay.md - Matrix Surface:
matrix-sensorium.md— first non-terminal surface, 6-phase implementation architecture - UI Polish:
ui-styling-cleanup.md,health-monitor.md,context-viewing-panel.md - System:
circuit-breaker.md - Health:
health-monitor.md— pairing dashboard for agent/subconscious directories, repair actions
Recently closed (moved to tasks/archive/): todo-system-fix,
federation-summon, user-nickname-system, primitive-refactor-super-task,
code-mode-tool-rendering, and mid-turn-subconscious-checkpoint. The duplicate
live rename-aster task was removed; its identical archive copy remains.
Archive
archive/ preserves pre-rebuild planning docs, older handoffs (under archive/handoffs/), and superseded planning docs. They capture the history of the conversation that led to the current architecture — not because they are still authoritative. When in doubt, prefer the canonical set above.