graph TB
    subgraph "Core Persistent Storage (Markdown)"
        MEM["MEMORY.md<br/><i>Agent's notes</i>"]
        USR["USER.md<br/><i>User profile</i>"]
        FAIL["failures.md<br/><i>Failure memory</i><br/>corrections, insights, failures"]
        SKL["skills/<br/><i>Procedural memory</i><br/>debug-ts.md<br/>deploy-checklist.md"]
    end

    subgraph "Search Store (SQLite sessions.db)"
        SQM["memories table + FTS5<br/><i>search mirror/store</i>"]
        SQS["sessions/messages + FTS5<br/><i>session search</i>"]
    end

    subgraph "System Prompt (default policy-only)"
        POLICY["Memory policy<br/><i>when to search + safety rules</i>"]
        LEGACY["Legacy full blocks<br/><i>only with memoryMode=legacy-inject</i>"]
    end

    subgraph "On Demand"
        MSEARCH["memory_search<br/><i>query SQLite memories</i>"]
        SSEARCH["session_search<br/><i>query indexed sessions</i>"]
        SKILLTOOL["skill tool<br/><i>list/view/create/patch/edit/delete</i>"]
        BACKFILL["/memory-sync-markdown<br/><i>idempotent Markdown → SQLite sync</i>"]
        FULL["Full skill content<br/>Loaded when needed"]
    end

    POLICY --> MSEARCH
    POLICY --> SSEARCH
    POLICY --> SKILLTOOL
    MEM -.-> LEGACY
    USR -.-> LEGACY
    FAIL -.-> LEGACY
    SKL -.-> LEGACY
    SKILLTOOL -.->|"view"| FULL

    MEM -.->|"successful saves mirrored"| SQM
    USR -.->|"successful saves mirrored"| SQM
    FAIL -.->|"successful saves mirrored"| SQM
    BACKFILL --> SQM
    MSEARCH --> SQM
    SSEARCH --> SQS

    style POLICY fill:#1a1a2e,stroke:#e94560,color:#fff
    style LEGACY fill:#2d1b2e,stroke:#ff6b6b,color:#fff
    style SQM fill:#0b525b,stroke:#fff,color:#fff
    style SQS fill:#1b4332,stroke:#fff,color:#fff
    style BACKFILL fill:#3a0ca3,stroke:#fff,color:#fff
    style FULL fill:#0a1128,stroke:#1282a2,color:#fff
    style SKILLTOOL fill:#16213e,stroke:#0f3460,color:#fff