# Devlog Documentation Instructions

Devlogs in this folder are high-level historical records for humans and future agents.

When adding a devlog:

- Use the filename pattern `NNNN - Short Title.md`.
- Start the title with the log number and topic, for example `# 0002 - Neow's Cafe Card Catalog Integration`.
- Start with the date in this format `Date: YYYY-MM-DD`.
- Record why the work happened, what changed at a system level, and which commits/files are the durable source of detail.
- Prefer commit hashes, plan names, and important paths over long code snippets.
- Include verification commands and notable outcomes.
- Capture decisions, assumptions, and follow-up work that would be hard to infer from diffs alone.
- Keep implementation minutiae out unless it explains a decision or a future maintenance risk.