Vault Structure

MindWiki uses a convention-based folder structure. You can customize it, but the defaults are designed to work well with the AI agents.

Default Folder Layout

my-vault/
├── capture/              # 📥 Raw inputs — unprocessed
│   ├── voice-memo-0409.md
│   ├── article-clip.md
│   └── email-fwd-0412.md
│
├── patterns/             # 🔮 Structural patterns across domains
│   ├── feedback-loops.md
│   ├── emergence.md
│   └── resonance.md
│
├── self/                 # 🪞 Personal reflections, values, reviews
│   ├── values.md
│   ├── weekly-review.md
│   └── identity.md
│
├── systems/              # ⚙️ Processes, routines, workflows
│   ├── second-brain.md
│   ├── morning-routine.md
│   └── decision-framework.md
│
├── research/             # 🔬 Deep dives, references, literature
│   ├── complex-systems.md
│   ├── embodied-cognition.md
│   └── network-effects.md
│
├── projects/             # 📁 Active project notes
│   ├── mindwiki-launch.md
│   └── q2-roadmap.md
│
├── people/               # 👤 Notes on people you interact with
│   └── mentor-notes.md
│
└── _templates/           # 📝 Page templates for new notes
    ├── pattern.md
    ├── concept.md
    └── capture.md

Folder Descriptions

capture/

The inbox of your brain. Everything you capture lands here first — voice memos, shared links, email forwards, quick thoughts. The weekly classifier agent processes these and moves them to the appropriate folder.

You should never need to organize this folder manually. Just dump things in and let the AI handle it.

patterns/

Home for structural patterns — dynamics that appear across multiple domains. These are typically created by the pattern detector agent, though you can write them manually.

Pattern pages have a specific structure:

  • Title: the pattern name
  • Description: what the pattern is
  • Where it shows up: a list of domains and pages where this pattern appears
  • Links: wikilinks to every relevant page

self/

Personal reflections, values, identity notes, and weekly reviews. This is the introspective corner of your vault. The pattern detector pays special attention to this folder because self-knowledge often reveals the deepest patterns.

systems/

Documented processes, routines, and workflows. How you do things. Morning routines, decision frameworks, communication protocols. Think of this as your personal operating manual.

research/

Deep dives into topics. Academic papers, book notes, long-form explorations. These pages tend to be dense with wikilinks because research touches many other areas of your vault.

projects/

Active project notes, plans, and status updates. These are usually time-bound and may be archived when complete.

people/

Notes about people you work with, learn from, or interact with regularly. Meeting notes, key takeaways, relationship context.

_templates/

Templates used when creating new pages. The classifier agent uses these to format captures into structured pages.

Customizing the Structure

You can add, rename, or remove folders. The AI agents adapt to your structure as long as:

  • capture/ exists (for the classifier to have an inbox)
  • patterns/ exists (for the pattern detector output)
  • Each page has valid frontmatter with at least a type field

Configure folder mappings in Settings → Vault → Folder Mapping to tell agents where each content type should be filed.

File Naming

MindWiki uses kebab-case for file names: feedback-loops.md, morning-routine.md. This is consistent with URL-friendly slugs and makes wikilinks clean: [[feedback-loops]].

Avoid spaces in file names. The classifier agent will automatically convert captured content to kebab-case names.