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