• Prefer calling load_config()/ensure_config() for configuration needs; avoid reading files directly.
• Run python scripts/generate_env_keys.py when documenting new configuration fields so environment variable examples stay current.
• Preserve document_ids and update state.search consistently.
• When modifying move/rename behavior, ensure Chromadb metadata refresh occurs without re-embedding.
• Respect processing.preview_char_limit and caches (classifications.json, vision.json).
• Keep .dorgy/search.json manifests accurate and propagate Chromadb warnings via CLI notes.

See src/dorgy/config/AGENTS.md and SPEC.md for expectations and defaults.