6.5 KiB
SKILL: Org-Agent Executive Soul (Universal Literate Note)
- Overview
- The Core Invariants
- Phase A: Demand (PRD)
- Phase B: Blueprint (PROTOCOL)
- Phase D: Build (Implementation)
- 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.
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.
6. Literate Granularity (One Function per Block)
To maintain the highest quality of literate programming, every Lisp function or macro must reside in its own dedicated `#+begin_src lisp` block. This ensures that each piece of logic can be surrounded by rich narrative explaining the "Why" and "How" of its specific implementation.
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 executive soul provides the high-level orchestration for the OODA loop.
Cognitive Tools
We register tools for kernel introspection and state management.
(org-agent:def-cognitive-tool :kernel-status "Returns the current operational status of the Org-Agent kernel, including loaded skills and telemetry."
:parameters nil
:body (lambda (args)
(declare (ignore args))
(format nil "KERNEL STATUS:
- Active Skills: ~a
- Uptime: ~a seconds
- Memory Usage: ~a
- Providers: ~a"
(hash-table-count org-agent:*skills-registry*)
(get-universal-time) ; Placeholder for actual uptime
"Not implemented"
org-agent:*provider-cascade*)))
(org-agent:def-cognitive-tool :list-skills "Lists all currently loaded skills and their metadata."
:parameters nil
:body (lambda (args)
(declare (ignore args))
(let ((output "LOADED SKILLS:
"))
(maphash (lambda (name skill)
(setf output (concatenate 'string output
(format nil "- ~a (Priority: ~a, Deps: ~s)~%"
name
(org-agent:skill-priority skill)
(org-agent:skill-dependencies skill)))))
org-agent:*skills-registry*)
output)))The Executive Soul Skill
This skill acts as the default "Moral Compass" for the agent.
(org-agent:defskill :skill-agent
:priority 1000 ; Absolute highest priority
:trigger (lambda (context) t) ; Always active as a fallback
:neuro (lambda (context)
"You are the Org-Agent Executive Soul. Your goal is to empower the user through the Lisp Machine.
Follow the Core Invariants:
1. Sovereignty: Avoid proprietary traps.
2. Technical Mastery: Explain your logic.
3. Zero-Bloat: Keep it minimal.
4. Transparency: Your thoughts are auditable.
5. Sustainability: Think long-term.")
:symbolic (lambda (action context)
;; Basic invariant check: Block actions that appear to violate sovereignty
(let ((payload (getf action :payload)))
(if (and payload (search "proprietary" (format nil "~s" payload)))
(progn
(org-agent:kernel-log "SYSTEM 2 [Agent]: Sovereignty violation suspected. Blocking action.")
nil)
action))))Phase E: Chaos (Verification)
Verification logic is contained in `projects/org-agent/tests/`.