# Meta

# Conventions

# Conventions

## Files

- Markdown, UTF-8, LF line endings.
- One topic per file; the filename is the topic, not a date. Dates belong in
  frontmatter or journal headings.
- Folders are numbered so they sort in a fixed order. Do not add new top-level
  folders without a reason; use `00-inbox/` if unsure.
- Wikilinks (`[[note]]`) for notes inside the brain, normal relative links for
  things outside it.
- No credentials. Point at `Passwords.kdbx`, `.env` or the secret store.

## Frontmatter

```yaml
---
title: Human title
updated: YYYY-MM-DD
tags: [systems, mail]
---
```

Only `title`, `updated` and `tags` are required. Extra fields are fine when they
help a query (e.g. `host`, `repo`, `status`).

## Journal entries

Newest first. Each entry: **Symptom → Root cause → Fix → Prevention → Lessons**,
with exact paths, commands, hosts and dates. Append-only.

## Decisions

One entry per settled choice: date, decision, alternatives rejected, why, and
what changes as a result. If a decision is later reversed, add a new entry
rather than editing the old one.

## Commits

```bash
git add -A && git commit -m "<area>: <summary>"
```

Areas: `journal`, `systems`, `projects`, `reference`, `meta`.