Dmitry
150 lines
9.5 KiB
Markdown
150 lines
9.5 KiB
Markdown
---
|
||
created: 2026-04-20
|
||
updated: 2026-05-22
|
||
title: Агент — контекст и инструкции для этого хранилища
|
||
---
|
||
|
||
# Агент — контекст и инструкции для этого хранилища
|
||
|
||
## Контекст
|
||
|
||
**Владелец:** 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, не плодить похожие файлы.
|
||
- Перед созданием новой заметки проверить `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
|
||
|
||
`INDEX.md` в корне vault — главный справочник агента: все заметки с путём, title, status, type, tags.
|
||
|
||
- **Читать** в начале любого workflow вместо сканирования vault.
|
||
- **Обновлять** после создания/удаления/перемещения заметки или изменения frontmatter.
|
||
- **Как:** пройтись по всем `.md` (исключая `.trash`, `.obsidian`, `.git`, `.smart-env`, `.stversions`, сам `INDEX.md`), извлечь frontmatter, перезаписать файл в том же формате (frontmatter с `generated`/`total`, таблицы по секциям).
|
||
|
||
## Workflow: Ingest
|
||
|
||
Триггер: `ingest` или новые файлы в `00 Inbox/`.
|
||
|
||
Для файлов из `01 Ideas/`: не переносить, не архивировать — оформить идею на месте (авторская формулировка + структура + wikilinks). Картинки: изучить, решить — вынести текстом или оставить.
|
||
|
||
**План перед выполнением:** какие файлы, какой шаблон, куда в `90 Library/`, какие wikilinks.
|
||
|
||
**После подтверждения:**
|
||
1. Читать `INDEX.md` → найти связанные заметки → решить: дополнить существующую или создать новую.
|
||
2. Создать/дополнить заметку в `90 Library/` по шаблону. Расширить, структурировать, заполнить frontmatter, `status: seed`.
|
||
3. Добавить осмысленные `[[wikilinks]]`.
|
||
4. Исходник → `99 System/Archive/`. В frontmatter заметки: `source: "[[имя_файла]]"`.
|
||
5. Обновить `INDEX.md`.
|
||
6. Показать список предложенных связей, которые не добавлены автоматически.
|
||
|
||
## Workflow: Wiki
|
||
|
||
Триггер: `wiki [тема]` — создать заметку из знаний агента без исходника.
|
||
|
||
**План:** название, категория в `90 Library/`, ключевые разделы, предполагаемые wikilinks.
|
||
|
||
**После подтверждения:**
|
||
1. Читать `INDEX.md` → убедиться, что близкой заметки нет.
|
||
2. Создать по `Base Note.md`, наполнить, `status: seed`, проставить wikilinks.
|
||
3. Обновить `INDEX.md`. Показать незакрытые связи.
|
||
|
||
## Workflow: Audit
|
||
|
||
Триггер: `audit`.
|
||
|
||
Читать `INDEX.md`. Проверить:
|
||
- **orphan notes** — без входящих ссылок
|
||
- **broken wikilinks** — ссылки на несуществующие файлы; если в `source:` frontmatter — заменить `"[[имя]]"` на `"имя"` (plain text)
|
||
- **изолированные кластеры** — группы без связей с остальным графом
|
||
- **предложения** — какие заметки стоит связать
|
||
|
||
Отчёт по каждому пункту с конкретными файлами. Если исправлены broken links — обновить `INDEX.md`.
|
||
|
||
## Workflow: Remind
|
||
|
||
Триггер: `remind`.
|
||
|
||
Читать `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`.
|
||
|
||
После подтверждения — выполнить, отчёт, обновить `INDEX.md`.
|
||
|
||
## Workflow: Query
|
||
|
||
Триггер: вопрос по содержимому vault.
|
||
|
||
Читать `INDEX.md`, затем нужные заметки. Указать, что прочитано и на что опирается ответ. Цитировать через `[[links]]`. Если ответа в vault нет — сказать явно.
|