Skip to content

What is in the vault

The vault is where the project is written down before any of it becomes code — what we are building, what we decided and why, what is in flight right now. Once you have signed in to the team vault, this page tells you where to look for what.

Where you start

Two notes sit at the top and both are entry points, not reading:

  • 00-start-here — the map. A list of the paths through the vault, so you can follow one instead of browsing.
  • 00-dashboard — the live view: what moved recently and what is blocked.

The folders

Folder What lives there Start with
05-project What we are building and how we work: the Project brief, the Roadmap, Ways of working, and the Glossary Project brief
10-design How it is meant to work. Design docs live with the thing they describe, and the folder's index lists them 10-design-index
30-decisions The decisions, one file each, numbered and never rewritten — ADR-0001 records choosing this vault, and this way of syncing it, in the first place The newest ADR
50-work Three boards — Work, Questions, Design — of the notes currently moving Board — Work
90-meta How the vault itself is run: Vault setup, Conventions, and the note templates Conventions

The numbers are the order they should make sense in, not an order you must read in.

Every note declares itself

Each note opens with who wrote it, what it is, and whether to trust it:

---
type: kb
title: Roadmap
status: draft
owner: <who owns it>
updated: 2026-09-17
tags: [planning]
---

status is the one to read first. current means it reflects reality; draft means it is still being written and you should not build on it. Several project notes are drafts today — that is visible on purpose, rather than each one having to be guessed at.

Why a vault instead of a wiki

Two reasons, and both are about the same thing: a decision is only useful if you can see the state of mind it was made in.

  • Decisions are kept, not overwritten. A wiki page is edited until it is right and the previous reasoning is gone. An ADR is added once and left alone, so the next time a question is reopened you can read why it was closed.
  • It is yours locally. The vault is files on your machine, so it works offline, searches instantly (Ctrl+K from anywhere in Obsidian), and keeps working when sync is unavailable.

What is not in the vault

Code, build output, and secrets. The vault holds the thinking; the PSN git server holds the code. If you are looking for something and cannot find it, the Questions board is the intended place to record that you looked and where.

Next: Conventions