memex/README.org

The Master Memex: A Personal Software Foundry

• Overview
• The Philosophy: The Executive Soul
• The Architecture: Functional Zones
• The Agentic Inhabitants
  • org-agent (The Kernel)
  • Gemini CLI
• Core Workflows: The Life of a Thought
• Privacy: The Wall
• Getting Started

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 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:

• Inboxes: Zero-friction capture point for raw thoughts and tasks.
• Dailies: Immutable chronological logs and fleeting notes.
• Notes: Atomic, concept-based, interlinked "Evergreen" knowledge (Zettelkasten).
• Projects: Active, time-bound efforts with a defined "Done" state.
• Areas: Ongoing spheres of responsibility (Health, Finances, etc.).
• Resources: External reference material and raw literature.
• 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:

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 Executive Soul for alignment rules.
• Check gtd.org for active task sequences.
• Review Active Flight Plans for ongoing architectural work.