# AGENTS.md — scoped-инструкции для Obsidian vault

Этот файл задает правила для задач в `D:\ObsidianVaultSync`.

## 1. Scope и приоритет
- Scope: весь vault `D:\ObsidianVaultSync`.
- Если задача затрагивает код бота в `C:\obsidian-ai-formatter`, использовать также `C:\obsidian-ai-formatter\AGENTS.md`.
- При конфликте для файлов vault приоритет у этого файла.

## 2. Карта папок vault
- `00_Входящие/RAW/` — сырые транскрипции по неделям (`YYYY-Www.md`), источник для переразборов.
- `00_Входящие/Reports/` — отчеты batch-обработки и debug JSON.
- `05_Централь/` — целевые центральные листы:
  - `Telegram Bots.md`
  - `Дом и хозяйство.md`
  - `Личное и семья.md`
  - `Обучение.md`
  - `Идеи и концепты.md`
- `10_Проекты`, `20_Области`, `30_Notes`, `40_Resources`, `50_MOCs`, `90_Архив` — пользовательские разделы vault.
- `.obsidian/` — настройки клиента; не изменять без явного запроса.

## 3. Правила безопасных правок
- Не ломать frontmatter-блок (`---` ... `---`) в заметках.
- Не удалять и не изменять якоря вида `^YYYY-MM-DD-NNN` в RAW.
- Не менять формат ссылок на источник:
  - `[[RAW/YYYY-Www#^ID|Источник²]]`
- Не переименовывать ключевые файлы центральных листов без явного запроса пользователя.
- Не смешивать контент разных секций листа, если это ломает текущую структуру категорий.
- Для спорных случаев приоритет у правил из `C:\obsidian-ai-formatter\Docs\CENTRAL_LISTS.md`.

## 4. Правила классификации и ссылок
- Источник правил категоризации: `C:\obsidian-ai-formatter\Docs\CENTRAL_LISTS.md`.
- Любая новая задача/идея/баг в центральном листе должна иметь ссылку на RAW-источник.
- При объединении нескольких источников сохранять множественные ссылки или список source-id.
- Если уверенность низкая, переносить в секции для внимания и не выдумывать детали.

## 5. Что читать точечно по запросу
- Запрос про конкретный RAW:
  - читать только соответствующий `00_Входящие/RAW/YYYY-Www.md`
  - при необходимости ближайший отчет из `00_Входящие/Reports/`
- Запрос про конкретный центральный лист:
  - читать только файл в `05_Централь/` по теме
  - дополнительно открыть релевантный раздел `Docs/CENTRAL_LISTS.md`
- Запрос про формат заметок:
  - `C:\obsidian-ai-formatter\Docs\NOTE_FORMAT.md`
- Не сканировать весь vault без прямой необходимости.

## 6. Массовые операции и rollback-подход
- Перед массовыми правками:
  - зафиксировать список целевых файлов;
  - сделать резервную копию (например, `.bak` или `_Backup_YYYY-MM-DD_HH-mm`).
- Вносить изменения поэтапно:
  - сначала 1-2 файла как контроль;
  - затем остальной объем после быстрой проверки структуры.
- При обнаружении побочного эффекта:
  - остановить массовую операцию;
  - откатить измененный набор из backup;
  - пересогласовать стратегию.

## 7. Проверки после изменений
- Проверить, что wikilinks на RAW валидны и содержат корректный anchor `#^ID`.
- Проверить, что статусы/идентификаторы в RAW не повреждены.
- Проверить, что чекбоксы и секции категорий в центральных листах остались в прежнем формате.
- Проверить, что не затронуты файлы вне целевого набора.
- Если менялась структура листов или workflow, обновить `C:\obsidian-ai-formatter\Docs\CENTRAL_LISTS.md`.

## 8. Связанные документы
- Общий контракт по проекту кода: `C:\obsidian-ai-formatter\AGENTS.md`
- Companion для второго ассистента: `C:\obsidian-ai-formatter\CLAUDE.md`
- Контекст проекта: `C:\obsidian-ai-formatter\Docs\PROJECT_CONTEXT.md`
- Живой roadmap: `C:\obsidian-ai-formatter\Docs\ROADMAP.md`


**Что именно искать (точный запрос)**  
Найди существующие skills, которые покрывают хотя бы 1 из сценариев:

1. **Handoff / Session Transfer**
- генерация `HANDOFF.md` / “handover note” / “session checkpoint”
- фиксация: цель, прогресс, решения, важные файлы, next actions, команды запуска/тестов
2. **Context Management**
- “smart compact”, “strategic compact”, “/compact playbook”, “/clear workflow”
- шаблоны, которые уменьшают деградацию качества при росте контекста
3. **Durable Project Memory / Instructions**
- интеграция с `AGENTS.md` (Codex) и аналогами вроде `CLAUDE.md`
- skills, которые генерят/обновляют эти файлы и поддерживают их актуальными
4. **Автоматизация/хуки**
- hooks/автокоманды после компакта или перед закрытием сессии (создать handoff, обновить статус/решения)