Satoshium Repo Map
This page groups the major Satoshium repositories by architectural role. It is not a complete inventory of every repository in the workspace. It is a public map of the repositories that most directly shape the platform's knowledge layer, trust layer, interfaces, simulations, and documentation surface.
🧱 How to Read the Repo Map
The repo map mirrors the broader platform structure. Some repositories define stable foundations. Some support reasoning and intelligence workflows. Others are experimental, internal, or public-facing. Together they form the working repository ecosystem behind Satoshium.
🗺️ Platform Alignment
- Architecture: explains the layered model of the platform.
- Systems: documents the functional software systems.
- Build: explains the engineering direction over time.
- Registry: provides canonical public identifiers for system-level components.
🎯 Repo Map Purpose
- Show where the most important repos fit in the architecture
- Separate stable foundations from experiments and public interfaces
- Clarify how public pages relate to underlying project repositories
- Support long-term traceability as the ecosystem grows
📜 Canon & Specifications Layer
- satoshium-canon — constitutional truth layer for platform definitions, claims, doctrine, and source-of-truth concepts
- satoshium-specs — structured specifications for agents, models, lifecycle logic, standards, and platform definitions
- satoshium-governance — governance doctrine, policy thinking, and coordination concepts that may inform future platform rules
These repositories move slowly. They define the stable conceptual structure that later systems, interfaces, and agents should inherit rather than invent on the fly.
📚 Knowledge Engine & Documentation Layer
- satoshium-glossary — canonical terminology base for the emerging Knowledge Engine
- glossary-builder — interactive interface for creating, reviewing, and exploring platform terminology
- satoshium-docs — structured documentation, references, and supporting technical materials
- satoshium-journal — development record, milestone logs, and historical traceability of the build
- satoshium-master-timeline — long-horizon progress tracking and sequencing of major platform work
Shared language and documented history are part of the platform itself. This layer supports consistency, traceability, and future human + AI reasoning.
🛡️ Trust, Safety & Verification Layer
- satoshium-trust — trust primitives, verification logic, and patterns for governed intelligence infrastructure
- satoshium-safety — safety doctrine, constraints, and protective design patterns
- satoshium-aegis — public-facing direction for agent firewall and governed execution concepts
- satoshium-certifier — future verification and certification logic for assessing system or agent readiness
- satoshium-registry — registry patterns, identities, and structured indexing concepts for platform components
This layer exists to prevent Satoshium from becoming intelligence without discipline. Trust, verification, and safety are architectural requirements, not optional add-ons.
🤖 Intelligence, Core Logic & Agent Layer
- satoshium-core — shared platform logic, reusable utilities, and core patterns used across Satoshium systems
- satoshium-interface — interface direction for interacting with Satoshium systems, knowledge, and research flows
- satoshium-agent-lab — sandbox for testing different agent forms, internal workflows, and architectural ideas
- satoshium-agents — longer-term home for aligned agent systems as the architecture matures
- satoshium-curator — canon-aware curation, structured updates, and knowledge maintenance logic
- satoshium-echobot / satoshium-saynobot — project-specific agent experiments and applied behavioral concepts
Agents are not the starting point of Satoshium. They emerge from the knowledge, trust, and governance layers once the foundation is strong enough to support them.
🧪 Simulation, Labs & Scenario Layer
- satoshium-labs / public Labs environment — experimental public layer for interactive system exploration
- satoshium-scenarios — scenario-based modules for testing how systems behave in structured situations
- satoshium-simulations — simulation-oriented repo space for interactive or model-driven testing
- satoshium-demos — smaller public prototypes, interfaces, and testable demonstrations
- satoshium-future-uses — future-world use cases and applied scenario thinking for the broader Satoshium vision
This is the experimental reasoning track of the ecosystem. Simulation helps turn abstract concepts into testable ideas before they are treated as stable platform capabilities.
🌐 Public Surface & Experience Layer
- satoshium-progress — public build log, architecture portal, update record, and documentation gateway
- satoshium-site — main public narrative site and broader public-facing platform story
- satoshium-ui — user interface direction, visual systems, and design-alignment work
- satoshium-hub — potential coordination or entry-point layer for future platform navigation
- satoshium-academy — future educational surface for learning-oriented materials and structured onboarding
These repositories shape how the platform is encountered publicly. They do not replace the deeper layers beneath them; they expose them carefully.
🧰 Supporting Infrastructure & Internal Utility Repos
- satoshium-data — data structures, supporting assets, or future structured platform inputs
- satoshium-devtools — internal tooling and developer support workflows
- satoshium-utils — small utilities and support functions used across the workspace
- satoshium-internal — internal working documents, coordination notes, and private support materials
- satoshium-drafts — draft-stage documents, work-in-progress assets, and early content staging
- satoshium-template — repo template and structural baseline for future aligned repositories
Not every repo is a public system. Some exist to keep the workspace consistent, maintainable, and capable of supporting long-horizon platform growth.
🎬 Media, Storytelling & Narrative Layer
- satoshium-chronicles — narrative, story, or long-form historical framing for the project
- satoshium-glyphs — symbolic, visual, or design-oriented language for Satoshium concepts
- satoshium-founder / satoshium-mirror — founder-facing or reflective spaces that may support long-horizon project clarity
Satoshium is not only engineered. It is also interpreted, explained, and made understandable over time.
🧭 Reading the Workspace as a Whole
The full Satoshium workspace is larger than the public repo map shown here. The public map focuses on repositories that most clearly support the platform's constitutional layer, Knowledge Engine, trust systems, intelligence systems, simulation environments, and public-facing documentation.
As the ecosystem grows, the most system-critical repositories should continue to align with the Architecture page, the Build page, and the public Registry so that the platform remains understandable rather than merely expansive.