1. πŸ“‚ Folder Tree & Naming

  • Naming Convention: All files and folders MUST use lowercase kebab-case. No spaces, no uppercase letters.
  • Exceptions: index.md is standard for folder hubs. README.md is NOT used inside Quartz content unless explicitly needed for git (we use index.md).

2. πŸ“ Front-matter Schema

Every markdown file MUST have the following front-matter:

---
title: "Emoji Name"
description: "Brief 1-sentence summary."
tags: [tag1, tag2]
aliases: ["OldName"] # If renamed
created: "YYYY-MM-DD"
---

3. πŸ—ΊοΈ Domain Map

  • /knowledge/ β€” High-density cheatsheets, cognitive FS.
  • /skills/ β€” OMP/Hermes agent skills. Guru docs in /skills/gurus/.
  • /projects/ β€” Live project hubs.
  • /plans/ β€” Active planning canvases.
  • /reports/ β€” Diagnostics and holistic state reports.
  • /stack/ β€” Core infrastructure (Quartz, OMP).
  • /_archive/ β€” Superseded, completed, or deprecated files.
  • /_cleanup/ β€” This SSOT restructuring metadata (temporary/internal).

4. πŸ”€ Redirect & Alias Policy

Any file renamed MUST contain its old filename (without extension) in the aliases: [] front-matter array. Example: SKILLS.md becomes skills.md with aliases: ["SKILLS"].