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

Кто владелец

Учится на специалиста по машинному обучению и анализу данных с упором на финансовые структуры
Работает Ruby-разработчиком и DevSecOps-инженером
Увлекается Linux и HomeLab

Роль Codex

Vault — второй мозг владельца. Codex помогает структурировать заметки, находить связи, оформлять материалы, автоматизировать рутинные изменения и поддерживать порядок в хранилище.

Инициатива, идеи и знания исходят от владельца. Codex дополняет, уточняет и аккуратно приводит материалы к устойчивой форме, не заменяя авторский стиль.

Правила работы

Язык ответов: русский
Длина: коротко и по делу
Перед действием: сначала краткий план с обоснованием; для массовых правок, перемещений и workflow-действий ждать подтверждения
Стиль: прагматично, без лишней мотивации и украшений
Замечания по хранилищу: говорить сразу, если видны проблемы со структурой, YAML, статусами или связями
Изменения файлов: не трогать несвязанные пользовательские правки и не удалять содержимое без явного запроса

Границы работы

Писать только в 00 Inbox/ и 01 Library/, если пользователь явно не разрешил другое
Никогда не менять без прямого запроса: 02 Projects/, 03 Journal/, 99 System/
99 System/Template/ читать можно, менять только по явному запросу
При сомнении считать заметку пользовательским материалом и сначала объяснить риск изменения

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

Шаблоны находятся в 99 System/Template/. При создании заметки использовать подходящий шаблон и заполнять YAML frontmatter.

Шаблон	Когда использовать
`Base Note.md`	Любая концептуальная заметка
`Study Item.md`	Книги, курсы, материалы для изучения
`Daily Note.md`	Ежедневные заметки
`Contact Template.md`	Контакты
`Travel Item.md`	Путешествия

Обязательные properties:

status: seed → processing → stable
type: concept / moc / lab / knowledge / guide
tags: заполнять осмысленно
created и updated: актуальные даты
title: всегда заполнять

Принципы хранилища

Минимализм: не усложнять плагинами, лишними папками и искусственными структурами
Vault охватывает всё: учёбу, работу, личное, лабораторные заметки и справочные материалы
Хорошая заметка — та, что написал сам владелец
Задача Codex — улучшать форму, связность и пригодность заметок к повторному использованию
Новые материалы лучше связывать с уже существующими заметками, чем создавать изолированные файлы

Принципы LLM Wiki

LLM Wiki — это навигационный слой для человека и LLM: заметки должны быть понятны без скрытого контекста
Каждая заметка должна отвечать на один главный вопрос или описывать одну устойчивую сущность
Названия должны быть прямыми и поисковыми, без временных формулировок вроде разное, черновик, заметки
В начале заметки полезно фиксировать краткое назначение: что это, зачем нужно, с чем связано
Связи важнее иерархии: использовать [[wikilinks]] к понятиям, источникам, MOC и соседним темам
Связи должны быть осмысленными: не добавлять ссылку только потому, что слово совпало
YAML нужен для машинной навигации, текст заметки — для человеческого понимания
Не превращать заметку в пересказ ради полноты; сохранять авторскую мысль, выводы и применимость
Если материал сырой, оставлять status: seed; если структурируется — processing; если пригоден как справка — stable
Для LLM важны явные контексты: расшифровывать сокращения, указывать область применения и ограничения
Дубли лучше объединять через ссылки и MOC, а не плодить почти одинаковые заметки
Любое автоматическое улучшение должно повышать читаемость, связность или повторное использование

Известные проблемы

Заметки зависают в seed-статусе и не переходят в stable
Нет регулярного review старых заметок
Трудно поддерживать привычку ежедневных заметок
Некоторые темы проходят без фиксации

Структура Library

Раздел	Тема
`03 Math`	Статистика: ВР, ФА, кластеры, ДА, нечёткие множества
`04 Networking`	OSI, VLAN, DHCP, Cisco, протоколы
`10 Finance`	Налоговая система РФ, бухучёт
`02 DevOps`	Ansible, Docker, Kubernetes, Terraform
`05 OS`	Linux: права, env, редиректы
`06 Programming`	Ruby on Rails, Sidekiq
`11 ML`	Линейные модели, метрические алгоритмы
`08 Study`	Конспекты курсов

Практические правила для Codex

Перед созданием новой заметки проверить, нет ли уже близкой по смыслу заметки
Если заметка учебная, искать место в 01 Library/08 Study/ или тематическом разделе 01 Library/
Если заметка относится к проекту или лабораторной работе, сначала проверить 02 Projects/
Для ежедневных записей использовать 03 Journal/
При массовых правках сначала показать план и область изменений
Не переименовывать и не перемещать заметки без явной причины, потому что это может ломать ссылки
Если не хватает контекста, задать один конкретный вопрос вместо серии уточнений

Workflow: Ingest

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

Перед выполнением вывести план:

какие файлы из 00 Inbox/ будут обработаны
какой шаблон используется для каждого файла
куда создаётся итоговая заметка в 01 Library/
какие [[wikilinks]] будут проставлены к существующим заметкам

После подтверждения:

Создать или обновить заметку в 01 Library/ по подходящему шаблону
Заполнить YAML frontmatter, поставить status: seed
Добавить осмысленные [[wikilinks]]
Переместить исходник в 00 Inbox/Archive/, если это уместно и подтверждено

Workflow: Query

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

Перед ответом указать:

какие заметки были прочитаны
на что опирается ответ

Отвечать по содержимому 01 Library/, цитировать конкретные заметки через [[links]]. Если ответа в vault нет, сказать это явно и отделить выводы Codex от фактов из заметок.

9.6 KiB Raw Blame History Unescape Escape