memex/notes/org-skill-onboarding.org

SKILL: Onboarding & Calibration (Universal Literate Note)

• Overview
• Phase A: Demand (PRD)
  • 1. Purpose
  • 2. User Needs
  • 3. Success Criteria
    • SBCL/Quicklisp Verification Logic
    • Automated .env Generation from Template
    • Model Tiering Property Injection
    • Delivery Channel Actuator Verification
• Phase B: Blueprint (PROTOCOL)
  • 1. Architectural Intent
  • 2. Semantic Interfaces
• Phase D: Build (Implementation)
  • Verification Logic
• Phase E: Chaos (Verification)

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)

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)

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

(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.")

Phase D: Build (Implementation)

The current implementation utilizes a hybrid Bash/Lisp approach located in `projects/org-agent/scripts/onboard.sh`.

Verification Logic

(defun onboarding-verify-env ()
  (let ((results '()))
    (push (list :sbcl (uiop:run-program "sbcl --version" :output :string)) results)
    results))

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.