architect/research/pm-design/05-TEMPLATE-INHERITANCE.md

type: research
title: "Иерархия наследования шаблонов / Template Inheritance Hierarchy"
status: draft
version: 0.1.0
date: 2026-02-17
owner: architect


Иерархия наследования шаблонов / Template Inheritance Hierarchy

Принцип наследования

UNIVERSAL (Level 0)
    ↓ +Domain-specific
DOMAIN (Level 1) — IT / Business / Marketing / ...
    ↓ +Management-class-specific
CLASS (Level 2) — A (Delivery) / B (Change) / C (Discovery)
    ↓ +Solution-specific
SOLUTION (Level 3) — CS-Cart / Drupal / React App / ...

Правило: Каждый уровень наследует ВСЁ из родителя + добавляет своё.


Level 0: UNIVERSAL (PROJECT_BASE)

Источник: architect/templates/PROJECT_BASE.md

Структура папок

{project}/
├── CLAUDE.md
├── index.yaml
├── design/
│   ├── BRIEF.md
│   ├── REQUIREMENTS.md
│   └── DESIGN.md
├── management/
│   ├── STATUS.md
│   ├── TODO.md
│   ├── DECISIONS.md
│   └── CHANGELOG.md
├── solution/
└── _shared/

Документы

Документ Фаза создания Назначение
CLAUDE.md 0-Trigger AI-контекст
index.yaml 0-Trigger Метаданные
management/STATUS.md 1-Understanding Текущее состояние
management/TODO.md 1-Understanding Задачи
design/BRIEF.md 1-Understanding Понимание задачи
design/REQUIREMENTS.md 4-Requirements Требования
design/DESIGN.md 5-Design Решение
management/DECISIONS.md 5-Design Принятые решения
management/CHANGELOG.md 9-Implementation История изменений

Секции CLAUDE.md

# {Название}
**Тип:** {type}
**Статус:** {status}
**Обновлено:** {date}

## Что это
## Структура
## Текущий фокус
## Ссылки

Секции STATUS.md

# STATUS
**Обновлено:** {datetime}

## Текущее состояние
| Параметр | Значение |
| Фаза | {0-14} |
| Статус | {status} |
| Прогресс | {%} |

## Что готово
## Что в работе
## Блокеры
## Следующий шаг

Level 1: DOMAIN — IT (PROJECT_IT)

Источник: architect/templates/PROJECT_IT.md
Наследует: PROJECT_BASE

Добавленные папки

+ design/
    + DATA_MODEL.md
    + API.md
+ solution/
    + src/
    + tests/
    + migrations/
+ testing/
    + TEST_PLAN.md
    + DEFECTS.md
+ operations/
    + DEPLOY.md
    + ROLLBACK.md
    + MONITORING.md
    + RUNBOOK.md
+ @modules/         (опционально)

Добавленные документы

Документ Фаза создания Назначение
design/DATA_MODEL.md 5-Design Модель данных
design/API.md 5-Design API спецификация
management/RELEASES.md 9-Implementation История релизов
testing/TEST_PLAN.md 7-Planning План тестирования
testing/DEFECTS.md 10-Testing Баг-трекинг
operations/DEPLOY.md 7-Planning Инструкция деплоя
operations/ROLLBACK.md 7-Planning План отката
operations/MONITORING.md 11-Deployment Мониторинг
operations/RUNBOOK.md 13-Operations Операционное руководство

Дополненные секции CLAUDE.md

+ ## Технологии
  | Компонент | Технология |
  | Backend | {tech} |
  | Frontend | {tech} |
  | База данных | {tech} |
  | Деплой | {tech} |

+ ## Модули
  | Модуль | Тип | Описание |

+ ## Запуск
  ```bash
  # Development
  # Production
  ```

+ ## Серверы
  | Среда | Сервер | URL |

Дополненные секции STATUS.md

# Без изменений — используется базовая структура

Level 2: CLASS — A (Delivery)

Наследует: PROJECT_IT (или другой Domain)
Специфика: Чёткие артефакты, Definition of Done

Добавленные папки

+ design/
    + ACCEPTANCE_CRITERIA.md
+ testing/
    + UAT_PLAN.md
    + UAT_RESULTS.md
+ operations/
    + HANDOVER.md

Добавленные документы

Документ Фаза создания Назначение
design/ACCEPTANCE_CRITERIA.md 4-Requirements Критерии приёмки
testing/UAT_PLAN.md 7-Planning План UAT
testing/UAT_RESULTS.md 12-Acceptance Результаты UAT
operations/HANDOVER.md 12-Acceptance Передача в эксплуатацию

Дополненные секции REQUIREMENTS.md

+ ## Definition of Done
  ### Функциональность
  - [ ] {критерий}

  ### Качество
  - [ ] Покрытие тестами ≥80%
  - [ ] Все критичные баги закрыты

  ### Документация
  - [ ] API документация актуальна
  - [ ] Runbook создан

  ### Деплой
  - [ ] Инструкция деплоя проверена
  - [ ] Rollback план готов

Дополненные секции STATUS.md

+ ## Definition of Done
  Выполнено: {N}/{M} критериев

  - [x] {критерий выполнен}
  - [ ] {критерий в работе}

Level 2: CLASS — B (Change Management)

Наследует: PROJECT_BUSINESS (Domain)
Специфика: Коммуникация, OKR, поведенческие изменения

Добавленные папки

+ communication/
    + STAKEHOLDER_MAP.md
    + COMMUNICATION_PLAN.md
    + RESISTANCE_MANAGEMENT.md
+ measurement/
    + OKR.md
    + METRICS.md

Добавленные документы

Документ Фаза создания Назначение
communication/STAKEHOLDER_MAP.md 1-Understanding Карта стейкхолдеров
communication/COMMUNICATION_PLAN.md 7-Planning План коммуникаций
communication/RESISTANCE_MANAGEMENT.md 9-Implementation Управление сопротивлением
measurement/OKR.md 4-Requirements OKR проекта
measurement/METRICS.md 13-Operations Метрики успеха

Дополненные секции REQUIREMENTS.md

+ ## OKR
  ### Objective
  {Цель изменения}

  ### Key Results
  - KR1: {измеримый результат}
  - KR2: {измеримый результат}

  ### Success Metrics
  - {метрика} from {текущее} to {целевое}

Level 2: CLASS — C (Discovery / R&D)

Наследует: PROJECT_IT или PROJECT_BUSINESS
Специфика: Гипотезы, итерации, pivot-точки

Добавленные папки

+ research/
    + HYPOTHESIS.md
    + EXPERIMENTS.md
    + FINDINGS.md
+ iterations/
    + ITERATION_1.md
    + ITERATION_2.md

Добавленные документы

Документ Фаза создания Назначение
research/HYPOTHESIS.md 2-Research Гипотезы
research/EXPERIMENTS.md 3-Analysis План экспериментов
research/FINDINGS.md 10-Testing Выводы
iterations/ITERATION_N.md 9-Implementation Отчёт итерации

Дополненные секции REQUIREMENTS.md

+ ## Research Questions
  1. {вопрос}
  2. {вопрос}

+ ## Hypotheses
  - H1: {гипотеза} → тест: {как проверим}
  - H2: {гипотеза} → тест: {как проверим}

+ ## Pivot Criteria
  Продолжаем если:
  - {критерий}

  Меняем подход если:
  - {критерий}

Level 3: SOLUTION — CS-Cart

Наследует: IT (Domain) → CLASS A (Delivery)
Специфика: CS-Cart платформа

Добавленные папки

+ design/
    + MODULES.md
    + THEME.md
    + CATALOG_STRUCTURE.md
+ solution/
    + modules/
        + {module_name}/
            + CODE-PROMPT.md
            + src/
            + tests/
    + themes/
        + {theme_name}/
    + migrations/
+ operations/
    + CSCART_UPGRADE.md

Добавленные документы

Документ Фаза создания Назначение
design/MODULES.md 5-Design Список модулей CS-Cart
design/THEME.md 5-Design Тема оформления
design/CATALOG_STRUCTURE.md 5-Design Структура каталога
solution/modules/{name}/CODE-PROMPT.md 8-Preparation Промпт для Кодера
operations/CSCART_UPGRADE.md 13-Operations План обновления CS-Cart

Дополненные секции CLAUDE.md

+ ## Платформа
  - CS-Cart версия: {version}
  - PHP версия: {version}
  - БД: MySQL {version}

+ ## Модули CS-Cart
  | Модуль | Статус | Версия |
  | {name} | {status} | {version} |

+ ## Темы
  | Тема | Базовая | Статус |
  | {name} | {parent} | {status} |

+ ## Установки
  | Среда | URL | Версия |
  | Dev | {url} | {version} |
  | Prod | {url} | {version} |

Дополненные секции DATA_MODEL.md

+ ## CS-Cart таблицы
  ### Стандартные (используемые)
  - cscart_products
  - cscart_categories
  - cscart_orders

  ### Кастомные (добавленные)
  | Таблица | Назначение |
  | cscart_custom_{name} | {описание} |

Дополненные секции DESIGN.md

+ ## Архитектура CS-Cart решения

  ### Модули
  1. {module_name} — {назначение}
     - Хуки: {hooks}
     - Схемы: {schemas}
     - Контроллеры: {controllers}

  ### Темы
  - Базовая: {parent_theme}
  - Кастомная: {custom_theme}
  - Переопределённые шаблоны: {count}

  ### Интеграции
  - {система} → {модуль} → {назначение}

Level 3: SOLUTION — Drupal

Наследует: IT (Domain) → CLASS A (Delivery)
Специфика: Drupal CMS

Добавленные папки

+ design/
    + CONTENT_TYPES.md
    + VIEWS.md
    + BLOCKS.md
+ solution/
    + modules/custom/
        + {module_name}/
    + themes/custom/
        + {theme_name}/
    + config/sync/

Добавленные документы

Документ Фаза создания Назначение
design/CONTENT_TYPES.md 5-Design Типы контента
design/VIEWS.md 5-Design Представления (Views)
design/BLOCKS.md 5-Design Блоки
operations/DRUPAL_UPGRADE.md 13-Operations План обновления Drupal

Дополненные секции DATA_MODEL.md

+ ## Content Types
  ### {content_type_name}
  | Поле | Тип | Обязательное |
  | field_{name} | {type} | {yes/no} |

+ ## Taxonomies
  ### {vocabulary_name}
  - {term1}
  - {term2}

Пример цепочки: lideravto

PROJECT_BASE (Level 0: Universal)
    ↓ наследует + добавляет IT-специфику
PROJECT_IT (Level 1: Domain = IT)
    ↓ наследует + добавляет Delivery-специфику
CLASS_A (Level 2: Class = Delivery)
    ↓ наследует + добавляет CS-Cart-специфику
CSCART_PROJECT (Level 3: Solution = CS-Cart 4.19.1)

Что получает lideravto на каждом уровне

Level 0 (BASE):
- design/, management/, solution/
- BRIEF, REQUIREMENTS, DESIGN
- STATUS, TODO

Level 1 (+IT):
- + DATA_MODEL, API
- + testing/, operations/
- + src/, tests/

Level 2 (+CLASS A):
- + ACCEPTANCE_CRITERIA
- + UAT_PLAN, UAT_RESULTS
- + Definition of Done в REQUIREMENTS

Level 3 (+CS-Cart):
- + MODULES, THEME, CATALOG_STRUCTURE
- + modules/{name}/CODE-PROMPT.md
- + CS-Cart версия в CLAUDE.md
- + Кастомные таблицы в DATA_MODEL


Механизм наследования

Файлы

# В PROJECT_IT.md (шаблон)
extends: PROJECT_BASE

# В lideravto/CLAUDE.md (проект)
extends: ../../../architect/templates/CSCART_PROJECT.md

Алгоритм применения

  1. Читаем цепочку наследования:
    lideravto → CSCART_PROJECT → CLASS_A → PROJECT_IT → PROJECT_BASE

  2. Собираем структуру снизу вверх:
    - Берём BASE
    - Накладываем IT (добавляет папки/документы)
    - Накладываем CLASS_A (добавляет критерии)
    - Накладываем CSCART (добавляет модули)

  3. Для каждого документа:
    - Секции из родителя — обязательны
    - Секции текущего уровня — добавляются
    - Все секции сохраняются в финальном документе


Связи / References


Версия: 0.1.0