#+TITLE: SKILL: Brain Mapper Agent (Universal Literate Note)
#+ID: skill-brain-mapper
#+STARTUP: content
#+FILETAGS: :meta-cognition:telemetry:psf:

* Overview
The **Brain Mapper Agent** provides the system with meta-cognitive capabilities. It enables visualization and optimization of the internal "Skill Graph" through real-time telemetry analysis.

* Phase A: Demand (PRD)
:PROPERTIES:
:STATUS: FROZEN
:END:

** 1. Purpose
Define the interfaces for self-introspection and skill hierarchy optimization.

** 2. User Needs
- **Transparency:** Explain cognitive hierarchy and decision priorities.
- **Self-Optimization:** Proactive priority adjustment suggestions.
- **Introspection:** Identify bottleneck or failing skills.

** 3. Success Criteria
*** TODO Introspective Trigger Verification
*** TODO Telemetry Synthesis Accuracy
*** TODO Optimization Command Generation

* Phase B: Blueprint (PROTOCOL)
:PROPERTIES:
:STATUS: SIGNED
:END:

** 1. Architectural Intent
Interfaces for skill registry introspection and priority manipulation. Source of truth is the live skill registry and telemetry bus.

** 2. Semantic Interfaces
#+begin_src lisp
(defun trigger-skill-brain-mapper (context)
  "Triggers on 'show me your brain' or 'skill graph'.")

(defun neuro-skill-brain-mapper (context)
  "Neural architect analysis of skill performance.")
#+end_src

* Phase D: Build (Implementation)

** Introspective Trigger
#+begin_src lisp :tangle projects/org-skill-brain-mapper/src/brain-logic.lisp
(defun trigger-skill-brain-mapper (context)
  (let* ((payload (getf context :payload))
         (text (or (getf payload :text) "")))
    (or (search "show me your brain" text :test #'string-equal)
        (search "skill graph" text :test #'string-equal))))
#+end_src

* Registration
#+begin_src lisp
(defskill :skill-brain-mapper
  :priority 95
  :trigger #'trigger-skill-brain-mapper
  :neuro #'neuro-skill-brain-mapper
  :symbolic (lambda (action context) action))
#+end_src