CLAUDE.md — Laputa Vault Guide

This file explains how Laputa vaults work so you can create and edit notes correctly.

Note structure

Every note is a markdown file with YAML frontmatter:

---
title: My Note Title        # required — do NOT use H1 in the body
is_a: TypeName              # the note's type (must match a type file in the vault)
status: Active              # example property
url: https://example.com   # example property
belongs_to: "[[Other Note]]"  # relationship via wikilink
related_to:
  - "[[Note A]]"
  - "[[Note B]]"
---

Body content in markdown. No H1 — the title is in the frontmatter.

Key rules:

title is the note's display name — never use # H1 in the body
is_a must match the title of an existing type file
Properties are any YAML key-value pairs in the frontmatter
System properties are prefixed with _ (e.g. _pinned, _organized, _icon) — don't show these to users

Types

A type is a note with is_a: Type in the frontmatter. It lives in the vault root:

---
title: Book
is_a: Type
_icon: BookOpen          # Phosphor icon name
_color: "#8b5cf6"        # hex color for sidebar
---
Description of the type.

To create a new type: create a markdown file with is_a: Type.

Relationships

Relationships are frontmatter properties whose values are wikilinks:

belongs_to: "[[Project Name]]"
related_to:
  - "[[Note A]]"
  - "[[Note B]]"
has:
  - "[[Child Note]]"

Standard names: belongs_to, related_to, has. Custom names are allowed.

Wikilinks

Syntax: [[Note Title]] or [[filename]]. Used for relationships and inline references.

Views

Saved filters stored as .view.json in the views/ folder:

{
  "title": "Active Notes",
  "filters": [
    {"property": "is_a", "operator": "equals", "value": "Note"},
    {"property": "status", "operator": "equals", "value": "Active"}
  ],
  "sort": {"property": "title", "direction": "asc"}
}

What you can do on this vault

Create/edit notes with correct frontmatter
Create new type files
Add or modify relationships between notes
Create/edit views in views/
Change _icon and _color on type files
Edit CLAUDE.md (this file)

Do not modify app configuration files — those are local to each installation.

2.3 KiB Raw Blame History