amr/memex
1
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

docs: overhaul README.org and remove redundant README.md

Browse Source
This commit is contained in:
Amr Gharbeia
2026-04-08 11:37:44 -04:00
parent 678097088e
commit a7861cd806
2 changed files with 43 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
README.org
View File

@@ -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.