73 lines
2.4 KiB
Org Mode
73 lines
2.4 KiB
Org Mode
#+TITLE: SKILL: Atomic Notes Retrieval (Universal Literate Note)
|
|
#+ID: skill-atomic-notes
|
|
#+STARTUP: content
|
|
#+FILETAGS: :knowledge:retrieval:zettelkasten:psf:
|
|
|
|
* 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)
|
|
:PROPERTIES:
|
|
:STATUS: FROZEN
|
|
:END:
|
|
|
|
** 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)
|
|
:PROPERTIES:
|
|
:STATUS: SIGNED
|
|
:END:
|
|
|
|
** 1. Architectural Intent
|
|
Interfaces for scanning and resolving nodes in the Zettelkasten. Source of truth is `$MEMEX_NOTES`.
|
|
|
|
** 2. Semantic Interfaces
|
|
#+begin_src lisp
|
|
(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.")
|
|
#+end_src
|
|
|
|
* Phase D: Build (Implementation)
|
|
|
|
** Sparse Perception
|
|
#+begin_src lisp :tangle projects/org-skill-atomic-notes/src/retrieval-logic.lisp
|
|
(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)))
|
|
#+end_src
|
|
|
|
** Link Resolution
|
|
#+begin_src lisp :tangle projects/org-skill-atomic-notes/src/retrieval-logic.lisp
|
|
(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)))
|
|
#+end_src
|
|
|
|
* Registration
|
|
#+begin_src lisp
|
|
(defskill :skill-atomic-notes
|
|
:priority 90
|
|
:trigger (lambda (context) nil)
|
|
:neuro (lambda (context) nil)
|
|
:symbolic #'atomic-notes-perceive)
|
|
#+end_src
|