← All how-to guides

Everyday filing

How do I write my convention?

Describe your filing rules in plain language in CONVENTION.md — dossier applies them to every proposal.

Your convention is a plain Markdown file, CONVENTION.md, in the project root. It’s written for a reader, not a parser — describe how you file the way you’d explain it to a very organized friend. dossier reads it before every proposal.

A worked example

# How this archive is filed

## Folders
- Each family member has a top-level folder: robin/, nora/, milo/.
- Inside, group by life area: identity, school, bank, health, insurance.
- Shared household documents go into house/.

## Filenames
- Start with the document's own issue date: YYYY-MM-DD.
- Then the person in brackets, a short kebab-case title, and tags:
  2011-04-21_[nora]_birth-certificate_(certificate)(de).pdf
- Tags in (parentheses); the last tag is the language: (de), (en), (cs).

## Rules
- Keep translations next to their originals.
- Insurance letters that are only premium notices → insurance/notices/.

Tips

  • Be concrete. One real example filename teaches more than three paragraphs.
  • Write the exceptions down. “X normally goes to A, except when Y” is exactly what the AI needs to stop repeating a mistake.
  • You don’t have to be complete. dossier also keeps a learned-convention.md that grows from your manual corrections — patterns you repeat become rules it follows, without you writing them.

You can edit CONVENTION.md any time; the next proposal uses the new version.