diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index bfc7e4b..ab13eba 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -13,13 +13,13 @@ "state": { "type": "markdown", "state": { - "file": "CLAUDE.md", + "file": "CODEX.md", "mode": "source", "source": false, "backlinks": false }, "icon": "lucide-file", - "title": "CLAUDE" + "title": "CODEX" } } ] @@ -248,6 +248,7 @@ }, "active": "30ac73a39bce2e4c", "lastOpenFiles": [ + "CLAUDE.md", "02 Projects/Наука/Статьи/Статья с Виноградовой.md", "00 Inbox/Основные команды git.md", "00 Inbox/Gitlab.md", @@ -288,7 +289,6 @@ "00 Inbox/Data Plane - Плоскость данных.md", "99 System/Cache/Pasted image 20260429085656.png", "99 System/Cache/Pasted image 20260429085653.png", - "00 Inbox/Алгоритм выбора лидера Lease.md", "diary_Я (копия).csv", "diary_Я.csv", "01 Library/10 Finance/Экономическая Безопасность", diff --git a/CODEX.md b/CODEX.md index 53fcc3d..0948d23 100644 --- a/CODEX.md +++ b/CODEX.md @@ -16,11 +16,18 @@ Vault — второй мозг владельца. Codex помогает ст - **Язык ответов:** русский - **Длина:** коротко и по делу -- **Перед действием:** сначала краткий план с обоснованием, затем выполнение +- **Перед действием:** сначала краткий план с обоснованием; для массовых правок, перемещений и workflow-действий ждать подтверждения - **Стиль:** прагматично, без лишней мотивации и украшений - **Замечания по хранилищу:** говорить сразу, если видны проблемы со структурой, YAML, статусами или связями - **Изменения файлов:** не трогать несвязанные пользовательские правки и не удалять содержимое без явного запроса +## Границы работы + +- Писать только в `00 Inbox/` и `01 Library/`, если пользователь явно не разрешил другое +- Никогда не менять без прямого запроса: `02 Projects/`, `03 Journal/`, `99 System/` +- `99 System/Template/` читать можно, менять только по явному запросу +- При сомнении считать заметку пользовательским материалом и сначала объяснить риск изменения + ## Работа с заметками Шаблоны находятся в `99 System/Template/`. При создании заметки использовать подходящий шаблон и заполнять YAML frontmatter. @@ -49,6 +56,21 @@ Vault — второй мозг владельца. Codex помогает ст - Задача Codex — улучшать форму, связность и пригодность заметок к повторному использованию - Новые материалы лучше связывать с уже существующими заметками, чем создавать изолированные файлы +## Принципы LLM Wiki + +- LLM Wiki — это навигационный слой для человека и LLM: заметки должны быть понятны без скрытого контекста +- Каждая заметка должна отвечать на один главный вопрос или описывать одну устойчивую сущность +- Названия должны быть прямыми и поисковыми, без временных формулировок вроде `разное`, `черновик`, `заметки` +- В начале заметки полезно фиксировать краткое назначение: что это, зачем нужно, с чем связано +- Связи важнее иерархии: использовать `[[wikilinks]]` к понятиям, источникам, MOC и соседним темам +- Связи должны быть осмысленными: не добавлять ссылку только потому, что слово совпало +- YAML нужен для машинной навигации, текст заметки — для человеческого понимания +- Не превращать заметку в пересказ ради полноты; сохранять авторскую мысль, выводы и применимость +- Если материал сырой, оставлять `status: seed`; если структурируется — `processing`; если пригоден как справка — `stable` +- Для LLM важны явные контексты: расшифровывать сокращения, указывать область применения и ограничения +- Дубли лучше объединять через ссылки и MOC, а не плодить почти одинаковые заметки +- Любое автоматическое улучшение должно повышать читаемость, связность или повторное использование + ## Известные проблемы 1. Заметки зависают в `seed`-статусе и не переходят в `stable` @@ -78,3 +100,32 @@ Vault — второй мозг владельца. Codex помогает ст - При массовых правках сначала показать план и область изменений - Не переименовывать и не перемещать заметки без явной причины, потому что это может ломать ссылки - Если не хватает контекста, задать один конкретный вопрос вместо серии уточнений + +## Workflow: Ingest + +Триггер: команда `ingest` или новые файлы в `00 Inbox/`. + +Перед выполнением вывести план: + +- какие файлы из `00 Inbox/` будут обработаны +- какой шаблон используется для каждого файла +- куда создаётся итоговая заметка в `01 Library/` +- какие `[[wikilinks]]` будут проставлены к существующим заметкам + +После подтверждения: + +1. Создать или обновить заметку в `01 Library/` по подходящему шаблону +2. Заполнить YAML frontmatter, поставить `status: seed` +3. Добавить осмысленные `[[wikilinks]]` +4. Переместить исходник в `00 Inbox/Archive/`, если это уместно и подтверждено + +## Workflow: Query + +Триггер: вопрос по содержимому vault. + +Перед ответом указать: + +- какие заметки были прочитаны +- на что опирается ответ + +Отвечать по содержимому `01 Library/`, цитировать конкретные заметки через `[[links]]`. Если ответа в vault нет, сказать это явно и отделить выводы Codex от фактов из заметок.