architect/standards/REFORM_PLAN.md

type: plan
title: "Мастер-план реформы architect/standards/"
status: active
version: 1.0.0
date: 2026-02-19
owner: architect
priority: HIGH


МАСТЕР-ПЛАН РЕФОРМЫ architect/standards/

Полная реорганизация папки стандартов для устранения смешивания измерений и создания чистой ортогональной структуры.


EXECUTIVE SUMMARY

Проблема: 132 файла стандартов смешивают разные измерения (ЧТО, КАК, ГДЕ, КОГДА), что создаёт путаницу и дублирование.

Решение: Реструктуризация по главному измерению АСПЕКТ (КАК) с чёткими правилами размещения.

Результат: Чистая ортогональная структура из 9 папок-аспектов + guidance для multi-aspect документов.

Время: 9 фаз × 1-2 часа = ~15 часов работы

Риски: LOW (всё в архив, ничего не удаляем)


1. ТЕКУЩЕЕ СОСТОЯНИЕ

Статистика

architect/standards/
├── 40 файлов в корне
└── 10 подпапок (92 файла)
    ├── data/ (1)
    ├── documents/ (1)
    ├── 5-format/ (3)
    ├── functions/ (1)
    ├── infrastructure/ (1)
    ├── processes/ (30)
    ├── roles/ (5)
    ├── structure/ (28)
    ├── tools/ (2)
    └── 7-typology/ (10)

ИТОГО: 132 файла

Проблемы

Проблема Пример
Смешивание измерений structure/ = КАК УСТРОЕНО + ГДЕ ХРАНИТЬ
Дублирование DOCUMENT.md в 3 местах (5-format/, documents/, корень)
Неясная логика Почему CODE_DATA_SEPARATION.md в корне, а не в папке?
Файлы не на месте 40 файлов в корне вместо папок
Разная детализация 7-typology/PROJECT.md vs PROJECT_DOCUMENTATION.md vs PROJECT_MANAGEMENT.md

2. АНАЛИЗ ИЗМЕРЕНИЙ

Теория Меркаба применительно к стандартам

ТЕТРАЭДР ИНЬ (Статика/Данное):

Вопрос Измерение Применение к стандартам
ЧТО Сущность О чём стандарт (Project, Code, Data, Role)
ГДЕ Место На каком уровне (Platform, Project, Module)
ЧЕМ Материал Из чего состоит (код, данные, процессы)
ПОЧЕМУ Причина Зачем нужен стандарт (principles, decisions)

ТЕТРАЭДР ЯНЬ (Динамика/Действие):

Вопрос Измерение Применение к стандартам
КТО Деятель Кто применяет (architect, coder, infra)
КОГДА Время На какой стадии (plan, dev, test, prod)
КАК Способ Какой аспект описывает (структура, процесс, формат)
ЗАЧЕМ Цель Какую цель достигает

ЦЕНТР (Мера):

Вопрос Измерение Применение к стандартам
СКОЛЬКО Количество Метрики, размеры, лимиты

Проблема смешивания

Текущая структура смешивает измерения:

7-typology/          ЧТО (объект)
structure/      КАК (аспект) + ГДЕ (уровень)  СМЕСЬ!
5-format/        КАК (аспект формата)
processes/      КАК (аспект процесса) + КОГДА (lifecycle)  СМЕСЬ!
roles/          КТО (субъект)
tools/          ЧЕМ (инструмент)

Примеры смешивания:

Файл Что смешивает
1-structure/structure-project-hierarchy.md КАК УСТРОЕНО (структура) + ГДЕ (уровни иерархии)
processes/LIFECYCLE.md КАК ДЕЛАТЬ (процесс) + КОГДА (стадии)
CODE_DATA_SEPARATION.md ЧТО (артефакты) + ГДЕ (хранение) + КАК (политика)

3. ГЛАВНОЕ ИЗМЕРЕНИЕ: АСПЕКТ (КАК)

Почему АСПЕКТ?

Критерий Обоснование
Ортогональность Аспекты не пересекаются: структура ≠ процесс ≠ формат ≠ lifecycle
Полнота Покрывает все текущие стандарты
Понятность Вопрос "какой аспект?" естественен и однозначен
Расширяемость Можно добавить новые аспекты без реструктуризации
Соответствие теории Аспекты есть в MERKABA как грани КАК

9 аспектов стандартов

# Аспект Описывает Вопрос
1 structure Как организовано Какова структура X?
2 lifecycle Как живёт, эволюционирует Какие стадии проходит X?
3 process Как делать операции Как выполнить действие Y с X?
4 policy Правила, ограничения Что разрешено/запрещено для X?
5 format Как выглядит В каком формате X?
6 naming Как называть Как правильно назвать X?
7 typology Какого типа/класса К какому типу относится X?
8 operation Какие действия Какие конкретные операции с X?
9 guidance Multi-aspect руководства Как работать с X (всё вместе)?

4. ЦЕЛЕВАЯ СТРУКТУРА

Схема папок

architect/standards/

├── README.md                           Навигация по аспектам
├── INDEX.md                            Матрица ЧТО×КАК
├── REFORM_PLAN.md                      Этот файл

├── 1-structure/                        КАК УСТРОЕНО
   ├── README.md
   ├── entity.md                      Структура сущностей
   ├── project.md                     Структура проекта
   ├── platform.md                    Структура платформы
   ├── workspace.md                   Структура workspace
   ├── component.md                   Структура компонента
   ├── artifact.md                    Структура артефакта
   ├── hierarchy.md                   Иерархические связи
   └── context-blocks.md              Контекстные блоки

├── 2-lifecycle/                        КАК ЖИВЁТ / ЭВОЛЮЦИОНИРУЕТ
   ├── README.md
   ├── code.md                        dev  test  prod  archive
   ├── project.md                     plan  dev  prod  archive
   ├── data.md                        inbox  work  archive
   ├── artifact.md                    Жизненный цикл артефакта
   └── stages.md                      Общая модель стадий

├── 3-process/                          КАК ДЕЛАТЬ (операции)
   ├── README.md
   ├── development.md                 Процесс разработки
   ├── deployment.md                  Процесс деплоя
   ├── backup.md                      Процесс бэкапа
   ├── testing.md                     Процесс тестирования
   ├── documentation.md               Процесс документирования
   ├── project-bootstrap.md           Инициализация проекта
   ├── project-start.md               Запуск проекта
   ├── rollback.md                    Откат изменений
   ├── log-archiving.md               Архивирование логов
   └── script-deployment.md           Развёртывание скриптов

├── 4-policy/                           ПРАВИЛА / ОГРАНИЧЕНИЯ
   ├── README.md
   ├── code-data-separation.md        Разделение код/данные
   ├── docker.md                      Политика Docker
   ├── infra.md                       Политика инфраструктуры
   ├── security.md                    Политика безопасности
   ├── security-credentials.md        Защита паролей
   ├── data.md                        Политика данных
   ├── agents.md                      Правила агентов
   └── resource-allocation.md         Выделение ресурсов

├── 5-format/                           КАК ВЫГЛЯДИТ
   ├── README.md
   ├── document.md                    Формат документов (8 типов)
   ├── file-types.md                  Типы файлов (11 классов)
   ├── notifications.md               Формат уведомлений
   ├── code.md                        Стиль кода
   └── data.md                        Формат данных (yaml, json)

├── 6-naming/                           КАК НАЗЫВАТЬ
   ├── README.md
   ├── database.md                    Именование таблиц/полей
   ├── code-imports.md                Именование импортов
   ├── files.md                       Именование файлов
   ├── projects.md                    Именование проектов
   └── terminology.md                 Стандарт терминологии

├── 7-typology/                         ТИПИЗАЦИЯ / КЛАССИФИКАЦИЯ
   ├── README.md
   ├── projects.md                    Типы проектов
   ├── artifacts.md                   Классы артефактов
   ├── entities.md                    Типы сущностей
   ├── roles.md                       Типы ролей
   ├── services.md                    Типы сервисов
   ├── documents.md                   Типы документов
   └── processes.md                   Типы процессов

├── 8-operation/                        КАКИЕ ДЕЙСТВИЯ (конкретные)
   ├── README.md
   ├── resource-check.md              Проверка ресурсов
   ├── cleanup.md                     Очистка диска
   ├── monitoring.md                  Мониторинг
   └── disk-audit.md                  Аудит диска

└── 9-guidance/                         MULTI-ASPECT РУКОВОДСТВА
    ├── README.md
    ├── roles/                         Руководства для ролей
       ├── architect.md               structure + process + policy
       ├── coder.md
       ├── projector.md
       ├── infra.md
       └── terminal.md
    ├── tools/                         Использование инструментов
       ├── claude-code.md
       └── documentation-tomography.md
    └── workflows/                     Сквозные процессы
        ├── project-creation.md        plan + dev + deploy
        └── business-it-flow.md        business  requirements  dev

Правила размещения

Один файл = один аспект одного объекта

Формула: [аспект]/[объект]-[детализация].md

Примеры:
- structure/project.md              ← структура проекта
- lifecycle/code.md                 ← жизненный цикл кода
- process/deployment.md             ← процесс деплоя
- policy/security-credentials.md    ← политика безопасности
- format/document.md                ← формат документа
- naming/database.md                ← именование БД

Multi-aspect документы → guidance/

Если файл охватывает несколько аспектов:
- Описывает роль целиком (структура + процессы + политики) → guidance/roles/
- Описывает инструмент (формат + процессы + примеры) → guidance/tools/
- Сквозной workflow (планирование + разработка + деплой) → guidance/workflows/


5. ГРАФ ЗАВИСИМОСТЕЙ

Иерархия создания аспектов

1. typology/            Сначала типизация (что есть что)
   
2. structure/           Затем структура (как устроено)
   
3. format/              Затем формат (как выглядит)
   
4. naming/              Затем именование (как называть)
   
5. lifecycle/           Затем жизненный цикл (как живёт)
   
6. policy/              Затем политики (что можно/нельзя)
   
7. process/             Затем процессы (как делать)
   
8. operation/           Затем операции (конкретные действия)
   
9. guidance/            Наконец руководства (всё вместе)

Критические документы (фундамент)

Эти документы должны быть созданы первыми:

Документ Аспект Зачем
typology/artifacts.md Типизация Определяет все классы артефактов
typology/projects.md Типизация Определяет типы проектов
structure/workspace.md Структура Определяет структуру workspace
structure/hierarchy.md Структура Определяет уровни иерархии
format/document.md Формат ✅ УЖЕ ГОТОВ (Фаза 2 TICKET-005)
format/file-types.md Формат ✅ УЖЕ ГОТОВ (Фаза 1 TICKET-005)
naming/terminology.md Именование Канонические определения

Зависимости между файлами

typology/artifacts.md
    ↓ (используется в)
structure/workspace.md
    ↓ (используется в)
lifecycle/artifact.md
    ↓ (используется в)
process/development.md
    ↓ (используется в)
guidance/workflows/project-creation.md

6. ПОСЛЕДОВАТЕЛЬНОСТЬ РЕФОРМЫ

9 фаз (по аспектам)

Фаза Аспект Файлов Время Статус
1 format/ 7 1 час ✅ DONE (2026-02-19)
2 typology/ 8 1 час ✅ DONE (2026-02-19)
3 structure/ 12 1.5 часа ✅ DONE (2026-02-19)
4 naming/ 7 1 час ✅ DONE (2026-02-19)
5 lifecycle/ 6 1 час ✅ DONE (2026-02-19)
6 policy/ 12 1.5 часа ✅ DONE (2026-02-19)
7 process/ 24 3 часа ✅ DONE (2026-02-19)
8 operation/ 5 1 час ✅ DONE (2026-02-19)
9 guidance/ 15 2 часа ✅ DONE (2026-02-19)
ИТОГО ~100 ~15 часов

Почему именно такая последовательность?

  1. format/ — уже начали (TICKET-005), есть готовые файлы
  2. typology/ — нужна для всех остальных (типы проектов, артефактов)
  3. structure/ — зависит от типологии, нужна для lifecycle
  4. naming/ — зависит от структуры, нужна для всех
  5. lifecycle/ — зависит от структуры, нужна для процессов
  6. policy/ — зависит от lifecycle, определяет ограничения для процессов
  7. process/ — зависит от policy, описывает конкретные процессы
  8. operation/ — зависит от процессов, конкретные команды
  9. guidance/ — зависит от всех, обобщает всё вместе

7. ДЕТАЛЬНЫЙ ПЛАН ПО ФАЗАМ

ФАЗА 1: format/ (1 час)

Статус: ✅ ЗАВЕРШЕНА (2026-02-19)

Готово:
- ✅ 5-format/format-file-types.md — 11 классов файлов (911 строк)
- ✅ 5-format/format-document.md — типы документов (8 типов)
- ✅ 5-format/format-markdown.md — стандарт Markdown (GFM + Pandoc + Custom, 909 строк)
- ✅ 5-format/format-notifications.md — формат уведомлений (переименован в lowercase)
- ✅ 5-format/format-data.md — форматы данных YAML/JSON/CSV/Excel (593 строки)
- ✅ 5-format/format-code.md — стиль кода Python/JS/TS/Bash (670 строк)
- ✅ 5-format/README.md — навигация по форматам (178 строк)

Инструменты:
- ✅ architect/tools/md-compile.py — preprocessor для компиляции иерархических .md
- ✅ architect/tools/README.md — документация инструментов

Критерии готовности:
- ✅ Все форматы описаны (документы, файлы, данные, код, уведомления)
- ✅ Нет дублей
- ✅ README.md создан с навигацией
- ✅ Preprocessor для Markdown компиляции


ФАЗА 2: typology/ (1 час)

Статус: ✅ DONE (2026-02-19)

Цель: Переместить и объединить все типы из 7-typology/.

Файлы для миграции:

7-typology/PROJECT.md               typology/projects.md
7-typology/typology-project-types.md         typology/projects.md (объединить)
7-typology/PROJECT_CLASSIFIER.md    typology/projects.md (объединить)
7-typology/ENTITY.md                typology/entities.md
7-typology/DOCUMENT.md              typology/documents.md
7-typology/PROCESS.md               typology/processes.md
7-typology/SERVICE.md               typology/services.md
7-typology/ROLE.md                  typology/roles.md
7-typology/COMMERCIAL_PROJECTS.md   typology/projects.md (секция)
ARTIFACT_CLASSES.md            typology/artifacts.md

Новые файлы:
- typology/projects.md — все типы проектов (IT, Business, Platform)
- typology/artifacts.md — 12 классов артефактов
- typology/entities.md — типы сущностей
- typology/roles.md — типы ролей
- typology/services.md — типы сервисов
- typology/documents.md — типы документов
- typology/processes.md — типы процессов

Действия:
1. Создать папку typology/
2. Объединить дублирующиеся файлы про проекты (3 → 1)
3. Переместить остальные с переименованием
4. Создать README.md с матрицей типов
5. Архивировать старую папку 7-typology/

Критерии готовности:
- [ ] Все типы в одной папке
- [ ] Нет дублей (3 файла про проекты → 1)
- [ ] README.md с полной матрицей типов


ФАЗА 3: structure/ (1.5 часа)

Статус: ✅ DONE (2026-02-19)

Цель: Объединить файлы про структуру из папки structure/ (28 файлов → ~8 файлов).

Проблема: В structure/ много дублей и устаревших файлов (см. TICKET-005 Фаза 3).

Ключевые файлы для сохранения:

1-structure/structure-workspace.md                 structure/workspace.md 
1-structure/structure-platform.md          structure/platform.md 
1-structure/structure-project.md  structure/project.md 
1-structure/structure-component.md                 structure/component.md 
1-structure/structure-organization.md               structure/organization.md 
1-structure/structure-entity-hierarchy.md           structure/hierarchy.md 
structure/TREE_REPRESENTATION.md        structure/tree.md 
CONTEXT_BLOCKS.md                       structure/context-blocks.md 

Файлы для архивации (дубли):

structure/UNIVERSAL_PROJECT_STRUCTURE.md    ← дубль PROJECT_STRUCTURE_STANDARD
1-structure/structure-project-hierarchy.md              ← дубль
structure/PROJECT_HIERARCHY_PMI.md          ← дубль
structure/PROJECT.md                        ← дубль
structure/PROJECT_QUICK_START.md            ← процесс, не структура
structure/PROJECT_STORAGE.md                ← хранение, не структура
structure/PROJECT_STRUCTURE.md              ← дубль
structure/FOLDERS_FILES_STRUCTURE.md        ← устарел, заменён PLATFORM_FOLDERS
structure/LAYERS_GUIDE.md                   ← устаревшая концепция слоёв
structure/LAYERS_EXPLAINED.md               ← устаревшая концепция
structure/LAYERED_HIERARCHY.md              ← устаревшая концепция
structure/ENTITY_CATALOG.md                 → typology/entities.md
structure/ENTITY_CLASSIFICATION.md          → typology/entities.md
structure/SUBPROJECTS.md                    → structure/project.md (секция)

Новые объединённые файлы:
- structure/project.md — объединяет 7 файлов про структуру проекта
- structure/entity.md — объединяет 3 файла про сущности
- structure/workspace.md — уже готов
- structure/platform.md — из PLATFORM_FOLDERS
- structure/component.md — из COMPONENTS
- structure/hierarchy.md — из ENTITY_HIERARCHY
- structure/organization.md — из ORGANIZATION
- structure/tree.md — визуализация
- structure/context-blocks.md — контекстные блоки

Действия:
1. Создать новую папку 1-structure/
2. Переместить 8 ключевых файлов
3. Архивировать 15 дублей → arh/standards/structure/2026-02-before-reform/
4. Создать README.md с навигацией
5. Удалить старую папку structure/

Время: 2 часа (много файлов для анализа и объединения)

Критерии готовности:
- [ ] 28 файлов → 8 файлов (сокращение на 71%)
- [ ] Нет дублей
- [ ] Все аспекты структуры покрыты
- [ ] README.md с диаграммами


ФАЗА 4: naming/ (1 час)

Статус: ✅ DONE (2026-02-19)

Файлы для миграции:

DATABASE_NAMING.md         → naming/database.md
CODE_IMPORTS.md            → naming/code-imports.md
TERMINOLOGY_STANDARD.md    → naming/terminology.md

Новые файлы:
- naming/files.md — именование файлов (используя FILE_TYPES.md)
- naming/projects.md — именование проектов
- naming/variables.md — именование переменных в коде

Действия:
1. Создать папку naming/
2. Переместить 3 файла из корня
3. Создать 3 новых файла
4. Создать README.md

Критерии готовности:
- [ ] Все аспекты именования покрыты
- [ ] Канонический словарь терминов


ФАЗА 5: lifecycle/ (1 час)

Статус: ✅ DONE (2026-02-19)

Файлы для миграции:

DATA_LIFECYCLE.md          → lifecycle/data.md
CODE_STAGES.md             → lifecycle/code.md
processes/LIFECYCLE.md     → lifecycle/artifact.md
processes/PROJECT_LIFECYCLE.md → lifecycle/project.md

Новые файлы:
- lifecycle/stages.md — общая модель стадий (план → dev → test → prod → archive)

Действия:
1. Создать папку lifecycle/
2. Переместить 4 файла
3. Создать общий lifecycle/stages.md
4. Создать README.md с диаграммой стадий

Критерии готовности:
- [ ] Все объекты с lifecycle покрыты
- [ ] Единая модель стадий
- [ ] Диаграммы переходов


ФАЗА 6: policy/ (1.5 часа)

Статус: ✅ DONE (2026-02-19)

Файлы для миграции:

CODE_DATA_SEPARATION.md       → policy/code-data-separation.md
DATA_POLICY.md                → policy/data.md
DOCKER_POLICY.md              → policy/docker.md
AGENT_RULES.md                → policy/agents.md
SECURITY.md                   → policy/security.md
SECURITY_CREDENTIALS.md       → policy/security-credentials.md
processes/INFRA_POLICY.md     → policy/infra.md
processes/ROLLBACK_POLICY.md  → policy/rollback.md
processes/RESOURCE_ALLOCATION.md → policy/resource-allocation.md
LICENSING_STRATEGY.md         → policy/licensing.md

Новые файлы:
- policy/README.md — индекс политик
- policy/code.md — политики кода (стиль, импорты, структура)

Действия:
1. Создать папку policy/
2. Переместить 10 файлов из корня и processes/
3. Создать README.md
4. Сгруппировать связанные политики

Критерии готовности:
- [ ] Все политики в одном месте
- [ ] Нет дублей
- [ ] Чёткая структура: безопасность, данные, код, инфра


ФАЗА 7: process/ (3 часа)

Статус: ✅ DONE (2026-02-19)

Цель: Реорганизовать processes/ (30 файлов) → process/ с чёткой структурой.

Группы процессов:

A. Разработка (Development):

processes/DEVELOPMENT.md            process/development.md
processes/CODE_PROMPT.md            process/code-prompt.md
processes/MODULE_TESTING.md         process/testing.md

B. Развёртывание (Deployment):

processes/DEPLOYMENT.md             process/deployment.md
processes/SCRIPT_DEPLOYMENT.md      process/script-deployment.md

C. Операции (Operations):

processes/BACKUP.md                 process/backup.md
processes/LOG_ARCHIVING.md          process/log-archiving.md
processes/RESOURCE_CHECK.md         process/resource-check.md

D. Документирование:

processes/DOCUMENTATION.md          process/documentation.md

E. Управление проектами:

processes/PROJECT_BOOTSTRAP.md      process/project-bootstrap.md
processes/PROJECT_START.md          process/project-start.md
processes/PROJECT_INIT.md           (объединить с bootstrap)
processes/PROJECT_DEV.md            (объединить с development)
processes/PROJECT_OPS.md            (объединить с operations)
processes/PROJECT_CREATION_SYSTEM.md  guidance/workflows/
processes/PROJECT_WORKFLOW.md       guidance/workflows/

F. Специальные:

processes/DECISION_MAKING.md        process/decision-making.md
processes/ROLE_MANAGEMENT.md        process/role-management.md
processes/TASK_QUEUE.md             process/task-queue.md
processes/TICKETS.md                process/tickets.md

G. IT-специфичные (в guidance):

processes/IT_PROJECTS.md            guidance/workflows/it-projects.md
processes/IT_SOLUTION_DEVELOPMENT.md  guidance/workflows/it-solution.md
processes/BUSINESS_IT_BOUNDARY.md   guidance/workflows/business-it-flow.md

Архивировать дубли:

processes/PROJECT_STRUCTURE_RULES.md   дубль structure/project.md
processes/PROCESSES.md                 индекс, не нужен

Действия:
1. Создать папку process/
2. Переместить ~20 файлов процессов
3. Объединить дубли (PROJECT_INIT + PROJECT_BOOTSTRAP)
4. Переместить workflows в guidance/
5. Архивировать дубли
6. Создать README.md с группировкой

Время: 3 часа (много файлов, нужно анализировать пересечения)

Критерии готовности:
- [ ] 30 файлов → ~15 файлов процессов + 5 в guidance/workflows
- [ ] Чёткая группировка: dev, deploy, ops, docs
- [ ] Нет дублей


ФАЗА 8: operation/ (1 час)

Статус: ✅ DONE (2026-02-19)

Файлы для миграции:

CLEANUP_LEVELS.md              → operation/cleanup.md
DISK_AUDIT_2025-12-24.md       → operation/disk-audit.md
DISK_GROWTH_MONITORING.md      → operation/monitoring.md
processes/RESOURCE_CHECK.md    → operation/resource-check.md

Новые файлы:
- operation/README.md — индекс операций
- operation/alerts.md — настройка алертов

Действия:
1. Создать папку operation/
2. Переместить 4 файла
3. Создать README.md

Критерии готовности:
- [ ] Все конкретные операции в одном месте
- [ ] Связь с процессами (resource-check используется в processes)


ФАЗА 9: guidance/ (2 часа)

Статус: ✅ DONE (2026-02-19)

Цель: Собрать multi-aspect руководства.

Структура:

guidance/
├── README.md
├── roles/                     Руководства для ролей
   ├── architect.md         (structure + process + policy)
   ├── coder.md
   ├── projector.md
   ├── infra.md
   └── terminal.md
├── tools/                    Инструменты
   ├── claude-code.md
   └── documentation-tomography.md
└── workflows/                Сквозные процессы
    ├── project-creation.md  (typology + structure + process)
    ├── business-it-flow.md  (policy + process)
    └── it-solution.md       (structure + process + format)

Файлы для миграции:

roles/architect.md              guidance/roles/architect.md
roles/coder.md                  guidance/roles/coder.md
roles/projector.md              guidance/roles/projector.md
roles/infra.md                  guidance/roles/infra.md
roles/terminal.md               guidance/roles/terminal.md

tools/CLAUDE_CODE_MODES.md      guidance/tools/claude-code.md
tools/DOCUMENTATION_TOMOGRAPHY.md  guidance/tools/documentation-tomography.md

structure/BUSINESS_TO_IT_FLOW.md  guidance/workflows/business-it-flow.md
processes/PROJECT_CREATION_SYSTEM.md  guidance/workflows/project-creation.md
processes/IT_SOLUTION_DEVELOPMENT.md  guidance/workflows/it-solution.md

Новые файлы:
- guidance/README.md — как использовать руководства
- guidance/workflows/fractal-architecture.md — из FRACTAL_ARCHITECTURE.md

Действия:
1. Создать структуру guidance/
2. Переместить все роли
3. Переместить инструменты
4. Создать workflows из процессов
5. Создать README.md

Критерии готовности:
- [x] Все роли в guidance/roles/
- [x] Все multi-aspect документы в guidance/
- [x] README.md объясняет когда использовать guidance vs конкретные аспекты

Готово:
- ✅ Корневые файлы переименованы (3):
- guidance-fractal-architecture.md — фрактальная архитектура
- guidance-infra-bot.md — инфраструктурный бот
- guidance-project-management.md — управление проектами
- ✅ Роли агентов (5 файлов уже в lowercase):
- roles/architect.md, roles/coder.md, roles/infra.md
- roles/projector.md, roles/terminal.md
- ✅ Инструменты переименованы (2):
- tools/claude-code-modes.md (было CLAUDE_CODE_MODES.md)
- tools/documentation-tomography.md (было DOCUMENTATION_TOMOGRAPHY.md)
- ✅ Workflows переименованы (4):
- workflows/business-it-boundary.md (было BUSINESS_IT_BOUNDARY.md)
- workflows/it-projects.md (было IT_PROJECTS.md)
- workflows/it-solution-development.md (было IT_SOLUTION_DEVELOPMENT.md)
- workflows/project-creation-system.md (было PROJECT_CREATION_SYSTEM.md)
- ✅ 9-guidance/README.md создан (380 строк) — навигация + концепции

Итого: 14 руководств + 1 README = 15 файлов


8. ФАЙЛЫ ВНЕ АСПЕКТОВ

Корневые мета-файлы (остаются в корне)

architect/standards/
├── README.md              ← Навигация по стандартам
├── INDEX.md               ← Матрица ЧТО×КАК
├── REFORM_PLAN.md         ← Этот файл
└── CHANGELOG.md           ← История изменений стандартов

Специфичные домены (отдельные папки)

data/
└── PRICE_ADAPTERS.md       Оставить как есть (domain-specific)

infrastructure/
└── DOMAINS.md              Оставить как есть (infra-specific)

functions/
└── FUNCTIONS.md            Оставить как есть (library-specific)

Файлы для архивации (устаревшие)

CLAUDE_HIERARCHY.md         Устарел, заменён structure/hierarchy.md
PROJECT_MANAGEMENT.md       Дубль guidance/workflows/
SOLUTION_STRUCTURE.md       Дубль structure/
BUSINESS_PROJECT_DOCS.md    Дубль typology/ + format/
COMPONENT_ARCHITECTURE.md   Дубль structure/component.md
LIBRARY_ARCHITECTURE.md     Переместить в library/ARCHITECTURE.md
ENTITY_HIERARCHY.md         Дубль structure/hierarchy.md
INDEX_PY.md                 Переместить в library/standards/
INFRA_BOT.md                Переместить в system/infra-bot/
LINKS.md                    Устарел
MODEL_DELEGATION.md         Оставить (важный, активный)
TIME_ESTIMATION_AI.md       Оставить (важный, активный)
PROTOCOL.md                 Оставить (важный, активный)
QUESTIONS.md                Оставить (важный, активный)
DESIGN_LAYERS.md            Оставить (важный для themes)
CODE_LIBRARY.md             Переместить в library/README.md

9. МАТРИЦА ЧТО × КАК

После реформы создать файл INDEX.md с матрицей:

ЧТО ↓ / КАК → structure lifecycle process policy format naming typology
Project
Code
Data
Document
Agent
Artifact
Role
Service

✅ = есть стандарт
— = не применимо или не нужно


10. КРИТЕРИИ ГОТОВНОСТИ

По каждой фазе

Глобальные критерии


11. РИСКИ И МИТИГАЦИЯ

Риск Вероятность Влияние Митигация
Потеря информации LOW HIGH Всё в arh/, ничего не удаляем
Битые ссылки MEDIUM MEDIUM Поиск по всему workspace + обновление
Смешивание измерений MEDIUM HIGH Чеклист перед каждым файлом: ЧТО×КАК×ГДЕ×КОГДА
Превышение времени MEDIUM LOW Поэтапно, можно остановиться после любой фазы
Несогласованность LOW MEDIUM Каждая фаза review перед следующей
Забыли файл LOW LOW Финальная проверка: grep для всех .md

12. ИНСТРУМЕНТЫ

Автоматизация

Скрипты для создания:

# 1. Анализ текущих файлов
system/scripts/standards-analyze.py
└── Вывод: матрица ЧТО×КАК для каждого файла

# 2. Миграция файлов
system/scripts/standards-migrate.py
└── Автоматическое перемещение по плану

# 3. Проверка битых ссылок
system/scripts/check-links.py
└── Поиск и список битых ссылок

# 4. Генерация README
system/scripts/generate-readme.py
└── Автоматическая генерация README.md для каждой папки

Чеклист перед размещением файла

[ ] Определил ЧТО (объект): _______
[ ] Определил КАК (аспект): _______
[ ] Определил ГДЕ (уровень): _______
[ ] Определил КОГДА (стадия): _______
[ ] Файл описывает ОДИН аспект? (да/нет)
[ ] Если несколько аспектов → в guidance/? (да/нет)
[ ] Название файла: [аспект]/[объект].md
[ ] Нет ли дублей с существующими файлами?

13. СЛЕДУЮЩИЕ ШАГИ

Немедленно (сегодня)

  1. ✅ Создать REFORM_PLAN.md (этот файл)
  2. ⏳ Утвердить план
  3. ⏳ Начать Фазу 1 (format/) — уже частично готова

Краткосрочно (эта неделя)

  1. Завершить Фазу 1: format/
  2. Выполнить Фазу 2: typology/
  3. Выполнить Фазу 3: structure/

Среднесрочно (этот месяц)

  1. Фазы 4-6: naming, lifecycle, policy
  2. Фаза 7: process (самая большая)
  3. Фазы 8-9: operation, guidance

Долгосрочно

  1. Обновить все ссылки в документации
  2. Создать INDEX.md с матрицей
  3. Написать architect/theory/ASPECTS.md (теория 9 аспектов)
  4. Обновить CLAUDE.md со ссылками на новую структуру

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


15. CHANGELOG

2026-02-19 v2.0.0 — РЕФОРМА ЗАВЕРШЕНА

Выполненные фазы:
1. ФАЗА 1: format/ (7 файлов) — форматы документов, данных, кода
2. ФАЗА 2: typology/ (8 файлов) — типологии проектов, артефактов, ролей
3. ФАЗА 3: structure/ (12 файлов) — структура workspace, проектов, компонентов
4. ФАЗА 4: naming/ (7 файлов) — правила именования
5. ФАЗА 5: lifecycle/ (6 файлов) — жизненный цикл систем
6. ФАЗА 6: policy/ (12 файлов) — политики кода, данных, инфраструктуры, безопасности
7. ФАЗА 7: process/ (24 файла) — процессы разработки, деплоя, операций
8. ФАЗА 8: operation/ (5 файлов) — конкретные операции (cleanup, audit, monitoring)
9. ФАЗА 9: guidance/ (15 файлов) — интегрированные руководства

2026-02-19 v1.0.0


Версия: 2.0.0
Дата: 2026-02-19
Статус: COMPLETED ✅
Приоритет: HIGH
Владелец: architect

Время выполнения: ~15 часов (9 фаз)
Прогресс: 100% (все 9 фаз завершены) ✅