Roles
canonical — source of truth (code, config, registry). Versioned, authoritative.
runtime — generated at runtime (data, logs, indexes). Ephemeral or regenerable.
narrative — human-written context (memory, notes). Aids AI reasoning.
artifact — build output (dashboards, reports). Never edited manually.
Indicators
→ symlink — points to real data in DATA_ROOT; target shown in details
↕ secrets — API keys, sessions; in data/_secrets. Excluded from sync.
▸ virtual group — UI-only grouping (e.g. All Agents). Not a filesystem path.
Structure
■ domain — logical grouping (core, cursor, public, knowledge...)
○ project — folder in project layer. Badges: GitHub GitLab folder
★ agent — Cursor prompt agent (LLM persona in agents/*.md)
▶ dag / job — scheduled pipeline or script
⚙ utility — infrastructure or helper tool
Data
▣ raw — untransformed input in DATA_ROOT
▢ derived — processed data, indexes, normalized outputs
□ logs — execution records; cache — fast-lookup structures