---
name: obsidian-docs
description: Завести или обновить проектную документацию в Obsidian Vault (`~/Documents/Obsidian Vault/Projects/<name>/`). Брать ВСЕГДА при создании нового сервиса (до того как считать задачу завершённой) и после любой нетривиальной задачи (новый endpoint, рефакторинг, миграция, архитектурный фикс) — минимум обновить Changelog.md. Также перед тем как опираться на инфу из Obsidian при принятии решений — сверить с актуальным кодом, заметки могут отстать. НЕ подменяет ~/.claude/memory/*.md (то — короткие cross-session pointers, это — полные project docs; нужны оба).
---

# Obsidian project docs

Канон: `~/Documents/Obsidian Vault/Projects/research-gateway/` — готовый образец на 5 файлов.

## 5 обязательных файлов на проект

`~/Documents/Obsidian Vault/Projects/<project-name>/`:

- **Overview.md** — frontmatter (stack/entry_points/auth/launchd/last_updated), что это, аудитория, что НЕ делает, связи `[[other-projects]]`
- **Architecture.md** — топология (ASCII-диаграмма), пайплайны, конфиг, безопасность, зависимости
- **Scenarios.md** — практические сценарии использования с curl/python примерами
- **Changelog.md** — версии с датами, что добавили/убрали, отвергнутые варианты, известные проблемы
- **Decisions.md** — architectural decisions с обоснованиями (D1, D2, D3...), читать перед изменениями

## Протокол

1. **Новый сервис** — создать папку и все 5 файлов до того как считать задачу завершённой.
2. **После нетривиальной задачи** — обновить минимум `Changelog.md`. Если решение архитектурное — добавить запись в `Decisions.md`.
3. **Перед опорой на инфу из Obsidian** — сверить с актуальным кодом (заметки могут отстать).

Если забыл — спроси себя в конце: «обновил ли я Obsidian?». Нет — задача не завершена.
