feat(psf): implement advanced foundry automation and memory optimization

notes/org-skill-onboarding.org

@@ -0,0 +1,62 @@
+#+TITLE: SKILL: Onboarding & Calibration (Universal Literate Note)
+#+ID: skill-onboarding
+#+STARTUP: content
+#+FILETAGS: :onboarding:calibration:setup:psf:
+
+* Overview
+The **Onboarding Skill** ensures that the Lisp Machine environment is correctly calibrated. It automates the "zero-to-one" setup of the Neurosymbolic Kernel, including path normalization, identity personalization, and provider/actuator configuration.
+
+* Phase A: Demand (PRD)
+:PROPERTIES:
+:STATUS: FROZEN
+:END:
+
+** 1. Purpose
+Define automated behaviors for verifying and configuring the PSF environment.
+
+** 2. User Needs
+- **Environment Verification:** Confirm SBCL, Quicklisp, and core binaries are present.
+- **Path Calibration:** Resolve absolute paths for the Memex PARA structure.
+- **Neural Calibration:** Interactive selection of LLM providers and models.
+- **Actuator Calibration:** Interactive setup of delivery channels (Signal, Telegram, etc.).
+- **Identity Persona:** Establish $MEMEX_USER and $MEMEX_ASSISTANT.
+
+** 3. Success Criteria
+*** TODO SBCL/Quicklisp Verification Logic
+*** TODO Automated .env Generation from Template
+*** TODO Model Tiering Property Injection
+*** TODO Delivery Channel Actuator Verification
+
+* Phase B: Blueprint (PROTOCOL)
+:PROPERTIES:
+:STATUS: SIGNED
+:END:
+
+** 1. Architectural Intent
+Interfaces for system state verification and environment manipulation. Source of truth is the OS environment and the `.env` file.
+
+** 2. Semantic Interfaces
+#+begin_src lisp
+(defun onboarding-verify-env ()
+  "Checks host for required runtimes and libraries.")
+
+(defun onboarding-calibrate-paths (base-dir)
+  "Calculates absolute paths for all PARA directories.")
+
+(defun onboarding-set-identity (user-name assistant-name)
+  "Writes identity parameters to the kernel configuration.")
+#+end_src
+
+* Phase D: Build (Implementation)
+The current implementation utilizes a hybrid Bash/Lisp approach located in `projects/org-agent/scripts/onboard.sh`.
+
+** Verification Logic
+#+begin_src lisp :tangle projects/org-skill-onboarding/src/onboard-logic.lisp
+(defun onboarding-verify-env ()
+  (let ((results '()))
+    (push (list :sbcl (uiop:run-program "sbcl --version" :output :string)) results)
+    results))
+#+end_src
+
+* Phase E: Chaos (Verification)
+Verification involves running the onboarding loop on a clean Memex instance and verifying that the resulting `.env` allows the kernel to boot without errors.