#+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.