DECISIONS — Архитектурные решения

Обновлено: 2025-12-04

ADR-001: Теория 9 вопросов как основа

Дата: 2025-11-15
Статус: accepted

Контекст

Нужна универсальная модель для описания любых систем.

Решение

Использовать расширение Аристотелевых категорий — 9 вопросов:
- 8 вопросов (Меркаба): ЧТО, КТО, ГДЕ, КОГДА, КАК, ЧЕМ, ПОЧЕМУ, ЗАЧЕМ
- 9-й вопрос: СКОЛЬКО (мера)

Последствия

• ✅ Универсальность — применимо к любой системе
• ✅ Полнота — 9 вопросов покрывают все аспекты
• ✅ Философская обоснованность
• ⚠️ Требует обучения для понимания

ADR-002: Модель Меркаба для визуализации

Дата: 2025-11-15
Статус: accepted

Контекст

Нужна визуальная модель для 8 вопросов.

Решение

Использовать звёздный тетраэдр (Меркаба):
- Тетраэдр ИНЬ: ЧТО, ГДЕ, ЧЕМ, ПОЧЕМУ (данное)
- Тетраэдр ЯНЬ: КТО, КОГДА, КАК, ЗАЧЕМ (действие)
- 4 диагонали = 4 противоположности

Последствия

• ✅ Показывает связи между вопросами
• ✅ Делит на Инь (данное) и Янь (действие)
• ⚠️ Абстрактно, нужна визуализация

ADR-003: Разделение theory/concept/standards

Дата: 2025-11-20
Статус: accepted

Контекст

Как организовать методологию?

Решение

Три уровня:
1. theory/ — универсальная теория (LOCKED после v3)
2. concept/ — концепция нашей платформы
3. standards/ — конкретные стандарты

Последствия

• ✅ Чёткое разделение абстракций
• ✅ theory/ не меняется, можно ссылаться
• ✅ Новые стандарты добавляются без изменения теории

ADR-004: Типы систем по количеству вопросов

Дата: 2025-11-25
Статус: accepted

Контекст

Как стандартизировать описание разных сущностей?

Решение

Каждый тип системы описывается своим набором вопросов:
- PROJECT (Целевая) — 9 вопросов
- SERVICE (Обеспечивающая) — 7 вопросов
- PROCESS — 8 вопросов
- ROLE (Агент) — 6 вопросов
- DOCUMENT — 5 вопросов
- ENTITY (Структура) — 4 вопроса

Последствия

• ✅ Единый подход к описанию
• ✅ Минимум документов = ответы на нужные вопросы
• ⚠️ Нужно знать тип системы

ADR-005: Docsify вместо Wiki.js

Дата: 2025-12-04
Статус: accepted

Контекст

Wiki.js импортирует файлы в БД, теряется связь с git.

Решение

Использовать Docsify — читает .md файлы напрямую.

Последствия

• ✅ Файлы остаются в git
• ✅ Нет дублирования в БД
• ✅ Простая настройка
• ⚠️ Только чтение (нет визуального редактора)

ADR-006: Унификация агентов по 6 вопросам

Дата: 2025-12-04
Статус: accepted

Контекст

Агенты описаны в разных форматах.

Решение

Все агенты следуют шаблону AGENT_TEMPLATE.md:
- КТО? — идентичность
- ЗАЧЕМ? — миссия
- ЧТО ДЕЛАЮ — функции
- ЧТО НЕ ДЕЛАЮ — границы
- КАК РАБОТАЮ — процесс
- ЧЕМ ПОЛЬЗУЮСЬ — инструменты

Последствия

• ✅ Единый формат всех агентов
• ✅ Легко создавать новых
• ✅ Понятные границы ответственности

Версия: 1.0.0