- name
- dual-brain-memory-guardian
- description
- Dual-brain memory skill for correction handling, rewrite quality, post-task reflection, and semantic recall of historical pitfalls.
- metadata
- {"openclaw":{"requires":{"bins":["node","npm"],"env":["PINECONE_API_KEY"]},"primaryEnv":"PINECONE_API_KEY","os":["linux","darwin","win32"],"skillKey":"dual-brain-memory-guardian","install":[{"id":"brew-node","kind":"brew","formula":"node","bins":["node","npm"],"label":"Install Node.js + npm (brew)","os":["darwin","linux"]},{"id":"nodejs-download","kind":"download","url":"https://nodejs.org/en/download","label":"Install Node.js (manual download)","os":["win32"]}]}}
- user-invocable
- true
Dual-Brain Memory Guardian
Description
This skill combines a strict Markdown rule brain with a Pinecone experience brain. It is designed for reliable behavior constraints, correction-driven learning, and semantic recall of prior pitfalls.
Usage
Use this skill when any of the following applies:
- The user corrects your output or asks for a rewrite.
- You complete non-trivial work and need structured self-reflection.
- You need to recall similar historical pitfalls with fuzzy semantic matching.
- You need high-confidence behavior constraints that must not be violated.
- You encounter execution errors, regressions, or reasoning mistakes and need to preserve root cause.
Common trigger hints: correction, rewrite, reflection, pitfall, memory recall, behavior constraints, error, regression, root cause.
Instructions
Document Ownership (Single Source of Truth)
To avoid drift and contradictory edits, documentation ownership is strict:
- Runtime execution flow lives in
operations.mdonly. - Learning criteria and promotion logic live in
learning.mdonly. - Safety and data boundaries live in
boundaries.mdonly. - Setup and wiring steps live in
setup.mdonly.
If there is any wording mismatch, follow the owner document above instead of this file.
Architecture (Minimal Contract)
This skill uses a dual-brain contract:
- Left Brain (Markdown): explicit rules and durable preferences.
- Right Brain (Pinecone): episodic corrections, reflections, and semantic recall.
Conflict order remains fixed:
- Project Markdown > Domain Markdown > Global Markdown > Pinecone recall.
Mandatory Trigger Entry Points
The skill requires these command-level hooks to exist:
memory:session-startmemory:auto-session-startmemory:on-correctionmemory:on-task-completememory:auto-task-completememory:mark-promoted
Execution details, retries, and sequencing are defined in operations.md. Runtime guard for these triggers is enforced by scripts/memory-cli.js.
Proactive Trigger Behavior (Required)
When this skill is active, trigger commands should be called proactively:
- On session/conversation start, call
memory:auto-session-startbefore substantial work. - On final response for non-trivial work, call
memory:auto-task-completebefore ending. - Keep
memory:on-correctionfor immediate correction capture events. - When an error happens, call
memory:on-correctionimmediately with what failed and why (root cause).
Fallback policy:
- If auto wrappers are unavailable, call
memory:session-startandmemory:on-task-completemanually.
Quick Reference
| Topic | File |
|---|---|
| Skill contract | SKILL.md |
| Setup | setup.md |
| Runtime operations | operations.md |
| Reflection template | reflections.md |
| Heartbeat behavior | heartbeat-rules.md |
| Safety boundaries | boundaries.md |
| Pinecone config/runtime | src/pinecone/ |
| CLI entrypoint | scripts/memory-cli.js |
Requirements
- Node.js >= 20
- npm
@pinecone-database/pinecone- Required environment variable:
PINECONE_API_KEY - Optional runtime environment variables:
- PINECONE_INDEX_NAME - PINECONE_CLOUD - PINECONE_REGION - PINECONE_MODEL - PINECONE_FIELD_MAP_TEXT - PINECONE_NAMESPACE_PREFIX - MEMORY_TENANT - PINECONE_IMPORT_INTEGRATION_ID - DUAL_BRAIN_MEMORY_HOME
- Pinecone integrated index model:
multilingual-e5-large
Optional for bulk import:
- Object storage path (
s3://,gs://, Azure Blob URL) - Integration ID for private buckets
Rules Index
- Learning and promotion:
learning.md - Runtime triggers and recall flow:
operations.md - Local reflection template:
reflections.md - Safety and redaction:
boundaries.md - Scale and compaction strategy:
scaling.md
Scope
This skill ONLY:
- Maintains rule memory in
~/dual-brain-memory-guardian/. - Maintains experience memory in Pinecone.
- Uses npm-based Pinecone SDK operations (
upsertRecords,searchRecords,startImport,describeImport,describeIndexStats).
This skill NEVER:
- Treats Pinecone recall as stronger than explicit Markdown contracts.
- Stores sensitive raw secrets in vector memory.
- Performs destructive heartbeat rewrites of uncertain content.
Feedback
- If useful:
clawhub star dual-brain-memory-guardian - Keep skills updated:
clawhub sync