architect/DOCUMENT_HIERARCHY.md

КАСКАДНАЯ ИЕРАРХИЯ ДОКУМЕНТОВ

Версия: 1.0.0
Дата: 2026-02-17
Назначение: Карта зависимостей документов платформы


ИЕРАРХИЯ (5 уровней)

УРОВЕНЬ 0: ТЕОРИЯ (LOCKED)
├── theory/QUESTIONS.md           9 вопросов (базис)
├── theory/MERKABA.md             Геометрическая модель
├── theory/SYSTEMS.md             Теория систем
├── theory/SYSTEM_TYPES.md        6 типов систем
├── theory/ASPECTS.md             9 аспектов описания
└── theory/TERMINOLOGY.md         Терминология

         extends

УРОВЕНЬ 1: КОНЦЕПЦИЯ ПЛАТФОРМЫ
├── concept/VISION.md             ЗАЧЕМ (extends QUESTIONS.md)
├── concept/PLATFORM.md           ЧТО (5 подсистем, extends SYSTEMS.md)
├── concept/PRINCIPLES.md         КАК ДУМАЕМ (8 принципов)
├── concept/AGENTS.md             КТО (архитектура агентов)
├── concept/ARCHITECTURE.md       КАК УСТРОЕНО (техническая)
├── concept/RESOURCES.md          ЧЕМ (ресурсы и доступ)
├── concept/PROJECTOR.md          КОГДА (жизненный цикл)  LOCKED
└── concept/ROLES.md              Роли в платформе

         extends

УРОВЕНЬ 2: СТАНДАРТЫ (правила)
├── standards/1-structure/        КАК УСТРОЕНО (extends ARCHITECTURE.md)
   ├── structure-workspace.md
   ├── structure-platform.md     extends PLATFORM.md
   ├── structure-project.md
   └── ...

├── standards/2-lifecycle/        КОГДА (extends PROJECTOR.md)
   ├── lifecycle-project.md      extends PROJECTOR.md
   ├── lifecycle-artifact.md
   └── ...

├── standards/3-process/          КАК ДЕЛАТЬ
   ├── process-development.md
   ├── process-deployment.md
   └── ...

├── standards/4-policy/           ПРАВИЛА
   ├── policy-security.md        extends PRINCIPLES.md
   ├── policy-code-data.md
   └── ...

├── standards/5-format/           КАК ВЫГЛЯДИТ
   ├── format-document.md
   ├── format-code.md
   └── ...

├── standards/6-naming/           КАК НАЗЫВАТЬ
   ├── naming-terminology.md     extends TERMINOLOGY.md
   └── ...

├── standards/7-typology/         ЧТО ЗА ТИПЫ (extends SYSTEM_TYPES.md)
   ├── typology-entity-types.md
   ├── typology-project-types.md
   └── ...

├── standards/8-operation/        КАК ЗАПУСКАТЬ
   └── ...

└── standards/9-guidance/         РУКОВОДСТВА
    ├── guidance-project-management.md    PM-система
    └── guidance-fractal-architecture.md  Рекурсивная структура

         extends

УРОВЕНЬ 3: ПАТТЕРНЫ (типовые решения)
├── patterns/PROJECT_PHASES.md    extends lifecycle-project.md
├── patterns/SCENARIOS.md         extends process-*.md
├── patterns/DIALOGS.md
└── ...

         extends

УРОВЕНЬ 4: ШАБЛОНЫ (готовые к использованию)
├── templates/CLAUDE.md.template      extends guidance-project-management.md
├── templates/CACHE.yaml.template
├── templates/PROJECT_BASE.md         extends structure-project.md
└── ...

ПРАВИЛА ЗАВИСИМОСТЕЙ

1. Наследование (extends)

Правило: Нижний уровень ДОЛЖЕН быть согласован с верхним.

Уровень Может ссылаться на Не может противоречить
Концепция (L1) Теория (L0) Теории
Стандарты (L2) Концепция, Теория Концепции, Теории
Паттерны (L3) Стандарты, Концепция Стандартам, Концепции
Шаблоны (L4) Паттерны, Стандарты Всем выше

2. Locked документы

LOCKED (нельзя менять без согласования):
- theory/* — базовая теория
- concept/PROJECTOR.md — жизненный цикл

Причина: Изменение этих документов влияет на всю платформу.

3. Противоречия

Запрещено:
- Стандарт противоречит концепции
- Паттерн противоречит стандарту
- Шаблон не соответствует паттерну

Если нашли противоречие:
1. Зафиксировать в INCONSISTENCIES.md
2. Обсудить с владельцем документа
3. Исправить на нижнем уровне (если возможно)
4. Исправить на верхнем уровне (только если обоснованно)


КЛЮЧЕВЫЕ ЗАВИСИМОСТИ

theory/ → concept/

Теория Концепция Связь
QUESTIONS.md (9 вопросов) VISION.md ЗАЧЕМ (цель)
SYSTEMS.md PLATFORM.md ЧТО (5 подсистем)
MERKABA.md PRINCIPLES.md КАК ДУМАЕМ (8 принципов)
ASPECTS.md standards/*/README.md 9 аспектов = 9 папок
TERMINOLOGY.md naming-terminology.md Терминология

concept/ → standards/

Концепция Стандарт Связь
PLATFORM.md (5 подсистем) structure-platform.md Структура платформы
ARCHITECTURE.md 1-structure/* Как устроено
PROJECTOR.md 2-lifecycle/* Жизненный цикл
PRINCIPLES.md 4-policy/* Правила
AGENTS.md policy-agents.md Правила агентов
RESOURCES.md structure-workspace.md Ресурсы workspace

standards/ → patterns/

Стандарт Паттерн Связь
lifecycle-project.md PROJECT_PHASES.md 15 фаз проекта
process-*.md SCENARIOS.md Типовые сценарии
guidance-project-management.md DIALOGS.md Паттерны диалогов

patterns/ → templates/

Паттерн Шаблон Связь
PROJECT_PHASES.md PROJECT_BASE.md Базовый проект
guidance-project-management.md CLAUDE.md.template Шаблон блока
- CACHE.yaml.template Шаблон входных данных

ПРОВЕРКА СООТВЕТСТВИЯ

Чек-лист для документа

Автоматическая проверка

# Проверить все ссылки
python tools/check-links.py architect/

# Проверить зависимости
python tools/check-dependencies.py architect/

# Найти противоречия
python tools/check-consistency.py architect/

СВЯЗАННЫЕ ДОКУМЕНТЫ


Версия: 1.0.0
Владелец: architect