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

99 System/Export/agent-tools/AGENT_TOOLS.md

@@ -0,0 +1,57 @@
+---
+title: Agent tools для vault
+status: stable
+type: guide
+tags: [agent, tooling, vault]
+created: 2026-06-16
+updated: 2026-06-16
+aliases: []
+---
+
+# Agent tools для vault
+
+Набор утилит для ИИ-агентов. Вывод — JSON, чтобы агент мог читать результат без парсинга Markdown-таблиц.
+
+Запускать из корня vault:
+
+```bash
+python3 "99 System/Export/agent-tools/vault_index.py" dump
+```
+
+## Команды
+
+### `vault_index.py`
+
+- `dump` — вывести все заметки из vault как JSON.
+- `query --term "CI/CD" --limit 10` — найти близкие заметки.
+- `rebuild` — пересобрать `99 System/INDEX.md`. Это write-команда.
+
+### `vault_ingest.py`
+
+- `scan` — показать файлы из `00 Inbox/` и `01 Ideas/`.
+- `classify PATH` — эвристически классифицировать источник.
+- `plan PATH` — выдать JSON-план ingest: назначение, похожие заметки, возможные wikilinks.
+
+Команды read-only. Они не заменяют обязательный план и подтверждение перед workflow.
+
+### `vault_audit.py`
+
+- `broken-links` — найти wikilinks на несуществующие заметки.
+- `orphans` — найти заметки без входящих ссылок.
+- `source-links` — проверить wikilinks в `source`.
+- `components` — найти компоненты графа ссылок.
+- `all` — выполнить все проверки.
+
+Команды read-only.
+
+### `vault_frontmatter.py`
+
+- `check [PATH ...]` — проверить обязательные поля и допустимые `status/type`.
+- `normalize PATH ...` — нормализовать frontmatter выбранных файлов. Это write-команда.
+
+## Правила для агентов
+
+- Перед `ingest`, `wiki`, `audit`, `remind`, `query` сначала читать `99 System/INDEX.md`; скрипты помогают, но не отменяют правила `AGENTS.md`.
+- Write-команды запускать только когда workflow уже подтверждён пользователем или правило явно требует обновить индекс.
+- `vault_ingest.py plan` — вспомогательный план, не окончательное решение. Агент обязан проверить содержимое источника сам.
+- После создания, удаления, перемещения заметки или изменения frontmatter запускать `vault_index.py rebuild`.