Files
Dmitry 22eda53d79 ada-pc: 2026-06-16 20:18:31 | 9
Affected files:
.obsidian/graph.json
99 System/INDEX.md
99 System/Tools/agent-tools/AGENT_TOOLS.md
99 System/Tools/agent-tools/vault_audit.py
99 System/Tools/agent-tools/vault_common.py
99 System/Tools/agent-tools/vault_frontmatter.py
99 System/Tools/agent-tools/vault_index.py
99 System/Tools/agent-tools/vault_ingest.py
AGENTS.md
2026-06-16 20:18:32 +03:00

2.7 KiB

title, status, type, tags, created, updated, aliases
title status type tags created updated aliases
Agent tools для vault stable guide
agent
tooling
vault
2026-06-16 2026-06-16

Agent tools для vault

Набор утилит для ИИ-агентов. Вывод — JSON, чтобы агент мог читать результат без парсинга Markdown-таблиц.

Запускать из корня vault:

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.