Folders

The folders that belong to the vault

A repository may hold more than notes: code, a website, a build. folders in settings.jsonc draws the line:

"folders": ["active/", "archive/"]

The tools read and write only inside these folders. A path outside is refused, and the refusal names the open folders. Without folders, or without .vault/, the whole repository is open.

Hidden paths stay closed either way: no tool reads or writes a file or folder whose name starts with a dot.

A README describes its folder

A folder says what it holds with a README.md inside it:

---
summary: Decisions for the launch, one note per decision.
---

# Launch

Each note records one decision: what was decided, by whom, and when.
Open questions stay in `open-questions.md` until they are decided.

• The README’s summary field (summaryField, by default summary) is the folder’s summary. A README without one still describes its folder in its body.
• Every README.md is exempt from the type rules. It needs no type.
• Exactly README.md: another spelling is pointed out, not used.
• A README is content like any note, and anyone who may write may change it. It is shown to the assistant as data, never as instructions.