---
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/Tools/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`.