Conventions for the Lakuyo Obsidian vault (same pattern as HaloRT docs).

Folders

FolderPurpose
Product/Vision, personas, business model, roadmap, founding decisions
Architecture/System design summaries (detail specs stay in control-plane)
Surfaces/One note per product surface (docs, Android, iOS, backend, …)
Team/Collaboration and ownership
Guides/How-to and release process
Ops/Hostnames, DNS, deploy notes (no secret values)
Projects/Project hub
Meta/Vault meta, repo map
assets/Images
private/Ignored by Quartz — do not publish

Frontmatter

title: "Note title"
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: meta           # idea | issue | task | process | meta | project
tags: [project/lakuyo, type/meta, status/current]
status: current      # current | archived
project: lakuyo

Linking

Prefer Obsidian wikilinks ([[Product/Vision]]) so Quartz graph and backlinks work.

Hub entries: index · Lakuyo · Overview.

Specs vs docs

ConcernRepo
Product narrative, decisions, guidesThis vault (lakuyo-docs)
Behavioural specs, contracts, implementation statuslakuyo-control-plane

If a decision changes required behaviour, update the matching control-plane spec in the same change set.