architect/standards/GLOSSARY_STANDARD.md

Стандарт глоссария проекта

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


Назначение

Каждый проект имеет ../GLOSSARY_STANDARD.md в корне — единый справочник всех терминов, кодов и синонимов.
Глоссарий всегда в контексте Claude через ссылку в CLAUDE.md проекта.


Правила

Когда добавлять термин

Ситуация Действие
Создание проекта (bootstrap) Изучить тему → предложить основные термины → подтвердить → записать
Новый термин появился в диалоге Предложить определение → после "ок" → добавить в ../GLOSSARY_STANDARD.md
Уточнение существующего термина Обновить запись
Термин уровня платформы Также добавить сюда в раздел ниже

Протокол "новый термин"

1. Предложить: "Предлагаю добавить в глоссарий: [термин] — [определение]. Ок?"
2. После подтверждения  добавить в ../GLOSSARY_STANDARD.md проекта
3. Если платформенный термин  также обновить этот файл

Обязательная ссылка в CLAUDE.md проекта

**Глоссарий:** [../GLOSSARY_STANDARD.md](GLOSSARY_STANDARD.md) — все термины, коды, синонимы

Формат записи

### [Термин]
**Canonical:** единственное эталонное название (одно)
**Code:** машинный код в файлах/системах (если есть)
**Synonyms:** варианты, SEO-формы, разговорные названия, клоны написания
**Docs:** ссылки на документы/таблицы с подробностями
**Note:** уточнение, контекст, примеры

Шаблон ../GLOSSARY_STANDARD.md для нового проекта

# GLOSSARY — [Название проекта]

**Проект:** [путь]
**Обновлено:** YYYY-MM-DD

---

## [Раздел 1]

### [Термин]
**Canonical:** ...
**Code:** ...
**Synonyms:** ...
**Docs:** ...
**Note:** ...

---

## Связи

**Стандарт:** [architect/standards/GLOSSARY_STANDARD.md](../../architect/standards/GLOSSARY_STANDARD.md)

Платформенные термины (общие для всех проектов)

Bootstrap

Canonical: bootstrap
Synonyms: инициализация проекта, создание проекта
Docs: processes/PROJECT_BOOTSTRAP.md
Note: Процедура создания нового проекта с нуля по чеклисту: структура → CLAUDE.md → ../GLOSSARY_STANDARD.md → PROJECT.md → management/

Санация

Canonical: санация
Synonyms: rebootstrap, ревизия, реструктуризация, project sanation
Docs: processes/PROJECT_BOOTSTRAP.md
Note: Процедура оздоровления существующего проекта. Проходим по тому же чеклисту что и bootstrap, но применительно к уже созданному проекту: читаем все документы → объединяем дубли → пересоздаём структуру по чеклисту → исправляем ошибки → убираем мусор. Отличие от bootstrap: не создаём с нуля, а реорганизуем существующее.

Проект

Canonical: проект
Synonyms: solution, решение, сайт, бизнес (зависит от контекста)
Note: омоним — уточнять контекст: бизнес / папка с кодом / задача

Модуль

Canonical: модуль
Synonyms: plugin, extension, компонент
Note: омоним — уточнять: Drupal-модуль / Python-модуль / аппаратный

Канонический

Canonical: canonical
Note: эталонный, основной вариант из множества синонимов/вариантов


Версия: 1.0.0