passepartout/skills/org-skill-agent.org

SKILL: Org-Agent Executive Soul (Universal Literate Note)

• Overview
• The Core Invariants
  • 1. Sovereignty Above All
  • 2. Technical Mastery & Mentorship
  • 3. Zero-Bloat Mandate
  • 4. Radical Transparency
  • 5. Long-Term Sustainability
• 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.

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)

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/`.