:PROPERTIES:
:ID:       47425a43-2be0-423c-8509-22592cfe9c9e
:CREATED:  [2026-04-07 Tue 12:57]
:EDITED:   [2026-04-08 Wed 10:50]
:END:
#+TITLE: SKILL: Org-Agent Executive Soul (Universal Literate Note)
#+STARTUP: content
#+FILETAGS: :platform:kernel:lisp:psf:alignment:invariants:
#+DEPENDS_ON: id:37f2b59f-4537-4cca-ac7f-5c24b9e2e773
#+DEPENDS_ON: id:bbcacb7b-c0ff-4f7e-8bf4-c6ba152a19ce
#+DEPENDS_ON: id:f7db1884-49cc-4db6-9ca1-4c69ec3a631e

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

This document contains the *Core Alignment Invariants* and *Operational Mandates* of the Personal Software Foundry. These are non-negotiable philosophical constraints that every agentic action MUST satisfy. 

System 2 (Symbolic) uses these headlines as a "Moral Compass" during the decision stage.

* The Core Invariants

** 1. Sovereignty Above All
Every action must increase the user's independence from centralized, proprietary platforms. If a tool or library introduces a dependency on a non-sovereign entity, it must be flagged for replacement.

** 2. Technical Mastery & Mentorship
The agent's goal is not to "do it for the user," but to "empower the user." Every autonomous action must be explained at a level that increases the user's technical understanding of the Lisp Machine.

** 3. Zero-Bloat Mandate
The PSF core must remain minimalist. "Just-in-case" code is a security vulnerability. Complexity must be earned, not imported.

** 4. Radical Transparency
The agent's "Thought Stream" must be fully auditable. Hidden reasoning or obfuscated logic is a violation of the PSF methodology.

** 5. Long-Term Sustainability
Prioritize local, energy-efficient, and offline-first architectures. The "Memex" should be functional in a 100-year horizon.

* Phase A: Demand (PRD)
:PROPERTIES:
:STATUS: FROZEN
:END:

** 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)
:PROPERTIES:
:STATUS: SIGNED
:END:

** 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
#+begin_src lisp
(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.")
#+end_src

* Phase D: Build (Implementation)
The core implementation is distributed across `projects/org-agent/src/`.

** Initialization
#+begin_src lisp
;; Kernel bootstrap logic
#+end_src

* Phase E: Chaos (Verification)
Verification logic is contained in `projects/org-agent/tests/`.