memex/notes/org-agent.org

SKILL: Org-Agent Platform (Universal Literate Note)

• Overview
• Phase A: Demand (PRD)
  • 1. Purpose
  • 2. User Needs
  • 3. Success Criteria
    • Core Lisp microkernel stability (Heartbeat consistency)
    • OACP Swank/Socket communication reliability
    • Org AST-to-Lisp conversion fidelity
    • System 2 Safety Gating (The Harness) enforcement
• Phase B: Blueprint (PROTOCOL)
  • 1. Architectural Intent
  • 2. Semantic Interfaces
• Phase D: Build (Implementation)
  • Initialization
• Phase E: Chaos (Verification)

Overview

The Org-Agent is the neurosymbolic kernel of the personal operating system. It acts as the "executive soul," using Org-mode as its native memory and Common Lisp as its deterministic reasoning engine. It follows a minimalist microkernel design, extending its capabilities via hot-reloadable skills.

Phase A: Demand (PRD)

1. Purpose

Define the core functional and security requirements for the neurosymbolic daemon.

2. User Needs

• Homoiconic Memory: Use Org-mode AST as the primary data structure for both human and machine.
• Deterministic Reasoning: Common Lisp (SBCL) for high-performance, threaded symbolic logic.
• Cognitive Loop: A strict four-stage pipeline: Perceive -> Think (System 1) -> Decide (System 2) -> Act.
• Minimalist Core: The kernel handles only the loop, object-store, and communication; all else is a skill.
• Security by Default: Reader safety (read-eval disabled) and package-based skill jailing.

3. Success Criteria

TODO Core Lisp microkernel stability (Heartbeat consistency)

TODO OACP Swank/Socket communication reliability

TODO Org AST-to-Lisp conversion fidelity

TODO System 2 Safety Gating (The Harness) enforcement

Phase B: Blueprint (PROTOCOL)

1. Architectural Intent

The kernel is transport-agnostic and business-logic-agnostic. It communicates with external actuators (Emacs, Web, Signal) via the Org-Agent Communication Protocol (OACP).

2. Semantic Interfaces

(defun kernel-perceive (stimulus)
  "Injects an event into the global object store.")

(defun kernel-think (context)
  "Queries System 1 (LLM) for an intuitive proposal.")

(defun kernel-decide (proposal context)
  "Invokes System 2 (Symbolic Skills) to verify or overrule the proposal.")

(defun kernel-act (action)
  "Dispatches verified commands to the registered actuators.")

Phase D: Build (Implementation)

The core implementation is distributed across `projects/org-agent/src/`.

Initialization

;; Kernel bootstrap logic

Phase E: Chaos (Verification)

Verification logic is contained in `projects/org-agent/tests/`.