archive

Architecture

Archive storage lives in ~/archive/ with tiered structure. See memory-template.md for setup.

~/archive/
├── memory.md          # HOT: recent items, ≤100 lines
├── index.md           # Topic/tag index
├── items/             # Individual archived items
├── projects/          # Per-project collections
└── history.md         # Search/access history

Quick Reference

Topic	File
What to capture	`capture.md`
Search patterns	`search.md`
Resurfacing rules	`resurface.md`

Core Rules

1. Capture Complete, Not Just Links

When user sends something to archive: - Extract full content (not just URL) - Generate 2-3 line summary - Identify key quotes/data points - Ask: "What's this for?" — store the WHY alongside the WHAT - Assign semantic tags based on content + user history

2. Content Types

Type	What to extract
Article/webpage	Full text, author, date, key quotes
Video (YouTube)	Title, creator, duration, timestamps mentioned
Tweet/thread	Full text, author, context, media
PDF/paper	Title, authors, abstract, cited references
Image	Description, source, context given
Idea/note	Raw text + timestamp + related items

3. Storage Structure

Each archived item stored as:

items/{date}_{slug}.md
---
type: article
url: original-url
archived: 2026-02-16
why: "research for pricing strategy"
tags: [pricing, saas, strategy]
project: clawmsg
---
## Summary
...
## Key Points
...
## Full Content
...

4. Semantic Search

User can ask naturally: - "What did I save about X?" → search by concept - "That article about pricing from last month" → fuzzy time + topic - "Everything for project Y" → project filter - "Papers by author Z" → metadata search

NEVER require exact keywords. Match by meaning.

5. Proactive Resurfacing

When user works on a topic: - Check if archived items relate - Surface ONLY if genuinely relevant (max 1-2 per session) - Include context: "You saved this 3 months ago when researching X"

6. Never Delete Without Asking

Old items → mark as "possibly outdated", don't delete
Duplicates → merge, keep both URLs
Project closed → archive to cold storage, don't remove

7. Differentiation from Other Skills

This skill	What it does	NOT this
archive	Preserves external content as snapshots	memory (agent context)
archive	Captures full content for permanence	bookmark (just URLs)
archive	Stores raw material	second-brain (processed knowledge)
archive	Immutable snapshots	pkm (evolving notes)

Scope

This skill ONLY: - Stores content user explicitly sends to archive - Searches within archived content - Surfaces related items when contextually relevant

This skill NEVER: - Monitors or observes without explicit request - Deletes content without confirmation - Modifies original archived content - Accesses external services without user action

Data Storage

All data in ~/archive/. Create on first use:

mkdir -p ~/archive/items ~/archive/projects