architect/standards/arh/PROJECT_BOOTSTRAP.md

Стандарт создания нового проекта (Bootstrap)

Версия: 1.1.0
Дата: 2026-03-04

Чеклист создания проекта

Выполнять строго по порядку.

Шаг 1 — Структура папок

projects/org/{name}/
├── CLAUDE.md
├── ../GLOSSARY_STANDARD.md        ← обязательно
├── PROJECT.md
├── README.md
├── CHANGELOG.md
├── management/
│   ├── STATUS.md
│   └── TODO.md
└── [направления]/
    ├── biz/           ← бизнес-документы
    └── it/            ← IT-реализация

Шаг 2 — CLAUDE.md

Создать с разделами:
- Что это (1-2 строки)
- Структура папок
- Текущий фокус
- Глоссарий: ../GLOSSARY_STANDARD.md
- Ключевые файлы
- Серверы/окружения (если есть)

Шаг 3 — ../GLOSSARY_STANDARD.md ⭐

Обязательный шаг. Алгоритм:

1. Изучить тему проекта (бизнес, предметная область, технологии)
2. Предложить пользователю список основных терминов с определениями:
   "Для проекта [название] предлагаю следующие термины в глоссарий:
    [термин 1] — [определение]
    [термин 2] — [определение]
    ...
    Добавить/уточнить?"
3. Обсудить, скорректировать
4. Записать подтверждённые термины в ../GLOSSARY_STANDARD.md
5. При появлении новых терминов в процессе работы — предлагать добавить

Формат: см. GLOSSARY_STANDARD.md

Шаг 4 — PROJECT.md

Содержит:
- Описание проекта (что, зачем, для кого)
- Стек технологий
- Статус

Шаг 5 — management/

Санация существующего проекта

Санация — применение чеклиста bootstrap к существующему проекту.
Цель: определить нужный список документов, собрать в них всё ценное, лишнее — в arh/.

Принцип: Каждый шаг утверждает оператор. Ничего не удаляется без подтверждения.

Шаг 1 — Разведка (авто, L0)

Читаем все .md файлы проекта. Строим карту:

ВЫПОЛНЕНО (разведка):
Файлов найдено: N
Папок: ...

КАРТА ДОКУМЕНТОВ:
├── Обязательные (по стандарту):
│   ✅ PROJECT.md — есть
│   ❌ ../GLOSSARY_STANDARD.md — нет
│   ✅ CLAUDE.md — есть, устаревший
│   ...
│
├── Дополнительные (специфика проекта):
│   FILE_A.md, FILE_B.md, FILE_C.md
│   ...
│
└── Кандидаты в arh/:
    OLD_X.md, TEMP_Y.md, DRAFT_Z.md
    ...

Битых ссылок: N
Дублей: N (перечень)

Шаг 2 — Список документов (утверждение оператором)

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

ПРЕДЛАГАЕМЫЙ СПИСОК ДОКУМЕНТОВ:

Обязательные (стандарт):
  CLAUDE.md, PROJECT.md, ../GLOSSARY_STANDARD.md, README.md,
  CHANGELOG.md, management/STATUS.md, management/TODO.md

Дополнительные (специфика проекта):
  [FILE_A.md] — описание: ...
  [FILE_B.md] — описание: ...

→ Утверждаешь список? Что добавить/убрать?

Оператор подтверждает. Только утверждённые файлы остаются, всё остальное — в arh/.

Шаг 3 — По каждому документу из списка

Для каждого файла из утверждённого списка — по очереди:

ШАГ [N/TOTAL]: FILE.md

Текущее состояние:
  [A] FILE.md — основной (300 строк, дата: ...)
  [B] OLD_FILE.md — похожий (150 строк, дата: ...)
  [C] DRAFT_FILE.md — черновик (80 строк)

Прочитал все три. Предлагаю:
  Основа: [A]
  Из [B] добавить: секция "Совместимость платформ" (строки 45–90)
  Из [C] добавить: таблица рисков

Вот как будет выглядеть объединённый файл:
  [показываем структуру / ключевые секции]

→ Утверждаешь? (да / уточни / пропусти)

После подтверждения — записываем файл. Переходим к следующему.

Шаг 4 — Всё остальное в arh/

После обхода всего списка — всё что НЕ вошло в список:

КАНДИДАТЫ В ARH/:
  OLD_ARCH.md, TEMP_NOTES.md, DRAFT_V2.md, ...
  (N файлов)

Переместить все в arh/? (да / посмотреть каждый)

Оператор может:
- да → всё в arh/ одним действием
- посмотреть каждый → обходим и спрашиваем по одному

Шаг 5 — Битые ссылки (авто)

Скан. Чиним очевидное (ссылка переехала → новый путь).
Если цель непонятна — спрашиваем оператора.

Шаг 6 — Коммит

git commit -m "chore({project}): sanation — docs list, merge, arh/ (vX.Y)"

Схема санации

Разведка (L0)
    ↓
Карта документов → показываем оператору
    ↓
Утверждение списка ← ОПЕРАТОР
    ↓
По каждому документу:
  Читаем существующие → предлагаем объединение → ОПЕРАТОР ✓ → записываем
    ↓
Всё остальное → arh/ ← ОПЕРАТОР ✓
    ↓
Битые ссылки → fix
    ↓
Commit

Отличие от bootstrap

Bootstrap Санация
Откуда С нуля Существующий проект
Что делаем Создаём по чеклисту Определяем список → собираем → arh/
Глоссарий Изучаем тему, создаём Собираем из всех доков + уточняем
Контент Пишем новый Берём лучшее из существующего
Участие оператора Шаг глоссария Каждый документ
Результат Чистый новый проект Оздоровлённый проект с историей в arh/

Правила

Правило Описание
Глоссарий обязателен Каждый проект начинается с изучения темы и создания глоссария
Глоссарий в CLAUDE.md Всегда ссылка на ../GLOSSARY_STANDARD.md в контексте
Новый термин При появлении → предложить определение → добавить в глоссарий
Структура сначала Папки и базовые файлы → потом контент

Связанные стандарты

Версия: 1.1.0