# 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.

- Skill: `ytrofr/basic-memory-semantic-patterns-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ytrofr/basic-memory-semantic-patterns-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ytrofr/basic-memory-semantic-patterns-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ytrofr (https://skillmd.com/u/ytrofr)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ytrofr/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`