<img src="../banner.png" width="100%" alt="docs-analysis banner">

Русский — Официальная русская версия docs-analysis.

Анализ требований к документации (Русский)

Анализирует все документы концепций и требований, проверяет их требования на соответствие текущему коду и создает консолидированный отчет об отклонениях.

---

Обзор и назначение

Анализирует все документы концепций и требований в папке ../docs/, проверяет их требования на соответствие текущему коду и создает консолидированный отчет об отклонениях.

---

Соглашение об именовании

Префикс и суффикс

Все проанализированные документы получают:

• Префикс: conN_, где N = версия анализа (1, 2, 3, ...)
• Суффикс: _XX, где XX = процент выполнения (округленный до ближайших 10)

Порог архивации

• >= 75% выполнено: Документ перемещается в ../docs/_archive/
• < 75% выполнено: Документ остается в ../docs/ с префиксом/суффиксом
• Порог настраивается (по умолчанию: 75)

---

Процесс

Фаза 1: Сбор документов

• Получить список всех файлов *.md и *.txt в ../docs/ (корень)
• Исключить README.txt

Фаза 2: Извлечение требований

Для каждого документа:

• Прочитать содержимое
• Определить требования (контрольные списки, таблицы, маркеры MISSING/TODO)
• Категоризировать: Structure, Code, API, DB Schema, CLI, Feature

Фаза 3: Проверка кода

Для каждого требования:

• Определить метод проверки (Glob, Grep, Read)
• Выполнить проверку
• Отметить как: FULFILLED, PARTIAL, MISSING

Фаза 4: Оценка

• Подсчитать количество выполненных и открытых требований
• Рассчитать процент выполнения (%)
• Принять решение: архивировать (>= 75%) или оставить (< 75%)

Фаза 5: Генерация результатов

• Создать REQUIREMENTS_ANALYSIS.md (сводка)
• Создать consense_diff.md (только открытые требования, по приоритету)

Фаза 6: Версионирование

• Поиск наибольшего префикса conN_
• Новая версия = наибольшая + 1

Фаза 7: Переименование и перемещение

• Применить новый префикс/суффикс к документам
• Архивировать или оставить

---

Результаты

Файл	Описание
conN_REQUIREMENTS_ANALYSIS.md	Полный анализ (версия N)
consense_diff_N.md	Консолидированные открытые требования
_archive/conN_*_XX.*	Архивированные (>=75%) документы

---

Классификация приоритетов

Приоритет	Критерии
P1	Отсутствует основная функциональность, система непригодна к использованию
P2	Отсутствует важная функция, возможен обходной путь
P3	Желательно, улучшает UX
P4	Косметические изменения, документация, качество кода

---

История изменений

1.0.0 (2026-03-15)

• Перенесено из BACH v3.8.0

---

Перенесено из BACH v3.8.0 | Автономная версия