63 lines
2.3 KiB
Org Mode
63 lines
2.3 KiB
Org Mode
#+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/`.
|