ada-pc: 2026-06-16 20:13:30 | 8

Affected files:
99 System/Export/agent-tools/AGENT_TOOLS.md
99 System/Export/agent-tools/vault_audit.py
99 System/Export/agent-tools/vault_common.py
99 System/Export/agent-tools/vault_frontmatter.py
99 System/Export/agent-tools/vault_index.py
99 System/Export/agent-tools/vault_ingest.py
99 System/INDEX.md
AGENTS.md

AGENTS.md

@@ -1,6 +1,10 @@
 ---
 created: 2026-04-20
-updated: 2026-06-05
+updated: 2026-06-16
+title: Агент — контекст и инструкции для этого хранилища
+status: stable
+type: guide
+tags: [agent, vault]
 aliases: ["Агент — контекст и инструкции для этого хранилища"]
 ---
 
@@ -86,6 +90,16 @@ aliases: ["Агент — контекст и инструкции для это
 - **Обновлять** после создания/удаления/перемещения заметки или изменения frontmatter.
 - **Как:** пройтись по всем `.md` (исключая `.trash`, `.obsidian`, `.git`, `.smart-env`, сам `99 System/INDEX.md`), извлечь frontmatter, перезаписать файл в том же формате (frontmatter с `generated`/`total`, таблицы по секциям).
 
+## Agent tools
+
+Утилиты для ИИ-агентов: `99 System/Export/agent-tools/`.
+
+- Документация: `99 System/Export/agent-tools/AGENT_TOOLS.md`.
+- Вывод скриптов — JSON, чтобы агент мог использовать результат без парсинга Markdown.
+- Read-only команды можно использовать для ориентации: поиск по индексу, план ingest, audit, проверка frontmatter.
+- Write-команды (`vault_index.py rebuild`, `vault_frontmatter.py normalize`) запускать только после подтверждённого workflow или когда правило явно требует обновить `INDEX.md`.
+- Скрипты помогают, но не заменяют чтение исходников и правила этого файла.
+
 ## Workflow: Ingest
 
 Триггер: `ingest` или новые файлы в `00 Inbox/`.