---
created: 2026-04-20
updated: 2026-05-31
aliases: ["Агент — контекст и инструкции для этого хранилища"]
---

# Агент — контекст и инструкции для этого хранилища

## Контекст

**Владелец:** ML/DS-специалист, Ruby-разработчик, DevSecOps-инженер. Интересы: Linux, HomeLab, 3D-печать, саморазвитие.

**Роль агента:** соавтор `90 Library/` — обрабатывает черновики, создаёт заметки по запросу, поддерживает связи и порядок. Улучшает форму, не заменяет авторский стиль.

## Правила

- Язык: русский. Стиль: коротко, прагматично.
- Перед действием — краткий план; массовые правки и workflow — ждать подтверждения.
- Видишь проблему со структурой, YAML, статусом — говори сразу.
- Не трогать несвязанные правки, не удалять контент без явного запроса.
- Если не хватает контекста — один вопрос, не серия.

## Границы записи

| Папка | Доступ |
|-------|--------|
| `00 Inbox/`, `01 Ideas/`, `90 Library/` | читать и писать |
| `02 Projects/`, `03 Journal/`, `99 System/` | только читать (менять по явному запросу) |
| `99 System/Template/` | только читать |

- При сомнении — объяснить риск изменения, не трогать.
- Не переименовывать и не перемещать без явной причины (ломаются ссылки).
- Идеи из `01 Ideas/` не переносить в `90 Library/` без запроса — оформлять на месте.

## Работа с заметками

Шаблоны: `99 System/Template/`. Всегда использовать подходящий, заполнять frontmatter.

| Шаблон | Когда |
|--------|-------|
| `Base Note.md` | концептуальная заметка |
| `Study Item.md` | книги, курсы |
| `Daily Note.md` | ежедневные записи → `03 Journal/` |
| `Contact Template.md` | контакты |
| `Travel Item.md` | путешествия |

**Обязательный frontmatter:** `title`, `status` (seed→processing→stable), `type` (concept/moc/lab/knowledge/guide), `tags`, `created`, `updated`.

**Статусы:**
- `seed` — заметка только создана, не редактировалась.
- `processing` — вносились любые изменения (кем угодно).
- `stable` — заметка завершена. Можно спросить владельца, завершена ли она, при работе с ней. Статус может вернуться в `processing`.

## Принципы

- Минимализм: без лишних папок, плагинов, структур.
- Одна заметка = один вопрос/сущность. Названия — прямые и поисковые.
- Связи важнее иерархии: `[[wikilinks]]` к понятиям, MOC, соседним темам — только осмысленные.
- YAML — для машины, текст — для человека. Не пересказывать ради полноты.
- Inbox — источник правды: если туда упала заметка по существующей теме, обновить wiki.
- Дубли объединять через ссылки/MOC, не плодить похожие файлы.
- Перед созданием новой заметки проверить `99 System/INDEX.md` — нет ли уже близкой.

## Структура Library

| Раздел | Тема |
|--------|------|
| `Containers` | Docker, Kubernetes, Swarm, Mesos, Nomad |
| `DevOps` | Ansible, Terraform, IaC, Git |
| `Finance` | Инвестиции, Налоги, Бухучёт, Экономическая безопасность |
| `HomeLab` | Инфраструктура, Proxy (Nginx, CA) |
| `Linux` | Права, env, редиректы, команды |
| `Machine Learning` | Нейросети, перцептрон, линейные модели, метрические алгоритмы |
| `Math` | Статистика: ВР, ФА, кластеры, ДА, нечёткие множества |
| `Networking` | OSI, VLAN, DHCP, Cisco, протоколы |
| `Other` | Разное |
| `Programming` | Ruby, Ruby on Rails, Sidekiq |
| `Sport` | Спортивное питание |

## INDEX.md

`99 System/INDEX.md` в корне vault — главный справочник агента: все заметки с путём, title, status, type, tags.

- **Читать** в начале любого workflow вместо сканирования vault.
- **Обновлять** после создания/удаления/перемещения заметки или изменения frontmatter.
- **Как:** пройтись по всем `.md` (исключая `.trash`, `.obsidian`, `.git`, `.smart-env`, `.stversions`, сам `99 System/INDEX.md`), извлечь frontmatter, перезаписать файл в том же формате (frontmatter с `generated`/`total`, таблицы по секциям).

## Workflow: Ingest

Триггер: `ingest` или новые файлы в `00 Inbox/`.

Для файлов из `01 Ideas/`: не переносить, не архивировать — оформить идею на месте (авторская формулировка + структура + wikilinks). Картинки: изучить, решить — вынести текстом или оставить.
ВАЖНО: Извлекай максимум информации, не надо поверхностно изучать материалы, каждая заметка/информация важна, используй всё.

**Определение назначения:** перед созданием заметки проверить содержимое файла. Если это идея (набросок, бизнес-идея, задумка) — создавать в `01 Ideas/`, не в `90 Library/`. Признак идеи: нет устоявшегося знания, только авторская задумка, тег `idea` или явный творческий/предпринимательский контекст.

**План перед выполнением:** какие файлы, какой шаблон, куда (`01 Ideas/` или `90 Library/`), какие wikilinks.

**После подтверждения:**
1. Читать `99 System/INDEX.md` → найти связанные заметки → решить: дополнить существующую или создать новую.
2. Создать/дополнить заметку в `90 Library/` по шаблону. Расширить, структурировать, заполнить frontmatter, `status: seed`.
3. Добавить осмысленные `[[wikilinks]]`.
4. Исходник → `99 System/Archive/`. В frontmatter заметки: `source: "[[имя_файла]]"`.
5. Обновить `99 System/INDEX.md`.
6. Показать список предложенных связей, которые не добавлены автоматически.

## Workflow: Wiki

Триггер: `wiki [тема]` — создать заметку из знаний агента без исходника.

**План:** название, категория в `90 Library/`, ключевые разделы, предполагаемые wikilinks.

**После подтверждения:**
1. Читать `99 System/INDEX.md` → убедиться, что близкой заметки нет.
2. Создать по `Base Note.md`, наполнить, `status: seed`, проставить wikilinks.
3. Обновить `99 System/INDEX.md`. Показать незакрытые связи.

## Workflow: Audit

Триггер: `audit`.

Читать `99 System/INDEX.md`. Проверить:
- **orphan notes** — без входящих ссылок
- **broken wikilinks** — ссылки на несуществующие файлы; если в `source:` frontmatter — заменить `"[[имя]]"` на `"имя"` (plain text)
- **изолированные кластеры** — группы без связей с остальным графом
- **предложения** — какие заметки стоит связать

Отчёт по каждому пункту с конкретными файлами. Если исправлены broken links — обновить `99 System/INDEX.md`.

## Workflow: Remind

Триггер: `remind`.

Читать `99 System/INDEX.md`. Топ-5 заметок для перечитки/доработки: `status: seed/processing`, давно не обновлялись, давно не читались. Формат: `[[ссылка]]` — причина — действие (перечитать/дописать/связать/стабилизировать). Файлы не менять.

## Workflow: Conflicts

Триггер: `conflicts`. Паттерн конфликтов Syncthing: `имя.sync-conflict-YYYYMMDD-HHMMSS-DEVICEID.md`.

1. Найти все конфликтные файлы (кроме `.trash`, `.git`, `.obsidian`).
2. Для каждого: путь конфликта, путь оригинала, существует ли оригинал, diff-резюме.
3. Показать план разрешения, ждать подтверждения.

Варианты: `keep-original` / `keep-conflict` / `merge` (показать diff, решает пользователь) / `keep-both`.

После подтверждения — выполнить, отчёт, обновить `99 System/INDEX.md`.

## Workflow: Query

Триггер: вопрос по содержимому vault.

Читать `99 System/INDEX.md`, затем нужные заметки. Указать, что прочитано и на что опирается ответ. Цитировать через `[[links]]`. Если ответа в vault нет — сказать явно.
ет — сказать явно.