architect/standards/9-guidance/tools/documentation-tomography.md

type: standard
aspect: guidance
title: "Томография документации проекта"
version: 1.0.0
date: 2026-02-19
status: active

Томография документации проекта

Назначение: Инструмент для комплексного анализа документации проекта
Тип: Аналитический инструмент
Применение: Проверка полноты, согласованности и последовательности документации

ЧТО ТАКОЕ ТОМОГРАФИЯ ДОКУМЕНТАЦИИ

Томография — глубокий послойный анализ всей документации проекта с целью:
- Проверки полноты каждого документа
- Выявления противоречий и расхождений между документами
- Оценки последовательности изложения (от абстрактного к конкретному)
- Определения готовности проекта к следующему этапу

Когда применять:
- После завершения фазы design (перед началом реализации)
- При передаче проекта новой команде
- Перед презентацией инвесторам/партнёрам
- При подозрении на расхождения в документах
- Периодически (раз в квартал) для крупных проектов

МЕТОДОЛОГИЯ ТОМОГРАФИИ

Шаг 1: Инвентаризация документов

Составить список всех основных документов проекта:

✅ README.md           — Введение, elevator pitch
✅ CONCEPT.md          — Концепция, проблема, видение
✅ ECOSYSTEM.md        — Архитектура продуктов (если есть)
✅ ANALYSIS.md         — Анализ рынка, конкуренты
✅ BUSINESS_MODEL.md   — Бизнес-модель, финансы
✅ IMPLEMENTATION.md   — План реализации
✅ INDEX.md            — Навигация

Шаг 2: Анализ каждого документа

Для каждого документа проверить:

  1. Объём — количество строк
  2. Полнота — покрывает ли документ свою область на 100%?
  3. Статус — готов ли к использованию?
  4. Проблемы — что не хватает, что избыточно?
  5. Рекомендации — что нужно исправить?

Оценка полноты:
- 100% — документ полностью готов, ничего не нужно
- 90-99% — готов, нужны мелкие правки
- 70-89% — работает, но нужны доработки
- 50-69% — неполный, требует доработки
- <50% — набросок, не готов к использованию

Шаг 3: Проверка согласованности

Сравнить ключевые метрики между документами:

Метрика ECOSYSTEM BUSINESS IMPLEMENTATION Статус
Год 1 выручка 25M₽ 26.4M₽ 13.2M₽ ⚠️ Расхождение
Инвестиции 2M₽ 3M₽ 3.59M₽ ⚠️ Расхождение
Break-even Месяц 9 Месяц 9 Месяц 5-6 ⚠️ Расхождение
ROI 12-18 мес Не указан 16-17 мес ⚠️ Неполнота

Типичные расхождения:
- Финансовые прогнозы (оптимистичные vs консервативные)
- Даты в roadmap (устаревшие)
- Описание продуктов (разные формулировки)
- Целевая аудитория (разный focus)

Шаг 4: Проверка последовательности

Убедиться, что документы выстроены от абстрактного к конкретному:

🌟 Уровень 1 — ЗАЧЕМ (философия)
   README, CONCEPT → Зачем? Какую проблему решаем?

🏗️ Уровень 2 — ЧТО (концепция)
   ECOSYSTEM → Что предлагаем? Архитектура.

🌍 Уровень 3 — ДЛЯ КОГО/ГДЕ (контекст)
   ANALYSIS → Где рынок? Кто клиенты?

💰 Уровень 4 — КАК ЗАРАБОТАТЬ (бизнес)
   BUSINESS_MODEL → Монетизация, экономика.

⚙️ Уровень 5 — КАК СДЕЛАТЬ (реализация)
   IMPLEMENTATION → Технологии, команда, сроки.

Критерии правильной последовательности:
- От общего к частному ✅
- От идеи к реализации ✅
- От философии к технике ✅
- От "почему" к "как именно" ✅

Шаг 5: Рекомендуемые треки чтения

Проверить, можно ли составить логичные треки чтения для разных ролей:

Для инвестора (30 мин):

CONCEPT → ANALYSIS → BUSINESS_MODEL → IMPLEMENTATION

Для сотрудника (45 мин):

README → CONCEPT → ECOSYSTEM → IMPLEMENTATION → Специализация

Для клиента (10 мин):

README → Продукт (contentpro/INDEX.md или creatorhub/INDEX.md)

Если треки не составляются — проблема в структуре документации.

ФОРМАТ ОТЧЁТА ТОМОГРАФИИ

Создать файл TOMOGRAPHY.md в корне проекта со следующей структурой:

# [Название проекта] — Томография проекта

**Дата:** YYYY-MM-DD
**Выполнено:** Claude Code / [Имя]

---

## СВОДКА

| Показатель | Значение |
|------------|----------|
| **Общая готовность** | XX% |
| **Документов проверено** | N |
| **Проблем выявлено** | N критических, N важных |
| **Статус** | design → implementation / готов к старту |

---

## АНАЛИЗ ДОКУМЕНТОВ

### README.md

**Объём:** NNN строк
**Полнота:** XX%
**Статус:** ✅ Готов / ⚠️ Требует доработки / 🔴 Критичные проблемы

**Проблемы:**
1. [Описание проблемы]
2. [Описание проблемы]

**Рекомендации:**
[Что нужно исправить]

---

[Повторить для каждого документа]

---

## СРАВНЕНИЕ КЛЮЧЕВЫХ МЕТРИК

| Метрика | Doc 1 | Doc 2 | Doc 3 | Статус |
|---------|-------|-------|-------|--------|
| Выручка год 1 | 25M | 26M | 13M | ⚠️ Расхождение |
| ... | ... | ... | ... | ... |

**Анализ:**
[Объяснение расхождений, какие цифры верные]

---

## ПОСЛЕДОВАТЕЛЬНОСТЬ ЧТЕНИЯ

[Проверка уровней абстракции]

**Вердикт:** ✅ Последовательность правильная / ⚠️ Нужна переработка

---

## ОПТИМАЛЬНЫЕ ТРЕКИ ЧТЕНИЯ

### Для инвестора (30 мин)
...

### Для сотрудника (45 мин)
...

---

## КРИТИЧЕСКИЕ ПРОБЛЕМЫ

### 1. [Название проблемы]

**Статус:** 🔴 Критично / 🟠 Важно / 🟡 Мелочь

**Проблема:**
[Описание]

**Решение:**
[Что делать]

---

[Повторить для каждой проблемы]

---

## РЕКОМЕНДАЦИИ

### Срочные (до старта проекта)

1. ✅ **[Действие]**
   - Срок: N часов
   - Критичность: Высокая/Средняя/Низкая
   - [Описание]

### Желательные (первый месяц)

4. [Действие]
5. [Действие]

---

## ОБЩИЙ ВЕРДИКТ

**Готовность к реализации:** XX%

**Что сделано хорошо:**
- ✅ [Пункт]
- ✅ [Пункт]

**Что нужно исправить:**
- ⚠️ [Пункт]
- ⚠️ [Пункт]

**Время на правки:** N часов

**После правок:** [Статус проекта после исправлений]

---

**Создано:** YYYY-MM-DD
**Автор:** Claude Code / [Имя]

КРИТЕРИИ ОЦЕНКИ ГОТОВНОСТИ

Уровни готовности документации

Готовность Описание Действие
90-100% Документация готова к использованию Можно начинать реализацию
70-89% Есть мелкие проблемы Исправить за 1-2 дня, потом старт
50-69% Значительные пробелы Доработать 1-2 недели
<50% Документация не готова Вернуться в фазу design

Типы проблем

🔴 Критичные — блокируют старт проекта:
- README описывает другой проект
- Финансы расходятся в 2+ раза
- Отсутствует ключевой документ (CONCEPT, BUSINESS_MODEL)
- Нет описания продукта

🟠 Важные — нужно исправить до старта:
- Даты устарели
- Финансы расходятся на 10-30%
- Неполный анализ рынка
- Отсутствует SWOT или конкуренты

🟡 Мелочи — можно исправить по ходу:
- Опечатки
- Устаревшие цены API
- Мелкие расхождения в формулировках

АВТОМАТИЗАЦИЯ ТОМОГРАФИИ

Чек-лист для Claude Code

При выполнении томографии проверить:

☐ Прочитать все основные документы (README, CONCEPT, ANALYSIS, BUSINESS, IMPLEMENTATION)
☐ Оценить полноту каждого документа (в %)
☐ Найти все упоминания финансовых метрик (выручка, инвестиции, ROI, break-even)
☐ Сравнить финансы между документами (таблица)
☐ Проверить описание продуктов на согласованность
☐ Проверить целевую аудиторию (одинакова ли в разных документах?)
☐ Проверить даты в roadmap (не устарели ли?)
☐ Выстроить последовательность документов по уровням абстракции
☐ Составить треки чтения для 3-4 ролей (инвестор, сотрудник, клиент)
☐ Выявить 3-5 главных проблем (критичные / важные / мелочи)
☐ Дать рекомендации по исправлению с оценкой времени
☐ Оценить общую готовность проекта (в %)
☐ Создать файл TOMOGRAPHY.md с отчётом

Пример команды для Claude

Проверь, что сделано. Сделай томографию проекта и выстрой
последовательность документов в INDEX от идеи до конкретики.

Claude автоматически:
1. Прочитает все документы
2. Проанализирует полноту и согласованность
3. Найдёт расхождения
4. Создаст TOMOGRAPHY.md
5. Обновит INDEX.md (если нужно)

ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ

Пример 1: Content Factory

Результаты томографии:
- Общая готовность: 90%
- Документов проверено: 6
- Проблем: 3 критических (README несоответствие, финансы расходятся, даты устарели)

Действия:
1. Переписать README.md (2 часа)
2. Синхронизировать финансы (3 часа)
3. Обновить даты (30 минут)

Результат: После 5-6 часов правок проект готов к реализации

Пример 2: Стартап перед питчем инвесторам

Ситуация: Нужно убедиться, что вся документация согласована

Действия:
1. Запустить томографию
2. Обнаружить расхождения в unit-экономике между BUSINESS_MODEL и презентацией
3. Исправить за 1 день
4. Провести питч с уверенностью

ИНТЕГРАЦИЯ С ДРУГИМИ ИНСТРУМЕНТАМИ

Связь с PROJECT_DOCUMENTATION.md

Томография проверяет соответствие стандарту:
- Есть ли все обязательные документы из стандарта?
- Соблюдена ли структура INDEX.md?
- Работает ли навигация?

Связь с BUSINESS_PROJECT_DOCS.md

Для бизнес-проектов томография дополнительно проверяет:
- Unit-экономику
- Финансовую модель
- Прогнозы по месяцам
- ROI и break-even

Использование в процессе

design (фаза проектирования)
    ↓
[ТОМОГРАФИЯ] ← Проверка готовности
    ↓
Исправление проблем
    ↓
[ТОМОГРАФИЯ] ← Повторная проверка
    ↓
implementation (фаза реализации)

FAQ

Q: Как часто делать томографию?
A:
- Обязательно: перед переходом из design → implementation
- Желательно: раз в квартал для живых проектов
- По требованию: перед питчами, аудитом, передачей проекта

Q: Сколько времени занимает томография?
A:
- Маленький проект (3-5 документов): 30-60 минут
- Средний проект (6-10 документов): 1-2 часа
- Крупный проект (>10 документов): 2-4 часа

Q: Что делать, если готовность <50%?
A: Вернуться в фазу design, доработать документацию до 70-80%, потом повторить томографию.

Q: Можно ли автоматизировать томографию полностью?
A: Частично да (проверка наличия файлов, подсчёт строк). Но качественный анализ требует понимания контекста — это делает Claude или человек.

Q: INDEX.md — это оглавление или навигация?
A: Навигация. Оглавление содержит контент, навигация — только ссылки и описания. INDEX.md должен помогать найти нужный документ, а не дублировать его содержимое.

ВЕРСИОНИРОВАНИЕ

Версия: 1.0.0
Создано: 2025-12-21
Автор: Claude Code (на основе томографии проекта Content Factory)

История изменений:
- 1.0.0 (2025-12-21) — Первая версия инструмента