# Basic Memory Semantic Patterns Skill

> Write Basic Memory notes with semantic observations and relations. Use when creating notes, querying past decisions, finding how we fixed bugs, or loading pattern context. Use when this capability is needed.

- Skill: `tomevault-io/basic-memory-semantic-patterns-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/basic-memory-semantic-patterns-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/basic-memory-semantic-patterns-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/basic-memory-semantic-patterns-skill

---


# Basic Memory Semantic Patterns Skill

**Purpose**: Consistent semantic observation and relation patterns for Basic Memory MCP
**Guide**: [Guide 34 - Basic Memory MCP Integration](../../../docs/guide/34-basic-memory-mcp-integration.md)
**ROI**: 30-50 hours/year knowledge retrieval savings

---

## Quick Start - Writing Notes

```markdown
# 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

```javascript
// 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

```yaml
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](https://tomevault.io/claim/ytrofr) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->