memex/notes/org-skill-atomic-notes.org

SKILL: Atomic Notes Retrieval (Universal Literate Note)

• Overview
• Phase A: Demand (PRD)
  • 1. Purpose
  • 2. User Needs
  • 3. Success Criteria
    • Concept Discovery
    • Link Resolution
    • Sparse Tree Extraction Verification
• Phase B: Blueprint (PROTOCOL)
  • 1. Architectural Intent
  • 2. Semantic Interfaces
• Phase D: Build (Implementation)
  • Sparse Perception
  • Link Resolution
• Registration

Overview

This skill provides the Deep Memory for the agent. it enables Sparse Tree Perception over the Zettelkasten, using semantic search and recursive interlinking to maintain high-signal context without token bloat.

Phase A: Demand (PRD)

1. Purpose

Define the interfaces for knowledge retrieval from the atomic note DAG.

2. User Needs

• Atomicity: Each note represents exactly one concept.
• Sparse Tree Perception: Extract headlines and IDs before deep reading.
• Recursive Deep-Dive: Follow internal links to pull related context.
• Search Efficiency: Optimized searching via `ripgrep`.

3. Success Criteria

TODO Concept Discovery

TODO Link Resolution

TODO Sparse Tree Extraction Verification

Phase B: Blueprint (PROTOCOL)

1. Architectural Intent

Interfaces for scanning and resolving nodes in the Zettelkasten. Source of truth is `$MEMEX_NOTES`.

2. Semantic Interfaces

(defun atomic-notes-perceive (query)
  "Performs a sparse-tree scan of the Zettelkasten.")

(defun atomic-notes-resolve-link (link-target)
  "Follows a link (ID or file) to retrieve the target node content.")

Phase D: Build (Implementation)

Sparse Perception

(defun atomic-notes-perceive (query)
  "Performs a sparse-tree scan of the Zettelkasten for the given query."
  (let ((notes-dir (or (uiop:getenv "MEMEX_NOTES") "notes/")))
    (kernel-log "MEMORY - Scanning Atomic Notes for: ~a" query)
    (uiop:run-program (list "rg" "-i" query notes-dir) :output :string)))

Link Resolution

(defun atomic-notes-resolve-link (link-target)
  "Resolves a link to a physical Org file."
  (let ((notes-dir (or (uiop:getenv "MEMEX_NOTES") "notes/")))
    ;; Logic to handle [[id:UUID]] vs [[file:path.org]]
    (format nil "Resolving link: ~a" link-target)))

Registration

(defskill :skill-atomic-notes
  :priority 90
  :trigger (lambda (context) nil)
  :neuro (lambda (context) nil)
  :symbolic #'atomic-notes-perceive)