feat(arch): finalize Universal Literate Note transition for all projects and skills

notes/org-agent.org

@@ -0,0 +1,62 @@
+#+TITLE: SKILL: Org-Agent Platform (Universal Literate Note)
+#+ID: skill-org-agent-platform
+#+STARTUP: content
+#+FILETAGS: :platform:kernel:lisp:psf:
+
+* 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)
+: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/`.