deep-audit
Skill9 starsChanged 4 months agoMITView on GitHub
Глубокий аудит заметок AI workspace — структура, связи, провенанс, качество, переход тегов. 5 заметок за запуск. Запускать когда нужно улучшить качество базы знаний.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- Braydenh563/Tessellatetheir own version, first seen Nov 8, 2026
- Braydenh563/MemoryMap-AItheir own version, first seen Nov 8, 2026
- pedrohcgs/claude-code-my-workflowtheir own version, first seen Nov 7, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- pedrohcgs/claude-code-my-workflow★ 1.7ksame name
- Braydenh563/MemoryMap-AI★ 4same name
- Braydenh563/Tessellate★ 4same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository4 other files it gives its agents.
- AI workspace/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- compileSkill
- vault-health-checkSkill
The file
Files
Проведи глубокий аудит заметок AI workspace/.
Все конвенции (типы заметок, frontmatter, теги, wikilinks, alias, Zero links, провенанс, флаги, имена файлов, пороги создания/наполненности/устаревания, переход 🌱 → 🌲) — в [[Как я веду заметки]]. Аудит проверяет соответствие этим конвенциям. Скилл описывает действия, не правила.
Шаги
Выбери 5 заметок. Приоритет:
- Заметки с задачей
⚠️ Stale (>18 мес)(флаг от/vault-health-check):
Для таких заметок оценить актуальность и при необходимости понизить тегobsidian-cli search query="path:\"AI workspace/\" \"⚠️ Stale\""🌲 → 🌱осознанно. Задачу снять после оценки. - Заметки без
ai-audited-at:obsidian-cli search query="path:AI workspace -[ai-audited-at]" - Оставшиеся слоты — самые старые
ai-audited-at. Tie-break: лексикографически по имени файла.
Исключить: MOC (
00 *.md),proposals.md,CLAUDE.md,drafts/.После выбора — вывести блок:
## План аудита <дата> 1. <заметка>.md — приоритет: stale | no-ai-audited-at | oldest 2. ... 5. ...Этот блок — единственный вход для шага 3. Без него шаг 3 не выполнять.
- Заметки с задачей
- Проверь MOC — дополнительно к 5, не в счёт. Для каждого MOC, на который аудируемая заметка ссылается через
# Zero links, применить критерии MOC ниже. - Аудит каждой заметки по критериям ниже. Для каждой заметки из плана 1 — вывести в ответ чеклист 8 категорий (это вход для шага 4):
Без полного чеклиста (все 8 категорий)## Аудит [[<заметка>]] - [x] Структура: <что проверил/исправил, либо «нет находок»> - [x] Противоречия: <результат> - [x] Связи: <добавил/исправил, либо «нет находок»> - [x] Провенанс: <добавил, либо «нет находок»> - [x] Новые definitions: <создал, либо «нет находок»> - [x] Качество: <исправил/флаги, либо «нет находок»> - [x] Имя файла (language): pass | переименовано `<старое>` → `<новое>` (backlinks обновлены: N) - [x] Переход тегов: <решение и причина>ai-audited-atне проставлять. После чеклиста обновить в frontmatter заметки:ai-audited-at: $(date "+%Y-%m-%d %H:%M") Завершение — отчёт пользователю. Числа в логе копируются из чеклистов шага 3, не пересчитываются:
проверено N= количество блоков## Аудит ...в ответеисправлено K= сумма категорий с фактическими правками (не «нет находок») по всем чеклистамповышено J= категории «Переход тегов» с решением🌱→🌲
Коммит одной пачкой по итогам аудита:
cd "AI workspace" && git add -A && git commit -m 'audit: <N> заметок, fix <K>, 🌱→🌲 <J> <свободная сводка: какие заметки, что исправлено, что требует внимания>'Subject ~50 символов (потолок 72). Одинарные кавычки в
-m, апостроф в сообщении запрещён. Подробности вAI workspace/CLAUDE.md→ «Версионирование».
Критерии MOC
- Все ссылки аннотированы (нет голых
[[ссылок]]без пояснения)? - Есть ли definition/evergreen/саммари/исследования/кейсы по теме, которые отсутствуют в MOC?
- Все ссылки соответствуют alias-правилу из [[Как я веду заметки]]?
Критерии заметки
Структура
# Zero linksсодержит родительский MOC.MOC знает об этой заметке:
obsidian-cli backlinks file="<заметка>". Если нет — добавить в раздел MOC по типу:- evergreen →
## Главные идеи - саммари →
## Источники - исследование →
## Исследования - кейс →
## Кейсы - definition note → в тематическую прозу (не отдельная секция)
MOC в
Base/— не редактировать напрямую. Запись вAI workspace/proposals.md: имя MOC, раздел, формулировка ссылки. Пользователь смержит вручную.- evergreen →
Противоречия — для ключевых тезисов (заголовок + опорные утверждения, не каждое предложение):
obsidian-cli search:context query="<тезис>" 2>/dev/null | head -20Противоречие = явное отрицание или несовместимое числовое значение, не просто связанная тема. При находке — в обеих заметках добавить задачу - [ ] ⚠️ Противоречие [[X]] ↔ [[Y]] — разобрать (формат в [[Как я веду заметки]] раздел Флаги), вынести в отчёт.
Связи
- Ключевые термины залинкованы на definition notes (точные совпадения, alias-правило из [[Как я веду заметки]]).
- Новые связи и missing backlinks:
obsidian-cli search:context query="<концепт>" | head -30. Добавлять ссылки только вAI workspace/,Base/не трогать. - Нарушения alias — исправить по [[Как я веду заметки]] раздел Wikilinks.
Провенанс
- В теле есть фактические утверждения без
[^n], источник упомянут в# Дополнительные источникиили в footnote-определении → добавить сноски[^n]к утверждениям, прямые цитаты оформить блоком>с атрибуцией. Если в результате источник стал залинкован в теле — буллет в# Дополнительные источникиудалить (правило недублирования). - Источник не найти → задача
- [ ] ⚠️ Источник не указан — найти для: «<утверждение>»(см. [[Как я веду заметки]] раздел Провенанс случай 4).
Новые definition notes
Термин без definition note → оценить по критериям из [[Как я веду заметки]] раздел Definition note. Создать в AI workspace/ если выполнены; иначе → 📥inbox-стаб.
Качество
- Атомарность — одна идея? Два независимых тезиса → создать черновик разбиения
drafts/<имя> — split — draft.md, в исходной добавить- [ ] Разбить заметку на атомарные тезисы. - Заголовок (evergreen) — утверждение, понятное без контекста? Тема вместо тезиса →
- [ ] Переформулировать заголовок: «<вариант>», предложить пользователю. - Открытые вопросы (TODO, «нужно разобраться») → вынести в
📥inbox-стаб со ссылкой на исходник, в заметке заменить вопрос на ссылку на стаб. - Пустое тело — применить порог наполненности из [[Как я веду заметки]] раздел Теги. Definition/evergreen →
📥inbox+ задача- [ ] ⚠️ Не наполнено — наполнить содержанием: «<имя>»; саммари →status: todo+ та же задача. - Устаревшие утверждения — применить правило жизненного цикла фактов из [[Как я веду заметки]]: задача
- [ ] ⚠️ Устарело — проверить актуальность: «<цитата>», понизить тег до🌱.
Исследование и Кейс
- Поля тела заполнены по структуре из [[Как я веду заметки]] раздел Типы заметок?
- Frontmatter заполнен по соответствующему шаблону
Templates/Шаблон. Исследование.md/Templates/Шаблон. Кейс.md— нет пустых обязательных полей? - Результат содержит конкретные цифры или измеримый эффект?
- Заметка в соответствующем разделе MOC?
Имя файла (language)
Хард-gate: имя проверяется по тому же правилу языка, что и тело ([[Как я веду заметки]] раздел Язык изложения; CLAUDE.md раздел «Имена файлов» → «Язык в именах файлов»). Англицизм допустим только в одной из четырёх категорий:
(a) нет русского эквивалента (MLOps, Kubernetes);
(b) устоявшийся термин в vault (DORA, SPACE, MapKit, microrepos, blast radius, pre-submit, post-submit, CI-CD);
(c) имя собственное (Amazon, Google, Meta);
(d) технический идентификатор (Git, JSON, k8s, P^N).
Иначе — переименование:
- Сформулировать русский вариант, проверить, что новое имя не нарушает запрещённые символы (
CLAUDE.mdраздел «Имена файлов»). cd "AI workspace" && git mv "<старое>.md" "<новое>.md".- Найти все backlinks:
obsidian-cli backlinks file="<старое>". Обновить wikilinks в каждой ссылающейся заметке черезEdit. Backlinks изBase/не трогать — записать вproposals.mdблок с именем заметки в Base/ и точным diff'ом нужной правки, пользователь смержит вручную. - Проверить
obsidian-cli unresolved— не осталось ли ссылок на старое имя. - В чеклисте отчитаться:
переименовано "<старое>" → "<новое>" (backlinks обновлены: N; в proposals.md записей: M).
Антипаттерны (видели в прошлых сессиях): bad checkin → плохой коммит; AND/OR (как идиома) → вместе/на выбор; team performance → командная результативность; rollback capability → возможность отката; flawed detour → ошибочный обход.
Переход тегов
Применить правило 🌱 → 🌲 из [[Как я веду заметки]]. Дополнительно для evergreen: идея портативна (применима за пределами источника) и цитируема (на неё хочется ссылаться). Если нет — оставить 🌱 или понизить до 📥inbox.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

