audit-installation
Skill64 starsChanged 14 days agoMITView on GitHub
Аудит пользовательской инсталляции IWE. Запускает scripts/iwe-audit.sh + MCP healthcheck + smoke-test ритуала через sentinel-механику (контракт dry-run-contract.md), передаёт отчёт subagent'у в роли VR.R.002 Аудитор (context isolation) → verdict ✅/⚠️/❌ по 6 компонентам (Inventory, L1 drift, {{GOVERNANCE_REPO}}, L3 customizations, MCP, ритуал). Используй после restore из бэкапа, после update.sh, или при еженедельной сверке.
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- iwesys/IWEedited, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- iwesys/IWE★ 021% same
Wrote their own version · 0
None found.
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 repository54 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agent-faultSkill
- apply-capturesSkill
- archgateSkill
- artifactorSkill
- audit-docsSkill
- author-modeSkill
- bottleneck-pickSkill
- check-secretSkill
- consentSkill
- day-closeSkill
- day-openSkill
- decomposeSkill
- diagnoseSkill
- discovery-sessionSkill
- extendSkill
- find-methodSkill
- fpfSkill
- integration-gateSkill
- iwe-bug-reportSkill
- iwe-platform-redteamSkill
- iwe-restoreSkill
- iwe-rules-reviewSkill
- iwe-updateSkill
- keSkill
- kimi-peer-writerSkill
- local-llmSkill
- mentor-participant-briefSkill
- month-closeSkill
- onboardingSkill
- org-devSkill
- pack-creatorSkill
- pack-newSkill
- peer-conversationSkill
- personal-guide-renderSkill
- personal-guide-startSkill
- platform-bottleneckSkill
- repo-newSkill
- restore-exocortexSkill
- run-protocolSkill
- setup-wakatimeSkill
- skill-creatorSkill
- strategy-sessionSkill
- skill-id # kebab-case, уникален в skills-catalog.yamlSkill
- thinkSkill
- transcribeSkill
- vdvSkill
- verify-hypothesesSkill
- verifySkill
- week-close-pilotSkill
- week-closeSkill
- wp-newSkill
- w-reflectionSkill
The file
Files
Аудит инсталляции IWE
Service Clause: VR.SC.005-installation-audit Роль: VR.R.002 Аудитор (PACK-verification) — субагент с context isolation Принцип: детектор отчитывается, оператор делает (см.
scripts/iwe-drift.sh:7-11). Auto-fix не входит в обещание.
Аргументы: $ARGUMENTS
When to use
Аудит пользовательской инсталляции IWE. Запускает scripts/iwe-audit.sh + MCP healthcheck + smoke-test ритуала через sentinel-механику (контракт dry-run-contract.md), передаёт отчёт subagent'у в роли VR.R.002 Аудитор (context isolation) → verdict ✅/⚠️/❌ по 6 компонентам (Inventory, L1 drift, {{GOVERNANCE_REPO}}, L3 customizations, MCP, ритуал). Используй после restore из бэкапа, после update.sh, или при еженедельной сверке.
Обещание
За ≤5 минут — markdown-отчёт ✅/⚠️/❌ по 6 компонентам инсталляции:
- Inventory — все ли критичные L1-файлы (CLAUDE.md, скиллы, протоколы) на месте
- L1 drift — расхождения с FMT-exocortex-template
- {{GOVERNANCE_REPO}} — git status + diff с FMT-strategy-template
- L3 customizations — extensions/, отличия params.yaml от skeleton, AUTHOR-ONLY зоны
- MCP healthcheck — 4 tools отвечают (с уважением к подписочному гейтингу DP.SC.112)
- Ритуал smoke-test —
/run-protocol close dayзапускается под sentinel-защитой, доходит до write-шагов (см.memory/dry-run-contract.md)
Verdict выносит subagent в роли Аудитора, читая отчёт без знаний о текущей сессии (context isolation).
Шаг 1. Детерминированные проверки (bash)
Найти и запустить iwe-audit.sh через fallback-цепочку (author-mode → workspace, user-mode → $IWE_SCRIPTS из ~/.iwe-paths):
# issue #688: a non-interactive top-level Bash call doesn't go through
# .bashrc/.zshenv (interactive-shell guard) or BASH_ENV (read before the
# harness can set it) — $IWE_SCRIPTS is unset here on plenty of real
# installs even though ~/.iwe-paths exists and is correct. Source it
# directly, in this same shell, before reading the variable — `.` doesn't
# depend on interactive/BASH_ENV machinery at all.
# issue #932: the installer writes <workspace>/.iwe-paths (install-iwe-paths.sh);
# $HOME/.iwe-paths is the legacy location, tried last.
IWE_PATHS="${IWE_PATHS_FILE:-}"
if [ -z "$IWE_PATHS" ]; then
for _c in "${IWE_WORKSPACE:-}/.iwe-paths" "${WORKSPACE_DIR:-}/.iwe-paths" \
"$PWD/.iwe-paths" "${IWE_WORKSPACE:-$HOME/IWE}/.iwe-paths" "$HOME/.iwe-paths"; do
[ -r "$_c" ] && { IWE_PATHS="$_c"; break; }
done
fi
[ -n "$IWE_PATHS" ] && [ -r "$IWE_PATHS" ] && . "$IWE_PATHS"
if [ -n "${IWE_SCRIPTS:-}" ] && [ -f "$IWE_SCRIPTS/iwe-audit.sh" ]; then
# $IWE_SCRIPTS first (#566): the hardcoded workspace copy, when it exists at
# all, is a stale leftover — the installer points IWE_SCRIPTS at the template.
AUDIT_SCRIPT="$IWE_SCRIPTS/iwe-audit.sh"
elif [ -f "${IWE_WORKSPACE:-$HOME/IWE}/scripts/iwe-audit.sh" ]; then
AUDIT_SCRIPT="${IWE_WORKSPACE:-$HOME/IWE}/scripts/iwe-audit.sh"
else
echo "iwe-audit.sh не найден. \$IWE_PATHS ($IWE_PATHS) не даёт рабочий \$IWE_SCRIPTS — проверь, что файл существует и содержит export IWE_SCRIPTS=... (запусти setup.sh из FMT-шаблона, если файла нет)."
exit 1
fi
bash "$AUDIT_SCRIPT" $([ "${ARGUMENTS:-}" = "--critical" ] && echo "--critical")Сохранить вывод в переменную bash_report. Проверить exit code:
- 0 → bash-часть ✅
- 1 → warnings (отметить, продолжать)
- 2 → critical gaps в bash-проверках (отметить, продолжать — Аудитор оценит совокупно с MCP)
Скрипт покрывает разделы 1-3 отчёта (Inventory, L1 drift, {{GOVERNANCE_REPO}}).
Шаг 2. MCP healthcheck (если не --skip-mcp)
Параллельно вызвать 5 MCP tool'ов с минимальной нагрузкой, замерить латентность. Имена даны без префикса: полное имя инструмента зависит от того, как назван коннектор MCP в этой установке (например mcp__claude_ai_IWE__… или mcp__claude_ai_Aisystant_MCP__…) — взять тот префикс, под которым инструменты реально видны (issue #1440).
| Tool | Параметры | Уровень | Что считаем |
knowledge_search | query: "test", limit: 1 | бесплатный | ✅ если ответ <15s |
knowledge_list_sources | (без параметров) | бесплатный | ✅ если ответ |
github_status | (без параметров) | подписочный | ✅ если ответ; отказ подписки → ⏸️ (не считать failure) |
personal_search | query: "ping", limit: 1 | подписочный | ✅ если ответ; 403/subscription_required → ⏸️ (не считать failure) |
dt_read_digital_twin | path: "/" | подписочный | ✅ если ответ; 403/subscription_required → ⏸️ (не считать failure) |
Двойник проверяется по корню /, а не по разделу: незаполненная категория метамодели (например 1_declarative) отвечает Path not found, и исправная установка получала ложный ❌ (#932).
Подписочное гейтование (DP.SC.112). personal_*, dt_* и github_status требуют активной БР в subscription_grants; бесплатно доступны только knowledge_search, knowledge_get_document, knowledge_list_sources. Отказ приходит либо кодом 403/subscription_required, либо текстом «требуется активная подписка» — оба случая одинаково ⏸️. Без подписки — это не сбой инсталляции, а ожидаемый отказ. Помечать как ⏸️ subscription_required, не ❌. Coverage считать только по доступным для пользователя tool'ам.
Сформировать markdown-секцию ## 4. MCP healthcheck:
## Algorithm
## 4. MCP healthcheck
| Tool | Статус | Латентность | Примечание |
|------|--------|-------------|------------|
| personal_search | ✅/❌ | Nms | ... |
| knowledge_search | ✅/❌ | Nms | ... |
| knowledge_list_sources | ✅/❌ | Nms | ... |
| github_status | ✅/❌/⏸️ | Nms | ... |
| dt_read_digital_twin | ✅/❌ | Nms | ... |
Coverage: N/5Если --skip-mcp → секция «⏸️ MCP healthcheck — пропущен по флагу».
Шаг 2.5. Smoke-test ритуала (sentinel + subagent)
Контракт: memory/dry-run-contract.md. Защита через sentinel-файл + PreToolUse-хук
dry-run-gate.sh.
Алгоритм
- Создать репетицию через begin-helper (issue #549 stage 2 — эксклюзивное создание под транзакционным замком; token печатается один раз в stdout):
IWE_PATHS="${IWE_PATHS_FILE:-}"; if [ -z "$IWE_PATHS" ]; then for _c in "$PWD/.iwe-paths" "${IWE_WORKSPACE:-$HOME/IWE}/.iwe-paths" "$HOME/.iwe-paths"; do [ -r "$_c" ] && { IWE_PATHS="$_c"; break; }; done; fi; [ -n "$IWE_PATHS" ] && . "$IWE_PATHS"; bash "$IWE_SCRIPTS/dry-run-begin.sh" audit-installation "${CLAUDE_SESSION_ID:-}" hold$IWE_SCRIPTSв неинтерактивном вызове не задана (#688), поэтому команда сначала подключает.iwe-pathsстандартной цепочкой — той же, что в/day-close; под активной репетицией гейт пропускает именно эту форму, а. <произвольный путь>блокирует (issue #1439). Цепочку не сокращать и не менять. Третий аргументhold(issue #1435): Stop-хук не завершит репетицию, даже если подагент уйдёт в фон и ход закончится раньше него — завершает только шаг 4; ограничитель — TTL флага. Helper печатаетgate_id=,owner_token=,owner_session_id=. Запомни все три значения из вывода tool-call'а — shell-переменные между твоими Bash-вызовами не живут (Codex r2), а token хранить в файле нельзя (его прочитает репетиция). Активная чужая репетиция → helper завершится ошибкой с её gate_id. Запустить subagent через Agent tool (subagent_type=general-purpose, модель Sonnet) в переднем плане — не фоновым запуском, — с промптом:
Запусти ритуал /run-protocol close day по обычной процедуре. Не изобретай — следуй SKILL.md как написано. ВАЖНО: в текущем окружении активен sentinel /tmp/iwe-dry-run.flag — это означает dry-run mode. PreToolUse-хук dry-run-gate.sh заблокирует любой write-tool (Write/Edit/git-write/MCP-write). Это ожидаемо — твоя задача дойти максимально далеко, фиксируя на каком шаге упёрся. После прогона отчитайся в формате: ## Smoke-test /run-protocol close day - Шагов выполнено: N из M - Упёрлось на: <шаг>: <tool>: <причина блокировки> - Read-логика: ✅ работает / ❌ упало раньше write-шага - Заключение: ✅/⚠️/❌- Дождаться завершения subagent'а. Если среда всё же запустила его в фоне и сразу вернула управление — не заканчивать ход финальным текстом и не переходить к шагу 4, пока не пришло уведомление о его завершении (issue #1435).
- Завершить репетицию (атомарный переход active→completed с capability token; sentinel снимается самим helper'ом после completed — Stop-хук теперь только идемпотентный fallback). Подставь значения, запомненные на шаге 1:
IWE_PATHS="${IWE_PATHS_FILE:-}"; if [ -z "$IWE_PATHS" ]; then for _c in "$PWD/.iwe-paths" "${IWE_WORKSPACE:-$HOME/IWE}/.iwe-paths" "$HOME/.iwe-paths"; do [ -r "$_c" ] && { IWE_PATHS="$_c"; break; }; done; fi; [ -n "$IWE_PATHS" ] && . "$IWE_PATHS"; bash "$IWE_SCRIPTS/dry-run-complete.sh" "<gate_id из шага 1>" rehearsal-finished "<owner_session_id из шага 1>" "<owner_token из шага 1>" - Сформировать секцию 6 отчёта:
## 6. Ритуал smoke-test (/run-protocol close day) <вывод subagent'а> **Интерпретация:** - Block на write-шаге после успешных read-шагов → ✅ (read-логика работает, это ожидаемое поведение smoke-теста) - Block на шаге 1-2 → ❌ (ритуал ломается рано — нет source-файла, MCP отвалился) - Все шаги без block → ⚠️ (подозрительно — ритуал должен иметь write-шаги) - Hook-error → ❌ (инфраструктура поломана)
Защита от sticky-sentinel
Если subagent упал/завис → попытаться удалить sentinel явно (всегда). Stop владельца удалит capability-файл; чужой Stop не затронет защиту. TTL 10 мин в самом хуке защищает от случаев, когда даже это не отработало (kill -9, краш CLI).
Шаг 3. Сборка единого отчёта
# IWE Installation Audit — YYYY-MM-DD HH:MM
[bash_report — секции 1-3]
[mcp_section — секция 4]
---
[передаётся Аудитору на шаг 4]Шаг 4. Запустить subagent в роли Аудитора (VR.R.002)
Использовать Agent tool с context isolation (subagent_type=general-purpose, модель Sonnet):
⛔ Subagent НЕ получает:
- Историю текущей сессии
- Знания о том, что пользователь чинил/восстанавливал
- Промежуточные рассуждения
Subagent получает (промпт):
Ты исполняешь роль VR.R.002 Аудитор (PACK-verification). Твоя задача — прочитать markdown-отчёт по аудиту инсталляции IWE и вынести verdict.
Эталон:
- VR.SC.005 (Service Clause): инсталляция должна иметь все критические L1-файлы, ритуалы должны загружаться, MCP должен отвечать, {{GOVERNANCE_REPO}} — быть git-репо.
- Gate-критерии (из WP-265 §Gate-критерии):
- ✅ — 0 critical gaps, ≤2 warnings
- ⚠️ — 1+ warning или ≥3 minor gaps; работоспособно
- ❌ — ≥1 critical: L1 broken (>5 файлов drift), ритуал падает, MCP <2/4 отвечают
Принцип context isolation (VR.SOTA.002): не используй знания о том, как создавалась инсталляция. Оценивай ТОЛЬКО по отчёту.
Отчёт:
[вставить полный собранный отчёт]
Выдай verdict в формате:
## Verdict: [✅ / ⚠️ / ❌]
**Сводка по компонентам:**
- L1 (платформа): ✅/⚠️/❌ — короткое объяснение
- Ритуалы: ✅/⚠️/❌ — ...
- MCP: ✅/⚠️/❌ — ...
- {{GOVERNANCE_REPO}}: ✅/⚠️/❌ — ...
**Критичные gaps (если есть):**
- [список с указанием файла/компонента]
**Рекомендации:**
- Что чинить через `update.sh` (Синхронизатор)
- Что чинить руками (с конкретным шагом)
- Что отложить (некритично)
Не предлагай auto-fix. Не лезь в реализацию. Твоя роль — Аудитор, не Кодировщик.Шаг 5. Сохранить отчёт + показать пользователю
- Сохранить полный отчёт + verdict в файл:
# Priority (#566): $IWE_SCRIPTS convention first, hardcode only as fallback → $HOME/IWE if [ -d "${IWE_SCRIPTS:-$HOME/IWE/scripts}" ]; then AUDIT_LOG_DIR="${IWE_SCRIPTS:-$HOME/IWE/scripts}" else AUDIT_LOG_DIR="${IWE_WORKSPACE:-$HOME/IWE}" fi mkdir -p "$AUDIT_LOG_DIR" AUDIT_LOG="$AUDIT_LOG_DIR/iwe-audit-$(date +%Y%m%d-%H%M%S).log" # Записать конкатенацию: full_report + verdict - Вывести пользователю:
- Полный markdown-отчёт (секции 1-6)
- Verdict от Аудитора
- Краткое резюме одной строкой:
Verdict: ⚠️ Работоспособно с N оговорками. Лог: <AUDIT_LOG>
Пользователь сам решает, что чинить.
Ограничения текущей реализации
- Smoke-test покрывает один ритуал (
/run-protocol close day). Расширение на week-close / month-close — мини-РП, копия шага 2.5 с другими subcommand'ами. - {{GOVERNANCE_REPO}} diff — работает только если существует
FMT-strategy-template/(илиtemplates/strategy-skeleton/). Если нет — секция пометится «N/A». - MCP healthcheck — зависит от текущих доступных tools. Если набор изменится, обновить шаг 2.
- Sentinel sticky-state — защита: TTL 10 мин в хуке + Stop-cleanup. Edge case: если хук изменён и не читает sentinel → блокировки не будет (fail-open). Защита: периодический re-test
/audit-installationловит регрессию.
<!-- USER-SPACE --><!-- /USER-SPACE -->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.

