Orchestration logic for Zettelkasten knowledge management — routing, lifecycle management, maintenance protocols, and health checks. Use when managing the Zettelkasten system at scale, processing backlogs, making maintenance decisions, or coordinating between research and note-taking agents.
The orchestrator is the control layer above the Zettelkasten MCP tools. While the tools handle individual operations (create, link, search), the orchestrator handles workflow decisions: what to do, in what order, when to delegate, and how to maintain system quality.
User request received
│
├─ Is it a quick capture? (single idea, no research needed)
│ └─ YES → Capture workflow (create note + link)
│
├─ Does it need research?
│ ├─ Academic literature → Delegate to Literature Reviewer
│ └─ General/mixed research → Delegate to Deep Researcher
│
├─ Is it about existing notes?
│ ├─ "Find connections" → Connection Discovery workflow
│ ├─ "Explore [topic]" → zk-knowledge-exploration.prompt.md
│ ├─ "Synthesize" → zk-knowledge-synthesis.prompt.md
│ └─ "Organize" → Structure Note Creation workflow
│
├─ Is it about system health?
│ └─ YES → Maintenance workflow
│
└─ Is it batch processing?
├─ "Process fleeting notes" → Fleeting Note Pipeline
└─ "Create notes from [source]" → zk-knowledge-creation-batch.prompt.md
[External Input]
│
▼
┌─────────┐ (quick capture, unprocessed thoughts)
│ Fleeting │
└────┬────┘
│ research + formalize
▼
┌────────────┐ (extracted from a specific source with citations)
│ Literature │
└─────┬──────┘
│ synthesize across sources
▼
┌───────────┐ (standalone insight, well-sourced, atomic)
│ Permanent │
└─────┬─────┘
│ cluster 7-15 related notes
▼
┌───────────┐ (organizes a cluster of permanent notes)
│ Structure │
└─────┬─────┘
│ entry point for broad domain
▼
┌─────┐ (navigational index for major topic areas)
│ Hub │
└─────┘
zk_find_orphaned_noteszk_find_central_notes → are they accurate hubs?zk_get_all_tags → merge near-duplicates, remove unused## Zettelkasten Health Report — {{YYYY-MM-DD}}
### Metrics
- Total notes: {{N}} (approximate)
- Orphaned notes: {{N}} (should be < 5%)
- Fleeting backlog: {{N}} (should be < 10)
- Central note count: {{N}}
- Tag count: {{N}}
### Issues Found
1. {{issue description}} — {{severity: low/medium/high}}
2. {{issue description}} — {{severity}}
### Recommended Actions
1. {{action}} — {{priority}}
2. {{action}} — {{priority}}
All agent research and review process artifacts live in notes/research-tracking/, separate from the permanent Zettelkasten:
notes/research-tracking/
├── sessions/ # Active research or review sessions
│ └── YYYYMMDD-descriptive-topic/
│ ├── research-log.md # Deep Researcher: running process log
│ ├── source-assessment.md # Deep Researcher: source register
│ ├── research-brief.md # Deep Researcher: final synthesis
│ ├── literature-matrix.md # Lit Reviewer: master tracker
│ ├── conceptual-synthesis.md# Lit Reviewer: CSE matrix
│ └── memo-*.md # Lit Reviewer: theme memos
├── plans/ # Research plans (created before sessions start)
│ └── YYYYMMDD-topic-plan.md
└── archive/ # Completed sessions (moved from sessions/)
Starting a session:
notes/research-tracking/sessions/ for an existing session on the topicYYYYMMDD-descriptive-topic/ folderplans/, reference it when creating session artifactsDuring a session:
Completing a session:
sessions/ to archive/YYYYMMDD-descriptive-topic-name (kebab-case)YYYYMMDD-topic-plan.mdmemo-theme-name.md (within session folder)Adapted from the living-document pattern:
When the Deep Research agent produces findings:
When the Literature Review agent produces outputs:
research-memo tagWhen note exploration reveals knowledge gaps:
needs-researchnotes/research-tracking/plans/ scoping the needed researchBefore any note enters the system:
| Check | For Note Types | Action if Fails |
|---|---|---|
| Has title | All | Reject — require title |
| Has tags (2-5) | All | Add tags or ask user |
| Has at least 1 link | Literature, Permanent | Create link or document why isolated |
| Has citations | Permanent, Literature | Add citations or downgrade to fleeting |
| Atomic (single concept) | Permanent | Split into multiple notes |
| Correct type | All | Reclassify |
| Template | Location | Used By |
|---|---|---|
| Fleeting | .github/skills/zettelkasten/templates/fleeting.md | Capture workflow |
| Literature | .github/skills/zettelkasten/templates/literature.md | Literature Review |
| Permanent | .github/skills/zettelkasten/templates/permanent.md | All synthesis |
| Structure | .github/skills/zettelkasten/templates/structure.md | Organization |
| Hub | .github/skills/zettelkasten/templates/hub.md | Major topics |
| Health Report | Inline above | Maintenance |
| Research Plan | .github/skills/zettelkasten-orchestrator/templates/research-plan.md | Session planning |
| Session README | .github/skills/zettelkasten-orchestrator/templates/session-readme.md | Session initialization |
| Template | Location | Used By |
|---|---|---|
| Research Brief | .github/skills/deep-research/templates/research-brief.md | Deep Researcher |
| Source Assessment | .github/skills/deep-research/templates/source-assessment.md | Deep Researcher |
| Research Log | .github/skills/deep-research/templates/research-log.md | Deep Researcher |
| Synthesis Report | .github/skills/deep-research/templates/synthesis-report.md | Deep Researcher |
| Analytical Note | .github/skills/literature-review/templates/analytical-note.md | Literature Reviewer |
| CSE Matrix | .github/skills/literature-review/templates/conceptual-synthesis.md | Literature Reviewer |
| Research Memo | .github/skills/literature-review/templates/research-memo.md | Literature Reviewer |
| Literature Matrix | .github/skills/literature-review/templates/literature-matrix.md | Literature Reviewer |