obsidian-reconcile — команда Claude Code
Команда obsidian-reconcile для Claude Code выявляет противоречия в Obsidian-vault и разрешает их автоматически или выносит на решение. Сканирует всё хранилище или отдельную тему, сверяя утверждения и свежесть источников.
MIT ★ 5 412 обновлён 2026-10-24
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brainЧто делает obsidian-reconcile
Команда ищет противоречия четырьмя способами: сравнивает утверждения в папках concepts и projects, проверяет актуальность ролей и компаний в entities, отслеживает отменённые решения в decisions и сверяет даты источников в raw/ и wiki/.
Каждое найденное противоречие проходит проверку — вытягивается две цитаты из разных заметок, скрипт верифицирует их наличие по строке и пути. Если обе цитаты на месте, команда оценивает, какой источник свежее и авторитетнее. Противоречие разрешается одним из трёх способов: устаревшая заметка переписывается с пометкой истории, двусмысленная ситуация переводится в заметку Conflict с обоими утверждениями для ручного решения, или факт признаётся эволюцией — человек изменил мнение, и это отражается в контексте.
Команда требует структуры vault: папка references/ с файлами folder-map.md и ai-first-rules.md, логи записываются в Logs/YYYY-MM-DD.md или log.md. Новые и изменённые заметки следуют AI-first правилам — фронтматтер с типом, датой, тегами, вики-ссылками и источниками.
Какие задачи решает
- найти противоречивые утверждения в разных заметках
- обновить устаревшие факты на основе свежих источников
- выявить отменённые решения, которые остались в других частях vault
- документировать спорные моменты, когда нет явного победителя
Примеры запросов агенту
- Найди противоречия в моём vault
/obsidian-reconcile - Сверь факты по теме архитектуры
/obsidian-reconcile architecture - Проверь, есть ли конфликты в описаниях компаний
/obsidian-reconcile entities
Как установить obsidian-reconcile
1Через маркетплейс плагинов
/plugin marketplace add eugeniughelbur/obsidian-second-brain/plugin install obsidian-second-brain@obsidian-second-brain2Вручную: положить файлы
.claude/commands/obsidian-reconcile.mdВызов — /obsidian-reconcile. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/obsidian-reconcile.mdВызов — /prompts:obsidian-reconcile. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/obsidian-reconcile.prompt.mdВручную: положить файлы
.gemini/commands/obsidian-reconcile.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об obsidian-reconcile
Как установить obsidian-reconcile в Claude Code?
Выполни по порядку: /plugin marketplace add eugeniughelbur/obsidian-second-brain, затем /plugin install obsidian-second-brain@obsidian-second-brain, потом создай файл .claude/commands/obsidian-reconcile.md с конфигурацией команды.
Что делает obsidian-reconcile?
Ищет противоречия в Obsidian-vault — разные версии одного факта в разных заметках — и либо автоматически обновляет заметки на свежие данные, либо создаёт конфликтную заметку для ручного решения.
Какая структура vault нужна для работы команды?
Нужны папка references/ с файлами folder-map.md (карта расположения папок) и ai-first-rules.md (правила оформления новых заметок), а также _CLAUDE.md и index.md в корне. Логи записываются в Logs/ или в корневой log.md.
Исходный текст
obsidian-reconcile.md · MIT
---
description: Find and resolve contradictions in the vault - the vault maintains its own truth
category: thinking
triggers_en: ["find contradictions", "reconcile vault", "fix conflicts", "vault contradictions"]
triggers_de: ["Widersprüche finden", "Vault abgleichen", "Konflikte lösen", "Widersprüche im Vault"]
triggers_es: ["busca contradicciones", "concilia el vault", "resuelve los conflictos", "contradicciones en el vault"]
triggers_pt: ["encontre contradições", "reconcilie o vault", "corrija conflitos", "contradições do vault"]
triggers_zh: ["找出知识库里的矛盾", "解决笔记之间的冲突", "核对相互矛盾的说法", "让知识库里的事实保持一致"]
---
Use the obsidian-second-brain skill. Execute `/obsidian-reconcile $ARGUMENTS`:
The optional argument is a topic or entity to focus on. If not provided, scan the whole vault.
1. Read `_CLAUDE.md` first if it exists in the vault root
2. Read `index.md` to understand the full vault landscape
3. Spawn parallel subagents to find contradictions:
- **Claims agent**: scan the concepts and projects folders (resolved per `references/folder-map.md`) for factual claims - find pairs that contradict each other
- **Entity agent**: scan the entities folders (resolved per `references/folder-map.md`, which gives Obsidian-style vaults a separate folder for some entity kinds) for outdated roles, companies, or descriptions that conflict with newer sources
- **Decisions agent**: scan the decisions folder (resolved per `references/folder-map.md`) and project Key Decisions for reversed or superseded decisions that were never updated
- **Source freshness agent**: compare `raw/` source dates against `wiki/` page dates - flag wiki pages that reference old sources when newer ones exist on the same topic
The claims, entity and decisions agents return each contradiction as two claims, one per side. Each claim has the note's vault-relative `path`, the `line` number, and a `quote`: one line copied character for character from that note, at least 12 characters long. A contradiction without both quotes is not a finding. Pass this format to every subagent.
4. Prove each contradiction before acting on it. Send both claims to the checker (the skill root's absolute path was given at session start as **Skill root**; substitute it for `SKILL_ROOT`):
```bash
uv run --directory "SKILL_ROOT" scripts/verify_quotes.py --path <vault> <<'EOF'
[{"path": "<note path>", "line": 12, "quote": "<line copied from that note>"},
{"path": "<other note path>", "line": 40, "quote": "<line copied from that note>"}]
EOF
```
- Both claims must come back `"ok": true`. If either fails, drop the contradiction: no rewrite, no conflict note. List it under **Dropped as unproven** with the `reason` the checker gave.
- Use `found_line` from the output, not the line the subagent gave.
- Source freshness findings compare dates, not claims, so they skip this step.
For each proven contradiction, evaluate:
- **Which source is newer?** (date comparison)
- **Which source is more authoritative?** (peer-reviewed > blog post > transcript > opinion)
- **Is this a genuine contradiction or an evolution?** (someone changing their mind is not a contradiction - it's growth)
5. Resolve each contradiction:
- **Clear winner**: rewrite the outdated page with current info. Add a `## History` section noting what changed and why, with the proven quote it replaced: "Previously stated X (source: raw/articles/old-article.md, 2025-11-01). Updated to Y based on newer evidence (source: raw/articles/new-article.md, 2026-03-15)."
- **Genuinely ambiguous**: create `Conflict - Topic.md` in the decisions folder (resolved per `references/folder-map.md`; `type: conflict`, schema in `references/ai-first-rules.md`) documenting both sides with their verbatim quotes and `path:line`, the evidence for each, and mark as `status: open` for the user to decide
- **Evolution**: update the entity/concept page to reflect the current state and add the historical context
6. After all resolutions:
- Rebuild affected sections of `index.md`
- Append to the operation log: if `Logs/` exists write `**HH:MM** - reconcile | X contradictions reported, P proven, D dropped as unproven, Y auto-resolved, Z flagged for user` to `Logs/YYYY-MM-DD.md`; otherwise append `## [YYYY-MM-DD] reconcile | X contradictions reported, P proven, D dropped as unproven, Y auto-resolved, Z flagged for user` to `log.md`
- Update today's daily note with a reconciliation summary
7. Report back:
- **Auto-resolved** (list with old claim → new claim and why)
- **Flagged for user** (genuinely ambiguous - needs human judgment)
- **Stale pages updated** (pages rewritten with fresher sources)
- **Dropped as unproven** (each claim, its `path`, and the checker's `reason`)
The vault should never contain two pages that disagree without knowing they disagree. Contradictions are either resolved or explicitly documented as open questions. A contradiction nobody can quote is not resolved at all: rewriting a note to fix a disagreement that is not there puts a new error into the vault.
---
**AI-first rule:** Every note created or updated by this command MUST follow `references/ai-first-rules.md` - `## For future agent` preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`, plus type-specific fields), recency markers per external claim, mandatory `[[wikilinks]]` for every person/project/concept referenced, sources preserved verbatim with URLs inline, and confidence levels where applicable. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule. The vault is for future agent retrieval - not human reading.
**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.
© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain