Версия: 1.2.0
Дата: 2026-03-07
Выполнять строго по порядку.
1. Тип проекта → PROJECT_TYPOLOGY.md §3
2. Место в иерархии → где родитель?
3. Имя папки: @{тип}-{имя}/
# Шаблоны: architect/templates/@{тип}/
cp -r architect/templates/@biz/ projects/org/@biz-{имя}/
Доступные шаблоны: @org, @biz, @it, @ops, @hr, @fin, @mkt, @rd, @phys, @module
Полный список → architect/templates/INDEX.md
@{тип}-{имя}/
├── INDEX.md ← навигация: что где лежит
├── AI.md ← контекст для любого AI
├── CLAUDE.md ← инструкции для Claude
├── STATUS.md ← стадия: IDEA, что делаем, следующий шаг
├── LOG.md ← первая запись: инициализация
├── [файлы по типу] ← матрица в PROJECT_DOCUMENTS.md §4
└── arh/
type: biz # тип из TYPOLOGY
name: ...
description: ... # 1-2 абзаца: что это, зачем
status: IDEA
key_files:
- INDEX.md
- STATUS.md
Обязательный шаг. Алгоритм:
1. Изучить тему проекта (бизнес, предметная область, технологии)
2. Предложить пользователю список основных терминов с определениями:
"Для проекта [название] предлагаю следующие термины в глоссарий:
[термин 1] — [определение]
[термин 2] — [определение]
...
Добавить/уточнить?"
3. Обсудить, скорректировать
4. Если терминов >3 → записать в GLOSSARY.md
5. При появлении новых терминов в процессе работы — предлагать добавить
Формат: см. GLOSSARY_STANDARD.md
- Добавить ссылку в INDEX.md родительского проекта
- Добавить запись в LOG.md: "YYYY-MM-DD — Создан проект @{name}"
Санация — применение чеклиста bootstrap к существующему проекту.
Цель: определить нужный список документов, собрать в них всё ценное, лишнее — в arh/.
Принцип: Каждый шаг утверждает оператор. Ничего не удаляется без подтверждения.
Читаем все .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 (перечень)
Предлагаем итоговый список — что должно остаться в проекте:
ПРЕДЛАГАЕМЫЙ СПИСОК ДОКУМЕНТОВ:
Обязательные (стандарт):
INDEX.md, AI.md, CLAUDE.md, STATUS.md, LOG.md, arh/
Типовые (по типу проекта):
[согласно матрице PROJECT_DOCUMENTS.md для данного типа]
Дополнительные (специфика проекта):
[FILE_A.md] — описание: ...
[FILE_B.md] — описание: ...
→ Утверждаешь список? Что добавить/убрать?
Оператор подтверждает. Только утверждённые файлы остаются, всё остальное — в arh/.
Для каждого файла из утверждённого списка — по очереди:
ШАГ [N/TOTAL]: FILE.md
Текущее состояние:
[A] FILE.md — основной (300 строк, дата: ...)
[B] OLD_FILE.md — похожий (150 строк, дата: ...)
[C] DRAFT_FILE.md — черновик (80 строк)
Прочитал все три. Предлагаю:
Основа: [A]
Из [B] добавить: секция "Совместимость платформ" (строки 45–90)
Из [C] добавить: таблица рисков
Вот как будет выглядеть объединённый файл:
[показываем структуру / ключевые секции]
→ Утверждаешь? (да / уточни / пропусти)
После подтверждения — записываем файл. Переходим к следующему.
После обхода всего списка — всё что НЕ вошло в список:
КАНДИДАТЫ В ARH/:
OLD_ARCH.md, TEMP_NOTES.md, DRAFT_V2.md, ...
(N файлов)
Переместить все в arh/? (да / посмотреть каждый)
Оператор может:
- да → всё в arh/ одним действием
- посмотреть каждый → обходим и спрашиваем по одному
Скан. Чиним очевидное (ссылка переехала → новый путь).
Если цель непонятна — спрашиваем оператора.
git commit -m "chore({project}): sanation — docs list, merge, arh/ (vX.Y)"
Разведка (L0)
↓
Карта документов → показываем оператору
↓
Утверждение списка ← ОПЕРАТОР
↓
По каждому документу:
Читаем существующие → предлагаем объединение → ОПЕРАТОР ✓ → записываем
↓
Всё остальное → arh/ ← ОПЕРАТОР ✓
↓
Битые ссылки → fix
↓
Commit
| Bootstrap | Санация | |
|---|---|---|
| Откуда | С нуля | Существующий проект |
| Что делаем | Создаём по чеклисту | Определяем список → собираем → arh/ |
| Глоссарий | Изучаем тему, создаём GLOSSARY.md | Собираем из всех доков + уточняем |
| Контент | Пишем новый | Берём лучшее из существующего |
| Участие оператора | Шаг глоссария | Каждый документ |
| Результат | Чистый проект: INDEX, AI, STATUS, LOG | Оздоровлённый проект с историей в arh/ |
| Правило | Описание |
|---|---|
| Глоссарий обязателен | Каждый проект начинается с изучения темы и предложения терминов |
| Новый термин | При появлении → предложить определение → добавить в GLOSSARY.md |
| Структура сначала | INDEX, AI, STATUS, LOG → потом контент |
| Имя папки | Всегда @{тип}-{имя}/, тип из PROJECT_TYPOLOGY.md |
Обновлено: 2026-03-07