From a7861cd8065be2132a3c0ed581279c09d2aa5c04 Mon Sep 17 00:00:00 2001 From: Amr Gharbeia Date: Wed, 8 Apr 2026 11:37:44 -0400 Subject: [PATCH] docs: overhaul README.org and remove redundant README.md --- README.md | 2 -- README.org | 71 +++++++++++++++++++++++++++++++++--------------------- 2 files changed, 43 insertions(+), 30 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index 85cad1b..0000000 --- a/README.md +++ /dev/null @@ -1,2 +0,0 @@ -# org - diff --git a/README.org b/README.org index b609195..15878e2 100644 --- a/README.org +++ b/README.org @@ -1,41 +1,56 @@ -#+TITLE: The Master Memex +#+TITLE: The Master Memex: A Personal Software Foundry #+AUTHOR: Amr #+CREATED: [2026-03-17 Tue] -#+BEGIN_COMMENT -The central hub and map of content for this personal intelligence organization. -#+END_COMMENT +#+UPDATED: [2026-04-08 Wed] +#+FILETAGS: :memex:psf:org-agent:lisp:sovereignty: -* The Master Memex +* 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 is the central hub for our knowledge management system, synthesizing three core methodologies: -- *Atomic Notes:* For evergreen, interlinked knowledge (Zettelkasten). -- *GTD (Getting Things Done):* For actionable task tracking and project execution. -- *PARA:* For high-level directory organization (Projects, Areas, Resources, Archives). +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 Architecture +* 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. -Our workspace is strictly divided into these functional zones: +* The Architecture: Functional Zones +The workspace is strictly divided into these zones to facilitate both human ergonomics and machine navigation: -- [[file:0_inbox/README.org][Inboxes]]: The zero-friction capture point for raw thoughts and tasks. -- [[file:1_daily/README.org][Dailies]]: Immutable chronological logs and fleeting notes. -- [[file:2_notes/README.org][Atomic Notes]]: Atomic, concept-based, interlinked notes (Zettelkasten). -- [[file:3_drafts/README.org][Drafts]]: Works in progress, essays, and active synthesis. -- [[file:4_published/README.org][Published]]: Final outputs and static snapshots of completed work. -- [[file:5_projects/README.org][Projects]]: Active, time-bound efforts with a clear definition of done. -- [[file:6_areas/README.org][Areas]]: Ongoing spheres of responsibility (e.g., Health, Finances). -- [[file:7_resources/README.org][Resources]]: External reference material and raw literature notes. -- [[file:8_archives/README.org][Archives]]: Cold storage for completed projects and inactive items. -- [[file:9_system/README.org][System]]: System configuration, AI skills, and automation scripts. +- [[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. -* Core Workflows -** 1. Capture (Anytime) +* The Agentic Inhabitants +The Memex is inhabited by autonomous agents that operate as "System 1" (probabilistic/neural) and "System 2" (deterministic/symbolic) layers: -Everything enters the system via the `inbox` (for actionable GTD tasks) or as a Fleeting Note in the `daily` log (for knowledge). Zero friction, no filtering. The `inbox` serves as a holding area for unfiled files or raw links. +** [[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. -** 2. Nightly Distillation (The Scribe) +** 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). -An automated AI sub-agent reads the daily captures and extracts conceptual thoughts into evergreen, atomic notes (Zettelkasten), leaving the original daily logs untouched. +* 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." -** 3. Weekly Maintenance +* 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. -Review active projects, clarify inbox items into actionable GTD tasks, and explore the Atomic Notes graph to merge concepts and forge new connections. +* 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.