Skip to content

Memory Cognitive Profiles

github-actions[bot] edited this page Jun 16, 2026 · 6 revisions

Cognitive Profiles

Cognitive profiles are pre-configured scoring presets that modulate how the memory system prioritizes, retrieves, and consolidates information. They act as a thalamic filter β€” adjusting the balance between similarity-driven and importance-driven recall to match different task contexts.

How Profiles Work

Every recall query is scored using the fused cognitive score formula:

$$ \text{score} = \alpha \cdot \text{similarity} + \beta \cdot \text{importance} \cdot \text{decay} $$

Where:

  • Ξ± (alpha) β€” Weight on vector similarity (how close is this memory to the query?)
  • Ξ² (beta) β€” Weight on learned importance (how important was this memory at ingestion?)
  • Ξ± + Ξ² = 1.0 β€” Always normalized

A profile sets Ξ±, Ξ², and optional modifiers (hyperfocus boost, lateral mode, episode pinning) to bias the scoring pipeline for a specific cognitive strategy.

Built-in Profiles

Standard Profiles

Profile Ξ± Ξ² Valence Filter Best For
BALANCED 0.6 0.4 All General-purpose recall
EXPLORING 0.8 0.2 All Broad discovery, creative exploration
DEBUGGING 0.3 0.7 Negative only (≀ -10) Precise error-matching, diagnostic search
RECALLING 0.4 0.6 Positive only (β‰₯ +10) Retrieving proven solutions and successes
CRITICAL 0.2 0.8 All Security audits, compliance checks, high-stakes

Advanced Profiles β€” Neurodivergent

These profiles go beyond Ξ±/Ξ² tuning β€” they activate specialized scoring mechanics in the 6-Phase Pipeline and model specific neurocognitive patterns.

Profile Ξ± Ξ² Biological Analog Special Mechanics
HYPERFOCUS 1.0 0.0 Monotropism [[Focus Mode
SYSTEMATIZER 0.3 0.7 Bottom-up processing (autism) [[Systemizer
DIVERGENT 0.8 0.2 Reduced Latent Inhibition (ADHD) [[Explorer
PARANOID_SENTINEL 0.2 0.8 Amygdala threat-detection Negative-only valence, mood-congruent threat recall
THE_EXECUTOR 0.3 0.7 Prefrontal executive function Heaviside Cliff (strictness=10.0), no lateral retrieval
HIGHLY_SENSITIVE 0.7 0.3 Sensory Processing Sensitivity Low flashbulb threshold, strong lateral inhibition
DEFAULT_MODE_NETWORK 0.2 0.8 Brain's resting state network Skips Working + Episodic, Semantic + Procedural only

New Profile Deep Dives

PARANOID_SENTINEL β€” Amygdala Threat Detection

Biological analog: The amygdala's threat-detection circuitry, which filters sensory input for potential dangers and amplifies recall of negative experiences (mood-congruent memory bias).

Use case: SRE agents, security auditors, compliance monitors. Only surfaces memories associated with negative outcomes β€” errors, failures, security incidents, regressions.

Parameter Value Effect
Ξ± 0.2 Low similarity weight β€” severity matters more than closeness
Ξ² 0.8 High importance weight β€” prioritize severe failures
Valence range [-128, -1] Negative memories only β€” successes are invisible

How it works:

  • Only negative memories pass the valence filter in Phase 3 of the scorer. Successes, neutral logs, and positive outcomes are invisible.
  • Importance-dominated β€” the severity of the past failure matters more than how closely it matches the current query.
  • Query valence is set to -128 (maximum threat), triggering mood-congruent recall amplification.

example: Scenario Agent query: "deployment configuration" β†’ BALANCED returns general config docs. PARANOID_SENTINEL returns only the config-related incidents: the time a bad config caused a 4-hour outage, the security CVE from an exposed config file, the memory leak from misconfigured thread pool.

THE_EXECUTOR β€” Prefrontal Executive Function

Biological analog: The prefrontal cortex in full executive function mode β€” goal-directed, no tangential exploration, pure task completion.

Use case: Devin-style agentic task runners. Combined with Zeigarnik Effect (markUnresolved()) for tracking open tasks that resist decay.

Parameter Value Effect
Ξ± 0.3 Moderate similarity weight
Ξ² 0.7 High importance weight
Strictness coefficient 10.0 Heaviside Cliff β€” 95% of candidates score near zero
Lateral mode disabled No cross-domain exploration

How it works:

  • Heaviside Cliff scoring: The strictness coefficient reshapes the similarity curve into a cliff function:

$$ \text{similarity} = \frac{1}{1 + d_{L2} \times 10.0} $$

At strictness=1.0 (default), this is a gentle hyperbola. At strictness=10.0, it's a cliff β€” 95% of candidates score near zero, and only the closest matches survive.

  • Lateral retrieval disabled: No DIVERGENT-style cross-domain exploration. Results must be directly relevant.
  • Zeigarnik integration: Unresolved tasks (flagged via markUnresolved()) resist time-decay entirely β€” their decay bucket is clamped to 0.

HIGHLY_SENSITIVE β€” Sensory Processing Sensitivity

Biological analog: Enhanced sensory processing depth (Aron & Aron, 1997). The highly sensitive brain processes stimuli more deeply, captures finer environmental details, and has a lower threshold for emotional activation.

Parameter Value Effect
Ξ± 0.7 High similarity weight β€” capture nuanced matches
Ξ² 0.3 Lower importance weight
Flashbulb threshold 2.0 (default: 3.0) Pins more moments as permanent memories
Inhibition floor 0.3 Stronger lateral inhibition β€” memories stay distinct
Min importance 0.01 Nothing is too small to remember

How it works:

  • Lower flashbulb threshold (2.0 vs 3.0): Captures more "important" moments as flashbulb memories. Events that BALANCED would consider routine, HIGHLY_SENSITIVE pins permanently.
  • Stronger lateral inhibition (0.3 floor): Less interference between memories. Each memory maintains its distinctiveness rather than blurring with similar neighbors.
  • minImportance=0.01: Nothing is too small to remember. Subtle signals that other profiles would round down to zero are preserved.

tip: Ideal for Medical reasoning, quality assurance, code review, accessibility testing β€” anywhere subtle signals could be critical.

DEFAULT_MODE_NETWORK β€” "Shower Thoughts"

Biological analog: The brain's default mode network (DMN), which activates during rest, mind-wandering, and unfocused cognition. The DMN surfaces deep, consolidated knowledge rather than recent events.

Parameter Value Effect
Ξ± 0.2 Low similarity weight
Ξ² 0.8 High importance weight β€” deep knowledge
Searched tiers Semantic + Procedural only Skips Working + Episodic

How it works:

  • Skips Working and Episodic tiers entirely. Only Semantic (consolidated facts) and Procedural (learned procedures) are searched.
  • Ξ±=0.2, Ξ²=0.8: Importance-dominated. The DMN isn't looking for direct matches β€” it surfaces whatever the agent "knows deeply" about a topic.
  • No recency bias: Since Episodic is skipped, all results are from long-term consolidated memory. No "what happened today" noise.

example: Scenario Agent is stuck on a performance problem β†’ switches to DEFAULT_MODE_NETWORK β†’ surfaces a deep architectural principle from 3 months ago that reframes the problem entirely. This is the computational equivalent of "sleeping on it."


Usage

Via Profile Preset

memory.recall("database deadlock", profile: HYPERFOCUS)

Via Recall Options

memory.recall("performance optimization",
    profile: DIVERGENT,
    topK: 20,
    lateralDistanceThreshold: 1.5)

Via MCP Tool

{
  "name": "memory_recall",
  "arguments": {
    "query": "database deadlock",
    "profile": "HYPERFOCUS",
    "top_k": 10
  }
}

Profile Selection Guide

flowchart TD
    A["What is the agent doing?"] --> B{"Focused on\none topic?"}
    B -->|Yes| C{"Need encyclopedic\ndetail?"}
    C -->|Yes| D["SYSTEMATIZER"]
    C -->|No| E["HYPERFOCUS"]
    B -->|No| F{"Exploring new\nterritory?"}
    F -->|Yes| G{"Want cross-domain\ninsights?"}
    G -->|Yes| H["DIVERGENT"]
    G -->|No| I["EXPLORING"]
    F -->|No| J{"Task execution\nor debugging?"}
    J -->|"Executing tasks"| J2["THE_EXECUTOR"]
    J -->|"Debugging"| K["DEBUGGING"]
    J -->|"Threat hunting"| M["PARANOID_SENTINEL"]
    J -->|"Need deep insight"| N["DEFAULT_MODE_NETWORK"]
    J -->|"Detail-sensitive"| O["HIGHLY_SENSITIVE"]
    J -->|No| L["BALANCED"]
Loading

Agent Self-Extension

Agents can dynamically switch profiles during a conversation:

  1. Start with BALANCED for general context
  2. Switch to HYPERFOCUS when a specific topic is identified (e.g., user mentions "database deadlock")
  3. Switch to DIVERGENT when stuck β€” lateral results may surface unexpected solutions
  4. Switch to SYSTEMATIZER when building a comprehensive knowledge base

The hyperfocus system supports TTL-based activation with agent self-extension:

flowchart LR
    DETECT["Agent detects<br/>focused topic"] --> ACTIVATE["Activate hyperfocus<br/><i>tags: database, deadlock</i>"]
    ACTIVATE --> BOOST["Matching memories<br/>get boost multiplier"]
    BOOST --> CHECK{"Topic continues?"}
    CHECK -->|"Yes"| EXTEND["Extend TTL"]
    CHECK -->|"No β€” TTL expires"| DEACTIVATE["Auto-deactivate<br/><i>default: 30 min</i>"]

    style ACTIVATE fill:#e74c3c,color:white
    style DEACTIVATE fill:#95a5a6,color:white
Loading

Result Metadata

Each result carries a retrieval mode indicating how it was retrieved:

Mode Meaning
STANDARD Normal similarity + importance scoring
LATERAL Cross-domain retrieval via the Explorer dual-heap
HYPERFOCUS Tag-matched with zero decay and boost multiplier

Agents can use this metadata to adjust their reasoning β€” for example, treating LATERAL results with more caution, or presenting HYPERFOCUS results with higher confidence.

What's Next

🏠 Home


Clone this wiki locally