para-second-brain

# PARA Second Brain

Your agent's memory just got a massive upgrade. Full semantic search across your entire knowledge base — not just MEMORY.md.

## What's New in v2.0

**Before v2.0:** `memory_search` only found content in MEMORY.md and daily logs. Your entire `notes/` folder was invisible to search. You had to manually know where to look.

**After v2.0:** One symlink command makes your entire PARA knowledge base searchable. Ask about anything in your notes — it finds it. Plus session transcripts and memory flush protocol to prevent context loss.

| Before | After |
|--------|-------|
| Search only MEMORY.md + daily logs | Search EVERYTHING |
| "I don't have that information" | Finds it instantly |
| Context compaction = lost information | Flush protocol saves critical context |
| Conversations forgotten | Session transcripts indexed |

## What This Does

Creates a "second brain" structure that separates:
- **Raw capture** (daily logs) from **curated knowledge** (MEMORY.md)
- **Active work** (projects) from **ongoing responsibilities** (areas)
- **Reference material** (resources) from **completed work** (archive)

## How This Differs from Other Second Brain Skills

There's another popular [second-brain skill](https://clawdhub.com/christinetyip/second-brain) powered by Ensue. Both are great — they solve different problems:

| | **PARA Second Brain** (this skill) | **Ensue Second Brain** |
|---|---|---|
| **Storage** | Local files in your workspace | Cloud API (Ensue) |
| **Cost** | Free, self-hosted | Requires Ensue API key |
| **Best for** | Work context, agent continuity, project tracking | Evergreen knowledge base, semantic queries |
| **Search** | Clawdbot's `memory_search` | Ensue's vector search |
| **Structure** | PARA (Projects/Areas/Resources/Archive) | Namespaces (concepts/toolbox/patterns) |
| **Use case** | "What did we decide yesterday?" | "How does recursion work?" |

**Use this skill if:** You want file-based memory that works offline, costs nothing,...