zettelkasten

name	zettelkasten
description	Maintain a Luhmann-style Zettelkasten. Capture, connect, and synthesize ideas through fleeting notes, permanent notes, cross-references, and structures, with an AI agent that surfaces connections, challenges assumptions, and enriches notes with research. Use when the user shares an idea, observation, or inspiration; when reviewing or connecting existing notes; when synthesizing patterns; or during heartbeats to maintain the system.
metadata	{"hybridclaw":{"category":"memory","short_description":"Luhmann Zettelkasten.","tags":["zettelkasten","notes","memory","knowledge-base"]}}

Zettelkasten

This skill implements a Luhmann-style Zettelkasten rather than a loose note archive. The agent helps maintain note quality, find references, surface cross-strand links, and challenge vague or weak ideas.

Storage

All notes in memory/zettelkasten/:

• inbox/ - Raw unprocessed drops (fleeting notes)
• seeds/ - Processed atomic ideas (permanent notes)
• connections/ - When 2+ seeds click (Luhmann's Fernverweise made explicit)
• structures/ - Developed frameworks, plans
• archive/ - Dormant ideas (never deleted - Luhmann's rule)
• INDEX.md - Curated entry points (not a tag dump - each keyword -> best starting seed)
• JOKER.md - Meta-note: how this specific Zettelkasten works, its quirks, and its active strands

Note Format

# [Title]
**ID:** YYYYMMDD-NNN
**Date:** YYYY-MM-DD
**Status:** permanent | active | mature | actionable | dormant
**Tags:** #tag1 #tag2
**Source:** [where it came from]
**Strand:** [parent ID if branching from another note]

## Idea
[The core thought - always in own words, never just a quote]

## Context
[Why this matters, what triggered it]

## References
- **Near** (same strand): [[ID]] - [relationship]
- **Far** (cross-strand): [[ID]] - [why these distant ideas connect]

## Agent Notes
[Agent observations, challenges, enrichments added over time]

Naming

• Inbox: YYYYMMDD-HHMMSS-raw.md (timestamped, unprocessed)
• Seeds: YYYYMMDD-NNN-slug.md (e.g., 20260215-001-next-openclaw.md)
• Branches: YYYYMMDD-NNNa-slug.md (extending a parent: 001a, 001b, 001a1)
• Connections: YYYYMMDD-CNNN-slug.md
• Structures: YYYYMMDD-SNNN-slug.md

Reference Types (from Luhmann)

• Near (Nahverweis): Within the same strand/argument thread. Red thread connections.
• Far (Fernverweis): Cross-strand surprises. The magic ones. When an idea about memory markets suddenly links to a paper on spatial cognition.

Operational Layer

What makes this different from every other Zettelkasten guide:

1. Active Maintenance (during heartbeats)

Don't just check, maintain:

• Re-read seeds >7 days old without connections. Try harder. Research if needed.
• Notice contradictions between notes. Flag them.
• Enrich seeds: if a raw idea mentioned a concept, look it up, add context to Agent Notes.
• Update INDEX.md when new clusters emerge.
• Update JOKER.md with observations about the system's shape.

2. Surprise Delivery

When a non-obvious far connection is found, don't just log it - tell the user. The best Zettelkasten moments are "holy shit, I never saw that link." Deliver these proactively.

3. Challenge & Provoke

If a new seed contradicts an existing one, say so. If an idea is vague, push back. Friction matters more than passive accumulation. Add devil's advocate notes in Agent Notes.

4. Strand Awareness

Track argument threads across seeds. When a user keeps circling the same theme (even without realizing it), name the strand. "You've been thinking about portable identity for 3 weeks across 5 seeds - here's the thread."

5. Periodic Review

Periodically (weekly during heartbeats), write a brief review report:

• Active strands
• What's dormant (seeds with no connections after 2+ weeks)
• What surprised you (unexpected connections found)
• Which clusters are mature enough to become structures

Workflows

Capture (user drops an idea)

1. If quick/raw -> file in inbox/ with timestamp
2. If clear enough -> create seed in seeds/, rephrase in own words (Luhmann's rule)
3. Scan existing seeds for near and far references
4. If it branches from an existing seed, use branching ID (001a)
5. Update INDEX.md if it introduces a new concept
6. Confirm capture with one line + any immediate connections spotted

Process Inbox (during heartbeats or on request)

1. Review inbox/ items
2. For each: rephrase in own words, decide if it should become a permanent note or be discarded
3. Promote to seeds/ with proper format, or leave with a note on why it's not ready

Connect (active maintenance)

1. Read seeds, look for clusters - especially cross-strand far connections
2. Create connection note in connections/ explaining the emergent pattern
3. Update both seeds with back-references
4. If the connection is surprising -> surface it to the user proactively

Synthesize (when enough seeds cluster)

1. Draft structure in structures/ referencing all contributing seeds/connections
2. Include framework, open questions, and next steps
3. Present the synthesis to the user

Prune (on request only)

Move to archive/ with a note on why. Never delete. Luhmann's rule: "useless" notes become essential years later.