Дата: 2026-01-17
Цель: Понять ВСЮ структуру, найти дублирование, предложить чёткую архитектуру
Файл: $WORKSPACE/CLAUDE.md
| Режим | Маркер | Область | Триггеры |
|---|---|---|---|
| Оператор | ● | Инфра, серверы, БД | настрой, проверь, статус, запусти |
| Проектор | ◆ | Проекты, фичи, код | pirotehnika, фича, баг, задача |
| Архитектор | ▲ | Методология, стандарты | стандарт, методология, правило, агент |
Подрежимы:
- Проектор: Исследование / Планирование / Реализация
- Архитектор: Исследование / Обсуждение / Документация
- Оператор: (нет подрежимов)
Файл: system/agents/CLAUDE.md
| Агент | Файл | Роль | Связь с режимами |
|---|---|---|---|
| dispatcher | dispatcher.ai.md | Делегирование моделям (Haiku/Sonnet/Opus) | Все режимы |
| projector | projector.ai.md | Планирование проектов (15 фаз, очередь) | Проектор ◆ |
| librarian | librarian.ai.md | Управление library/ | Архитектор ▲ (?) |
Определяют ЧТО делать в домене
| Специалист | Файл | Домен | Триггеры |
|---|---|---|---|
| business | business.ai.md | Бизнес, продажи, B2B/B2C | магазин, продажи, клиенты |
| technical | technical.ai.md | IT-проекты, API, системы | разработка, API, сервис |
| marketing | marketing.ai.md | Маркетинг, SEO, контент | реклама, SEO, контент |
| data | data.ai.md | Аналитика, BI, данные | аналитика, отчёт, данные |
| design | design.ai.md | UX/UI, дизайн | дизайн, UI, макет |
| pim | pim.ai.md | Product Information Management | pim, каталог товаров, прайс |
| 1c | 1c.ai.md | 1С-Ассистент, документы | 1с, накладная, счёт, документ |
Определяют КАК делать работу
| Исполнитель | Файл | Работа | Связь с режимами |
|---|---|---|---|
| coder | coder.ai.md | Код (правила, стиль) | Проектор ◆ Реализация |
| infra | infra.ai.md | Инфраструктура (серверы, деплой) | Оператор ● |
| integrator | integrator.ai.md | Интеграции (API, MCP, секреты) | Оператор ● |
| analyst | analyst.ai.md | Анализ (типы, формат отчётов) | Проектор ◆ Исследование |
Знания о технологиях
| Стек | Файл | Описание |
|---|---|---|
| fastapi | fastapi.ai.md | FastAPI ecosystem |
| scrapy | scrapy.ai.md | Web scraping |
| Файл | Содержание | Триггеры |
|---|---|---|
| PROCESSES.md | 5 типов процессов + матрица | фича, баг, рефакторинг |
| PROMPTS.md | Шаблоны промптов | шаблон, делегирование |
| COMMANDS.md | Стоп-команды | стоп, остановись |
Из system/agents/CLAUDE.md:
Протокол (/CLAUDE.md) — режимы, L1-L4, диалог
↓
Dispatcher — делегирование моделям
↓
Protocols — процессы, промпты
↓
Планировщики (projector, librarian)
↓
Специалисты (ЧТО делать в домене)
↓
Исполнители (КАК делать работу)
↓
Стеки (технологии)
Из system/agents/CLAUDE.md строки 132-137:
| Режим | Специалисты | Исполнители |
|---|---|---|
| Оператор ● | — | infra, integrator |
| Проектор ◆ | business, technical | coder, analyst |
| Архитектор ▲ | — | — |
CLAUDE.md:
Режим: ПРОЕКТОР ◆
- Триггеры: pirotehnika, фича, баг
- Подрежимы: Исследование/Планирование/Реализация
- Формат отчёта
system/agents/projector.ai.md:
Проектор — планировщик проектов
- 15 фаз жизненного цикла
- Очередь задач
- Декомпозиция
Вопрос: Это дублирование или дополнение?
Ответ: Дополнение. projector.ai.md ссылается на CLAUDE.md как базовый протокол.
Проблема: НЕПОНЯТНО какая часть где. Размыто.
В CLAUDE.md есть:
- Режимы (Оператор/Проектор/Архитектор) — КТО я сейчас
- L1-L4 протокол — КАК работать
- Делегирование моделям — КОМУ поручить
В system/agents/ есть:
- Планировщики (projector, librarian) — КАК планировать
- Специалисты (business, technical) — ЧТО делать
- Исполнители (coder, infra) — КАК делать
Результат: Непонятно на каком уровне принимать решение.
Пример: Задача "Создать API для магазина"
Сейчас непонятно:
1. Режим: Проектор ◆ или Архитектор ▲ (если планируем архитектуру)?
2. Специалист: business (магазин) или technical (API)?
3. Исполнитель: coder (код)?
4. Стек: fastapi?
Как они взаимодействуют?
Как ДОЛЖНО быть:
Проектор ◆ (режим)
→ Планирование (подрежим)
→ technical (специалист: IT-проект)
→ coder (исполнитель: код)
→ fastapi (стек: технология)
Или:
Проектор ◆
→ business (специалист: магазин)
→ technical (уточнение: API)
→ coder (код)
→ fastapi
Оператор ● есть в CLAUDE.md:
- Режим для инфры, серверов, БД
Но в system/agents/:
- НЕТ operator.ai.md
- Только ссылка: "Оператор ● → infra, integrator"
Проблема: Если Проектор и Архитектор детализированы (projector.ai.md), почему Оператор нет?
Архитектор ▲ в CLAUDE.md:
- Методология, стандарты, документация
- "Без кода до согласования"
В system/agents/CLAUDE.md:
Архитектор ▲ | Специалисты: — | Исполнители: —
Вопрос: Кто помогает Архитектору? Никто?
Возможный ответ: librarian (управление library/, стандарты)?
Проблема: Связь не явная.
Сейчас:
- 3 режима (Оператор/Проектор/Архитектор)
- 6 подрежимов (3 у Проектора, 3 у Архитектора)
- 3 планировщика (dispatcher, projector, librarian)
- 7 специалистов (business, technical, marketing, data, design, pim, 1c)
- 4 исполнителя (coder, infra, integrator, analyst)
- 2+ стека (fastapi, scrapy, ...)
- 3 протокола (PROCESSES, PROMPTS, COMMANDS)
ИТОГО: 28+ сущностей
Вопрос: Нужны ли ВСЕ? Есть дублирование?
Из CLAUDE.md:
- ✅ Режимы (Оператор/Проектор/Архитектор) — используются в start.sh
- ✅ L1-L4 протокол — используется в SafeDialog
- ✅ Делегирование моделям — используется (Task tool)
Из system/agents/:
- ⚠️ Специалисты — НЕ УВЕРЕН (есть триггеры в CLAUDE.md, но используются ли?)
- ⚠️ Исполнители — НЕ УВЕРЕН
- ⚠️ Стеки — НЕ УВЕРЕН
УРОВЕНЬ 1 (CLAUDE.md): Быстрый доступ
- 3 режима для быстрого переключения
- Базовые правила (L1-L4)
- Триггеры для автоопределения
УРОВЕНЬ 2 (system/agents/): Детализация
- Подробные инструкции для сложных случаев
- Специализированные знания
- Используется когда нужна глубина
Режим (КТО)
↓
Специалист (ЧТО)
↓
Исполнитель (КАК)
↓
Стек (ЧЕМ)
Пример:
Проектор ◆ (режим)
→ business (магазин)
→ coder (код)
→ fastapi (технология)
Задача → выбираешь нужное:
- Режим (если простой контекст)
- Специалист (если нужна экспертиза)
- Исполнитель (если знаешь ЧТО, нужно только КАК)
- Стек (если работаешь с технологией)
Вариант А: Только режимы
start.sh → выбираю роль (Оператор/Проектор/Архитектор)
[работаем]
Всё, больше ничего не переключаю
Вариант Б: Режимы + подрежимы
start.sh → Проектор
[в сессии] "режим планирования"
[потом] "переходим к реализации"
Вариант В: Используешь специалистов
start.sh → Проектор
[в сессии] "вызови business специалиста для анализа магазина"
Вариант Г: Ничего явно не переключаешь
start.sh → Проектор
[просто работаешь, Claude сам определяет что нужно]
Удалить:
- system/agents/ (кроме protocols/)
- Специалистов, исполнителей, стеки
Оставить:
- CLAUDE.md с 3 режимами
- L1-L4 протокол
- Делегирование моделям
Результат: Простая система 3 режимов
Структура:
Режим (выбирается при старте)
↓
Подрежим (автоматически по триггерам)
↓
Специалист (автоматически по домену)
↓
Исполнитель (автоматически по типу работы)
Пользователь видит: Только режимы
Claude использует: Всю иерархию автоматически
Заменить 3 режима на роли:
Роли (выбор одной):
- Operator (инфра)
- Researcher (исследование)
- Planner (планирование)
- Coder (код)
- Architect (методология)
- Business (бизнес-анализ)
- Technical (IT-проект)
...
Проблема: Слишком много (10+ ролей)
ОСЬ 1: Контекст (ЧТО)
- @pirotehnika
- @platform
- @infra
ОСЬ 2: Режим работы (КАК)
- research (чтение)
- plan (планирование)
- code (реализация)
- ops (операции)
Использование:
@pirotehnika plan → планирование в проекте
@pirotehnika code → кодинг в проекте
@infra ops → операции с инфрой
Мне нужно от тебя:
После этого предложу КОНКРЕТНУЮ новую архитектуру с миграцией.
Файл: .claude/FULL_ROLES_AUDIT.md