#+TITLE: The Master Memex: A Personal Software Foundry
#+AUTHOR: Amr
#+CREATED: [2026-03-17 Tue]
#+UPDATED: [2026-04-08 Wed]
#+FILETAGS: :memex:psf:org-agent:lisp:sovereignty:

* Overview
The *Master Memex* is a sovereign, neurosymbolic intelligence organization system. It is not merely a collection of notes, but a live, programmable environment—a **Personal Software Foundry (PSF)**—where a human (the Sovereign Executive) and agentic co-processes (the `org-agent` kernel and Gemini CLI) collaborate within a shared address space.

This system synthesizes three core organizational methodologies into a unified "Lisp Machine" experience:
- *Zettelkasten:* For atomic, evergreen, and interlinked knowledge.
- *GTD (Getting Things Done):* For rigorous task tracking and project execution.
- *PARA:* For high-level structural organization across Projects, Areas, Resources, and Archives.

* The Philosophy: The Executive Soul
Every action within this Memex is governed by the *Core Alignment Invariants* defined in [[file:notes/org-skill-agent.org][The Executive Soul]]. These mandates ensure that the system remains:
1. *Sovereign:* Independent of centralized, proprietary platforms.
2. *Transparent:* All reasoning is fully auditable in the Org-mode "Thought Stream."
3. *Zero-Bloat:* Minimalist, modular, and free of "just-in-case" complexity.
4. *Sustainable:* Offline-first and functional on a 100-year horizon.

* The Architecture: Functional Zones
The workspace is strictly divided into these zones to facilitate both human ergonomics and machine navigation:

- [[file:inbox/README.org][Inboxes]]: Zero-friction capture point for raw thoughts and tasks.
- [[file:daily/README.org][Dailies]]: Immutable chronological logs and fleeting notes.
- [[file:notes/README.org][Notes]]: Atomic, concept-based, interlinked "Evergreen" knowledge (Zettelkasten).
- [[file:projects/README.org][Projects]]: Active, time-bound efforts with a defined "Done" state.
- [[file:areas/README.org][Areas]]: Ongoing spheres of responsibility (Health, Finances, etc.).
- [[file:resources/README.org][Resources]]: External reference material and raw literature.
- [[file:system/README.org][System]]: Configuration, AI skills, and the Lisp kernel.

* The Agentic Inhabitants
The Memex is inhabited by autonomous agents that operate as "System 1" (probabilistic/neural) and "System 2" (deterministic/symbolic) layers:

** [[file:projects/org-agent/README.org][org-agent (The Kernel)]]
A Common Lisp microkernel that maintains a live, threaded Object-Store in RAM. It uses Org-mode as its native Abstract Syntax Tree (AST), allowing it to "perceive" and "act" on the Memex with structural precision.

** Gemini CLI
A strategic orchestrator that handles large-scale batch tasks, research, and planning. It operates according to the *PSF Consensus Loop* (Demand -> Blueprint -> Success -> Build -> Chaos -> Memory).

* Core Workflows: The Life of a Thought
1. *Capture:* Raw information enters via the `inbox` (tasks) or `daily` logs (thoughts).
2. *Distill (The Scribe):* Automated agents periodically extract conceptual thoughts from the chronological logs into evergreen, atomic notes.
3. *Plan:* Multi-file or architectural changes trigger a *Flight Plan* in `system/plans/`, following the PSF Departmental gates.
4. *Execute:* The agent performs surgical edits, governed by System 2 safety checks.
5. *Verify:* All changes are validated via automated tests (TDD) before the "Success" gate is cleared.
6. *RCA (Memory):* Every bug or significant session triggers a *Root Cause Analysis* that is distilled back into the system's "Soul."

* Privacy: The Wall
Any heading or file tagged with *@personal* is strictly off-limits for LLM processing. These are treated purely symbolically by the agents, ensuring that the Sovereign Executive's private drafts never leave the local environment.

* Getting Started
- Read the [[file:notes/org-skill-agent.org][Executive Soul]] for alignment rules.
- Check [[file:gtd.org][gtd.org]] for active task sequences.
- Review [[file:system/plans/README.org][Active Flight Plans]] for ongoing architectural work.