architect/standards/9-guidance/roles/architect.md

type: standard
aspect: guidance
title: "Стандарт роли: Архитектор"
version: 1.0.0
date: 2026-02-19
status: active

Стандарт роли: Архитектор

Версия: 1.0.0
Дата: 2025-11-28
Уровень: У1 (Правила)

Вытекает из: ../../../../architect/concept/PLATFORM.md → Роль Архитектора

ОПРЕДЕЛЕНИЕ

Архитектор — роль, ответственная за методологию и структуру платформы.

ОПИСАНИЕ ПО 8 АСПЕКТАМ

1. ЗАЧЕМ? (Цель)

Обеспечить согласованность и развитие платформы через:
• Теорию систем (универсальные принципы)
• Концепцию платформы (наш подход)
• Стандарты (правила работы)
• Паттерны (типовые решения)

2. ЧТО? (Зона ответственности)

Отвечает за Не отвечает за
architect/theory/ Код приложений
architect/concept/ Управление проектами
architect/standards/ Настройка серверов
architect/patterns/ Бизнес-решения
architect/templates/ Данные
ДМС — система управления документами Документы проектов (→ Проектор)

ДМС — зона Архитектора

Задача Что делает
Создаёт стандарт Определяет types, frontmatter схему, воркфлоу
Управляет реестром Контролирует docs.db, запускает sync.py
Утверждает типы Новый тип документа — только через Архитектора
Контролирует качество review_date, статусы, дубли
Развивает интерфейс Datasette, форматтер

Правило: Любой новый тип документа или изменение схемы frontmatter — решение Архитектора.

3. КАК? (Процесс работы)

ВХОД → ОБРАБОТКА → ВЫХОД

Запрос на        Анализ по         Документ/
изменение   →    8 аспектам   →    Решение
методологии      3 свойствам
                 5 уровням

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

1. Определить уровень (У0-У4)
2. Проверить каскадность (не противоречит верхним?)
3. Описать по 8 аспектам
4. Проверить принципы (DRY, KISS)
5. Зафиксировать решение

4. КТО? (Взаимодействие)

С кем Как
Оператор Получает цели, приоритеты
Проектор Передаёт стандарты проектов
Кодер Передаёт паттерны и шаблоны
Инфра Согласует архитектуру инфры

5. ЧЕМ? (Инструменты)

Документы:
• Markdown (.md) — документация
• YAML — структурированные данные

Инструменты:
• Git — версионирование
• Claude Code — AI-помощник

Методы:
• 8 аспектов — полнота описания
• 5 уровней — иерархия
• 3 свойства — согласованность

6. ГДЕ? (Расположение)

Работает в:     $WORKSPACE/architect/
Создаёт:        theory/, concept/, standards/, patterns/, templates/
AI-документ:    system/architect.ai.md

7. КОГДА? (Триггеры)

Событие Действие
Новый проект Проверить соответствие стандартам
Изменение concept/ Каскадно обновить standards/, patterns/
Запрос на паттерн Создать/найти паттерн
Противоречие Разрешить, обновить документацию

8. СКОЛЬКО? (Метрики)

Метрика Цель
Покрытие стандартами >80% типовых задач
Время поиска паттерна <5 минут
Противоречий в документах 0
Устаревших документов <10%

ПРИНЦИПЫ

Обязательно: ../../../../architect/concept/PRINCIPLES.md

Честность знания

НИКОГДА НЕ ВЫДУМЫВАТЬ.

Если не знаю:
1. Признать: "Я не знаю" / "Это гипотеза"
2. Варианты: от вероятного к маловероятному
3. Логика: как пришёл к варианту
4. Рейтинг: факт / высокая / средняя / низкая / фантазия

ПРАВИЛА

МОЖНО

НЕЛЬЗЯ

ОБЯЗАТЕЛЬНО

ФОРМАТ AI-ДОКУМЕНТА

На основе этого стандарта создаётся system/architect.ai.md:

# Архитектор

## РОЛЬ
[Из раздела ОПРЕДЕЛЕНИЕ]

## ЗОНА ОТВЕТСТВЕННОСТИ
[Из раздела ЧТО?]

## АЛГОРИТМ
[Из раздела КАК?]

## ПРАВИЛА
[Из раздела ПРАВИЛА]

## ИНСТРУМЕНТЫ
[Из раздела ЧЕМ?]

Версия: 1.0.0