memex/system/plans/flight-plan-skill-audit.org

Flight Plan: Kernel API Hardening & Skill Audit

• Overview
• Phase A: Analysis (The Scientist)
  • Findings
• Phase B: Blueprint (The Architect)
  • [Coder] Surgical Tasks
  • [Tester] Verification Strategy
• NEXT Authorization Gate

Overview

Resolve the "No results" issue for LLM discovery by fixing package exports in the kernel and auditing the Org-Native skills for missing definitions.

Phase A: Analysis (The Scientist)

Findings

• *PROVIDER-CASCADE* is used by skills but not exported from the kernel.
• skill-model-explorer requires a functional OpenRouter backend, which failed to load.
• Multiple skills (skill-chat, skill-scribe) have undefined trigger/neuro functions.

Phase B: Blueprint (The Architect)

[Coder] Surgical Tasks

1. Harden Kernel Exports: Update the package definition in docs/README.org to export *PROVIDER-CASCADE* and ensure register-neuro-backend is correctly visible.
2. Audit Skill Explorer: Verify notes/org-skill-model-explorer.org logic and ensure it uses the correctly exported kernel symbols.
3. Surgical Skill Fixes: Audit the skills reporting READER ERROR in the logs and restore their missing Lisp blocks from the project's intended architecture.

[Tester] Verification Strategy

1. Clean Restart: Nuke caches, re-tangle, and boot the kernel.
2. Log Audit: Confirm 0 READER ERROR messages during the boot sequence.
3. Live Stimulus: Execute @agent list models and verify the table appears.

NEXT Authorization Gate

Sovereign, do you approve this plan to harden the Kernel API and audit the failing skills?