Memorb Conventions (Single Source of Truth)

This skill is the SSOT for memOrb's folder structure, filename formats, YAML schemas, and naming rules. Every write operation and every initialization (/memorb-born) must follow it. Workflows belong to the individual sub-skills; this file governs only where things go and what shape they take. It assumes nothing about the name or existing layout of the user's vault — memOrb operates through the non-invasive memorbs/ namespace and leaves everything else alone.

Resolving VAULT

Do not assume a fixed root folder name. The presence of memorbs/HQ/identity.md is what marks a vault as initialized:

VAULT=$(find . -maxdepth 4 -type d -name memorbs 2>/dev/null -exec dirname {} \; | head -1)

If nothing is found, /memorb-born has not run yet — route there first.

Folder structure

The one boundary rule: memOrb may read anything the user points it at, but it writes only inside memorbs/.