tomevault-io Basic Memory Semantic Patterns Skill
Purpose: Consistent semantic observation and relation patterns for Basic Memory MCP Guide: Guide 34 - Basic Memory MCP Integration ROI: 30-50 hours/year knowledge retrieval savings
Quick Start - Writing Notes
# Note Title
Content describing the topic.
## Observations
- [decision] What was decided #category
- [technique] How something works #category
- [issue] Problem that was found #category
- [requirement] What must be done #category
- [lesson] What was learned #category
## Relations
- implements [[Other Note]]
- requires [[Dependency Note]]
- extends [[Parent Concept]]
- pairs_with [[Related Note]]
- part_of [[Larger System]]
Observation Types
| Type | When to Use | Example |
|---|---|---|
[decision] |
Architecture/design choices | [decision] Use pgvector for embeddings #ai |
[technique] |
Implementation patterns | [technique] Async pool initialization #db |
[issue] |
Bugs, problems found | [issue] NULL values break ON CONFLICT #sql |
[requirement] |
Must-have constraints | [requirement] UTF-8 for Hebrew #i18n |
[lesson] |
Learnings, best practices | [lesson] Check existing before building |
Relation Types
| Relation | When to Use | Example |
|---|---|---|
implements |
Pattern realizes concept | implements [[Golden Rule]] |
requires |
Dependency relationship | requires [[Database Connection]] |
extends |
Builds on existing | extends [[Base Pattern]] |
pairs_with |
Works together | pairs_with [[Error Handling]] |
part_of |
Component of larger system | part_of [[Authentication System]] |
Common MCP Commands
// Search for past decisions
mcp__basic-memory__search_notes({ query: "decision database" })
// Load all patterns
mcp__basic-memory__build_context({ url: "memory://patterns/*" })
// Check recent activity
mcp__basic-memory__recent_activity({ timeframe: "7d" })
// Write a new note
mcp__basic-memory__write_note({
title: "Note Title",
content: "## Observations\n\n- [decision] ...",
folder: "patterns"
})
// Read specific note
mcp__basic-memory__read_note({ identifier: "Note Title" })
Folder Organization
~/basic-memory/
├── patterns/ # Reusable implementation patterns
├── fixes/ # Production fixes and debugging
├── decisions/ # Architecture decisions
├── research-cache/ # Perplexity search results
├── session-summaries/ # End-of-session documentation
└── [domain]/ # Domain-specific patterns
When to Document
| Trigger | Action |
|---|---|
| Made architecture decision | Write note with [decision] observation |
| Fixed a bug | Write note with [technique] + [issue] |
| Learned something new | Write note with [lesson] observation |
| End of complex session | Write session summary with key observations |
| Found reusable pattern | Write to patterns/ folder |
Memory URLs
FORMATS:
Single_Note: "memory://folder/note-title"
All_In_Folder: "memory://folder/*"
Wildcard: "memory://*/pattern-name"
EXAMPLES:
- "memory://patterns/*" # All patterns
- "memory://fixes/*" # All fixes
- "memory://decisions/database" # Specific decision
Related Skills: perplexity-memory-enforcement-skill
Related Rules: .claude/rules/mcp/memory-usage.md
Converted and distributed by TomeVault — claim your Tome and manage your conversions.