architect/standards/PROJECT_BOOTSTRAP.md

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

Версия: 1.2.0
Дата: 2026-03-07


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

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

Шаг 1 — Определить тип и место

1. Тип проекта  PROJECT_TYPOLOGY.md §3
2. Место в иерархии  где родитель?
3. Имя папки: @{тип}-{имя}/

Шаг 2 — Скопировать шаблон

# Шаблоны: architect/templates/@{тип}/
cp -r architect/templates/@biz/ projects/org/@biz-{имя}/

Доступные шаблоны: @org, @biz, @it, @ops, @hr, @fin, @mkt, @rd, @phys, @module

Полный список → architect/templates/INDEX.md

Шаг 3 — Структура (что получится)

@{тип}-{имя}/
├── INDEX.md        ← навигация: что где лежит
├── AI.md           ← контекст для любого AI
├── CLAUDE.md       ← инструкции для Claude
├── STATUS.md       ← стадия: IDEA, что делаем, следующий шаг
├── LOG.md          ← первая запись: инициализация
├── [файлы по типу] ← матрица в PROJECT_DOCUMENTS.md §4
└── arh/

Шаг 4 — Заполнить AI.md

type: biz          # тип из TYPOLOGY
name: ...
description: ...   # 1-2 абзаца: что это, зачем
status: IDEA
key_files:
  - INDEX.md
  - STATUS.md

Шаг 5 — Глоссарий ⭐

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

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

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

Шаг 6 — Обновить родителя

- Добавить ссылку в INDEX.md родительского проекта
- Добавить запись в LOG.md: "YYYY-MM-DD — Создан проект @{name}"

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

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

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


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

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

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

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

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

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

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

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

Обязательные (стандарт):
  INDEX.md, AI.md, CLAUDE.md, STATUS.md, LOG.md, arh/

Типовые (по типу проекта):
  [согласно матрице PROJECT_DOCUMENTS.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] добавить: секция "Совместимость платформ" (строки 4590)
  Из [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/
Глоссарий Изучаем тему, создаём GLOSSARY.md Собираем из всех доков + уточняем
Контент Пишем новый Берём лучшее из существующего
Участие оператора Шаг глоссария Каждый документ
Результат Чистый проект: INDEX, AI, STATUS, LOG Оздоровлённый проект с историей в arh/

Правила

Правило Описание
Глоссарий обязателен Каждый проект начинается с изучения темы и предложения терминов
Новый термин При появлении → предложить определение → добавить в GLOSSARY.md
Структура сначала INDEX, AI, STATUS, LOG → потом контент
Имя папки Всегда @{тип}-{имя}/, тип из PROJECT_TYPOLOGY.md

Связи


Обновлено: 2026-03-07