/audit

name: audit
description: 7-tuple оценка здоровья проекта (Instructions / State / Verification / Scope / Lifecycle / Learning / Cost-Safety) через ВНЕШНЕГО evaluator-agent (не self-bias). Бонус — error velocity, recurrence rate, top root-causes. Триггеры — "/audit", "оценка проекта", "состояние харнеса".
when_to_use: Раз в неделю или при подозрении что что-то «не так». Регулярный диагностический инструмент.

/audit

Внешняя оценка здоровья проекта. Закрывает self-bias из критики v5.0.

Главная защита: External Evaluator

`/audit` НЕ оценивает себя. Запускает отдельный subagent (Sonnet, fresh context) с **read-only** доступом к артефактам проекта. Этот subagent НЕ читает `.harness/assessment.json` от предыдущего аудита — иначе он будет подвержен self-bias.

Subagent промпт-шаблон:

Ты — независимый аудитор проекта. Не работаешь с этой кодовой базой.
Прочитай ТОЛЬКО:
- CLAUDE.md
- README.md (для людей)
- feature_list.json
- SESSION.md
- domain-rules.yaml
- error-journal.md (если есть)
- docs/ARCHITECTURE.md, docs/PRODUCT.md
- .harness/tools-allowlist.yaml (если есть)
- последние 10 коммитов git log

НЕ читай: предыдущие assessment, прошлые audit results.

Оцени 7 подсистем по шкале 1-5:
- 1: отсутствует или вредна
- 2: weak, inconsistent
- 3: adequate, basics covered
- 4: good, minor gaps
- 5: exemplary, enforced

Для каждой — конкретное обоснование (1-2 строки).
Найди bottleneck (наименьший балл) — это первый приоритет улучшения.

7-tuple assessment

| # | Подсистема | Что проверяет | |---|---|---| | 1 | **Instructions** | CLAUDE.md ≤200 строк, domain-rules.yaml заполнен, нет монолита | | 2 | **State** | feature_list.json валиден, SESSION.md свежий, нет дублирования | | 3 | **Verification** | 4-layer применяется, negative-gate работает, dual critique для L фичей | | 4 | **Scope** | WIP=1 не нарушено, affected_files указаны, no scope-leak | | 5 | **Lifecycle** | init.sh чист, 5-dim clean-exit при handoff, cold-start test проходит | | 6 | **Learning** | error-journal не дамп, lessons промотированы, recurrence_rate=0%, domain-rules не устарел | | 7 | **Cost & Safety** | tools-allowlist enforced, pre-launch-checklist используется, нет секретов в git |

Дополнительные метрики

Error Velocity

errors_per_session_avg_last_7_days = ?

Тренд — растёт ли скорость ошибок?

Recurrence Rate (CRITICAL)

# % ошибок которые уже были раньше
recurrence_rate = recurring_errors / total_errors * 100

**Цель: 0%.** Если >0% — Learning subsystem недостаточна, урок не дошёл до памяти или памяти не читают.

Top 3 Root-Cause Classes

Из error-journal — какие классы ошибок преобладают?

• `api_research` — закрыть через pre-launch-checklist
• `concurrent_write` — через tools-allowlist
• `domain_knowledge` — через update domain-rules.yaml
• `scope_leak` — через WIP=1 hook
• `state_drift` — через handoff discipline
• ...

Freshness checks

• domain-rules.yaml `last_reviewed` — старше N сессий?
• CLAUDE.md — обновлялся в этой фазе проекта?
• README.md — соответствует ли текущей реальности?

Cost snapshot

Cost this week: $X
Cost total in project: $X
Per-feature avg: $X
Trend: ↑ / ↓ / flat

Единая цифра готовности харнеса (v8 L5-F5, c11)

Сведи здоровье в ОДИН показатель — чтобы владелец видел готовность одним взглядом, а не читал 7 баллов.

1. Запусти объективные метрики (детерминированы из файлов, без LLM):

bash "${CLAUDE_PLUGIN_ROOT}/scripts/audit-health.sh"

Печатает `provenance_integrity` / `archive_evidence` / `budget_coverage` / `health_objective`.

2. **Единая цифра = МИНИМУМ** (узкое место, не среднее) двух осей:

• `bottleneck 7-tuple × 20` (субъективная — мин. балл подсистемы от evaluator);
• `health_objective` (объективная — провенанс/архив-целостность).

Провал provenance-integrity (дырявая история требований, c4) или отсутствие evidence у архивной фичи (c10) штрафует цифру напрямую. Экранные детекторы (clarity/secret-mask) — display-only, честно НЕ в enforcement-счёт и НЕ в эту цифру. **Диагностика, не гейт** — /audit не блокирует, а показывает.

Output

File: SESSION.md → секция "Last Audit"

## Last Audit

**Date**: YYYY-MM-DD (by external evaluator, fresh context)

**7-tuple scores**:
- Instructions: 4/5 — CLAUDE.md норма, нет topic-files в docs/
- State: 3/5 — feature_list.json валиден, SESSION.md устарел на 3 дня
- Verification: 2/5 — bottleneck! negative-gate не используется
- Scope: 5/5 — WIP=1 enforced корректно
- Lifecycle: 4/5 — init.sh работает, cold-start.yaml не обновлён
- Learning: 3/5 — error-journal есть, lessons промотированы 60%
- Cost & Safety: 5/5 — tools-allowlist enforced, секретов в git нет

**Bottleneck**: Verification (2/5)
**Recommendation**: добавить negative-verification на текущей фиче перед /verify

**Recurrence rate**: 0% (good)
**Error velocity**: 3 ошибки за неделю (low)
**Cost trend**: $5/week, flat

Bottleneck → действие

• Если Verification < 3: STOP, чинить тесты ДО любой новой фичи
• Если Learning > Recurrence Rate >0%: STOP, разбирать почему уроки не работают
• Если Cost & Safety < 4: STOP, security audit

Anti-patterns

• ❌ Запускать `/audit` тем же агентом который работал в сессии (self-bias)
• ❌ Игнорировать bottleneck «потом починим»
• ❌ Усреднять оценки — bottleneck это самая слабая, не average
• ❌ Хранить assessment.json внутри проекта (закрывает self-bias — оно в SESSION.md)