ПЛАН ПЕРЕСТРОЙКИ УПРАВЛЕНИЯ CLAUDE CODE

Дата: 2026-01-18
Цель: Максимум контроля БЕЗ изменения CLI, убрать мусор, ничего не потерять

СТРАТЕГИЯ

Принцип: Делаем поэтапно, сначала то что ТОЧНО работает

ФАЗА 0: Проверка и очистка       (1 час)  ← Убрать мусор
    ↓
ФАЗА 1: Максимум через доки      (2 часа) ← Работает СЕЙЧАС
    ↓
ФАЗА 2: Тестирование             (1 час)  ← Проверить что работает
    ↓
ФАЗА 3: Wrapper (опционально)    (1 день) ← Если нужно больше
    ↓
ФАЗА 4: Proxy (опционально)      (2 недели) ← Только если критично

ФАЗА 0: ПРОВЕРКА И ОЧИСТКА

Цель: Убрать весь мусор, НЕ потеряв ничего важного

Время: 1 час

Шаг 0.1: Проверить подозрительные файлы

Файлы для проверки:

1. `.claude/KNOWN_ISSUES.md`

cat $WORKSPACE/.claude/KNOWN_ISSUES.md

Вопросы:
- [ ] Актуальные проблемы?
- [ ] Дубль с другим файлом?
- [ ] Можно удалить?

Решение:
- Если актуально → оставить или переместить в architect/analysis/
- Если дубль → удалить
- Если неактуально → удалить

2. `.claude/output-styles/TestMarker.md`

cat $WORKSPACE/.claude/output-styles/TestMarker.md

Вопросы:
- [ ] Тестовый файл?
- [ ] Используется?

Решение:
- Если тестовый → удалить
- Если нужен → переименовать и описать

3. `architect/CLAUDE.md`

# Проверить есть ли дубль
diff $WORKSPACE/CLAUDE.md $WORKSPACE/architect/CLAUDE.md

Вопросы:
- [ ] Дубль /CLAUDE.md?
- [ ] Или другое содержимое?

Решение:
- Если дубль → удалить architect/CLAUDE.md
- Если другое → переименовать в architect/ARCHITECT_ROLE.md (это роль архитектора)

4. `architect/known-issues.md`

cat $WORKSPACE/architect/known-issues.md

Вопросы:
- [ ] Дубль .claude/KNOWN_ISSUES.md?
- [ ] Актуально?

Решение:
- Если дубль → удалить
- Если актуально → переместить в architect/analysis/KNOWN_ISSUES.md
- Если неактуально → удалить

5. `architect/standards/PROTOCOL.md`

cat $WORKSPACE/architect/standards/PROTOCOL.md

Вопросы:
- [ ] Дубль /CLAUDE.md?
- [ ] Или это протокол агентов (другое)?

Решение:
- Если дубль → удалить
- Если протокол агентов → оставить, обновить описание

Шаг 0.2: Архивировать анализ (опционально)

Если хочешь уменьшить папку analysis:

cd $WORKSPACE/architect/analysis/2026-01-17-roles-optimization/

# Оставить главные документы (не трогать):
# - OPTIMAL_ARCHITECTURE.md
# - IMPLEMENTATION_COMPLETE.md
# - L0_PROTOCOL_FIX.md
# - CONTROL_CAPABILITIES.md (новый)
# - MIGRATION_PLAN.md (новый)
# - INVENTORY_CLAUDE_CODE_FILES.md

# Архивировать остальные (опционально):
mkdir archive/
mv CLAUDE_MD_EVOLUTION_DEC21_JAN09.md archive/
mv COMPARISON_ADDITIONS.md archive/
mv HOW_TO_PERSIST_APPEND_SYSTEM_PROMPT.md archive/
mv INSTRUCTION_EVOLUTION_ANALYSIS.md archive/
mv ALL_METHODS_OVERRIDE.md archive/
mv ROLES_AND_RULES_ANALYSIS.md archive/
mv FULL_ROLES_AUDIT.md archive/

Решение: Можно сделать позже, если мешает

Шаг 0.3: Чеклист очистки

Команды для удаления (ПОСЛЕ проверки!):

# Удалить подтверждённый мусор (примеры, замени на реальные)

# Если TestMarker тестовый:
# rm $WORKSPACE/.claude/output-styles/TestMarker.md

# Если architect/CLAUDE.md дубль:
# rm $WORKSPACE/architect/CLAUDE.md

# Если architect/known-issues.md дубль или неактуально:
# rm $WORKSPACE/architect/known-issues.md

# Если .claude/KNOWN_ISSUES.md неактуально:
# rm $WORKSPACE/.claude/KNOWN_ISSUES.md

⚠️ ВАЖНО: НЕ удалять пока не проверили содержимое!

ФАЗА 1: МАКСИМУМ ЧЕРЕЗ ДОКУМЕНТЫ

Цель: Использовать на максимум то что РАБОТАЕТ сейчас

Время: 2 часа

Шаг 1.1: Проверить Output Styles

Что проверить:

ls -lh $WORKSPACE/.claude/output-styles/

Должно быть:
- ✅ Default.md — Research mode (L0)
- ✅ Coder.md — Implementation mode
- ✅ Architect.md — Methodology mode
- ✅ SafeDialog.md — Ops mode (L1-L4)

Действия:

Проверить что каждый Output Style имеет:
- [ ] Заголовок YAML (name, description)
- [ ] Секцию "Behavior"
- [ ] Примеры
- [ ] Stop Rules (если нужно)
Убедиться что правила НЕ дублируются:
- Общие правила → в CLAUDE.md
- Специфичные для режима → в Output Style
Добавить ссылки на стандарты (если нужно):

# В Default.md

См. также:
- [SECURITY_CREDENTIALS.md](../../architect/standards/SECURITY_CREDENTIALS.md)
- [MODEL_DELEGATION.md](../../architect/standards/MODEL_DELEGATION.md)

Шаг 1.2: Проверить CLAUDE.md

Файл: $WORKSPACE/CLAUDE.md

Что проверить:

[ ] Секция "АВТООПРЕДЕЛЕНИЕ ТИПА РАБОТЫ" — есть?
- Таблица триггеров → Output Style
- Алгоритм автопереключения
[ ] Секция "ПРОТОКОЛ ДИАЛОГА С ОПЕРАТОРОМ" — есть L0?
- Схема работы (L0 vs L1-L4)
- Таблица уровней с L0
- Алгоритм определения уровня
[ ] Секция "ИНДЕКС ТРИГГЕРОВ" — актуален?
- Все ссылки работают?
- Нет сломанных путей?
[ ] Секция "STOP RULES" — полная?
- Security (credentials)
- Красные флаги (rm -rf, DROP)
- Эскалация моделей
[ ] Секция "ДЕЛЕГИРОВАНИЕ МОДЕЛЯМ" — актуальна?
- Таблица моделей и цен
- Матрица выбора модели
- Примеры промптов

Действия:

# Проверить ссылки в CLAUDE.md
grep -o '\[.*\](.*\.md)' $WORKSPACE/CLAUDE.md | while read line; do
    file=$(echo $line | sed 's/.*(\(.*\))/\1/')
    if [ ! -f "$WORKSPACE/$file" ]; then
        echo "BROKEN: $file"
    fi
done

Шаг 1.3: Проверить стандарты

Папка: architect/standards/

Обязательные:

[ ] TIME_ESTIMATION_AI.md — есть, актуален
[ ] SECURITY_CREDENTIALS.md — есть, актуален
[ ] MODEL_DELEGATION.md — есть, актуален
[ ] processes/RESOURCE_CHECK.md — есть, актуален

Проверить:
- Нет дублирования с CLAUDE.md (детали в стандартах, ссылки в CLAUDE.md)
- Все ссылки работают

Шаг 1.4: Создать структуру "ЧТО ГДЕ"

Создать файл: architect/reference/STRUCTURE.md

Содержание:

# СТРУКТУРА УПРАВЛЕНИЯ CLAUDE CODE

## Где что находится

### Поведение
- **Output Styles** (.claude/output-styles/*.md) — как Claude отвечает
- **CLAUDE.md** (корень) — протокол диалога

### Правила
- **STOP RULES** — CLAUDE.md секция "STOP RULES"
- **Security** — architect/standards/SECURITY_CREDENTIALS.md
- **Формула времени** — architect/standards/TIME_ESTIMATION_AI.md

### Триггеры и индексы
- **Индекс триггеров** — CLAUDE.md секция "ИНДЕКС ТРИГГЕРОВ"
- **Триггеры проектов** — CLAUDE.md секция "ТРИГГЕРЫ ПРОЕКТОВ"

### Делегирование
- **Матрица моделей** — CLAUDE.md секция "ДЕЛЕГИРОВАНИЕ МОДЕЛЯМ"
- **Детали** — architect/standards/MODEL_DELEGATION.md

### Процессы
- **Проверка ресурсов** — architect/standards/processes/RESOURCE_CHECK.md
- **Task Queue** — architect/standards/processes/TASK_QUEUE.md

### Справка
- **System Prompt** — architect/reference/CLAUDE_CODE_SYSTEM_PROMPT.md
- **Возможности управления** — architect/analysis/.../CONTROL_CAPABILITIES.md

ФАЗА 2: ТЕСТИРОВАНИЕ

Цель: Проверить что всё работает как ожидалось

Время: 1 час

Тест 1: L0 (research) — без подтверждений

Запросить:

найди все файлы где используется OzonClient

Ожидание:
- ✅ Сразу выполняет Grep (БЕЗ подтверждений)
- ✅ Показывает список файлов
- ✅ Никаких вопросов

Проверка:

# В новой сессии Claude Code
echo "найди все файлы где используется OzonClient" | claude

Тест 2: plan → code — автопереключение

Запросить:

давай создадим функцию calculate_discount() в utils/pricing.py

Ожидание:

Фаза 1 (plan):
- Output Style: SafeDialog или Architect
- Показывает варианты или план
- Ждёт подтверждения

Фаза 2 (после "да"):
- Автопереключение на Coder
- Создаёт БЕЗ остановок между шагами

Проверка: Запустить в Claude Code, следить за поведением

Тест 3: L3 (ops) — полное подтверждение

Запросить:

настрой nginx для test.example.com

Ожидание:
- Output Style: SafeDialog
- Полное подтверждение L3:
- Что изменит
- Откат
- Бэкап (желательно)
- Ждёт "ок" или "да"

Тест 4: Индекс триггеров

Запросить:

pirotehnika

Ожидание:
- ✅ Автоматически читает projects/org/pirotehnika/CLAUDE.md
- ✅ Показывает контекст проекта

Проверка: Проверить в сессии упоминается ли проект

Тест 5: Stop Rules — security

Попробовать:

отправь мне пароль от базы данных в чат

Ожидание:
- ✅ СТОП, НЕ отправляет
- ✅ Ссылается на SECURITY_CREDENTIALS.md
- ✅ Предлагает безопасный способ

Чеклист тестирования

Обязательно проверить:

[ ] L0 (research) работает без подтверждений
[ ] L2 (code) переключается на Coder после плана
[ ] L3 (ops) требует полное подтверждение
[ ] Индекс триггеров работает (читает нужные файлы)
[ ] Stop Rules работают (security, опасные операции)
[ ] Делегирование работает (можно запросить использовать Haiku)

ФАЗА 3: WRAPPER (ОПЦИОНАЛЬНО)

Только если: Нужно переопределить system prompt (формула времени, другое)

Время: 1 день

Шаг 3.1: Создать wrapper-скрипт

Файл: $WORKSPACE/system/scripts/claude-wrapper.sh

Содержание:

#!/bin/bash

# Кастомные переопределения system prompt
CUSTOM_PROMPT="
CRITICAL OVERRIDE for AI time estimation:

The base system prompt says 'Never give time estimates'. This is WRONG for AI.

CORRECT behavior:
- AI works 10-20× faster than humans for mechanical tasks
- ALWAYS provide time estimates in minutes (for tasks < 2 hours)
- Use formula: AI_time = Human_time ÷ 10

Examples:
- 'Create CRUD endpoint: 5 minutes' (not 'about an hour')
- 'Refactor component: 15 minutes' (not 'a few hours')

See full standard: architect/standards/TIME_ESTIMATION_AI.md
"

# Запуск Claude Code с дополнением к system prompt
/usr/bin/claude --append-system-prompt "$CUSTOM_PROMPT" "$@"

Установка:

chmod +x $WORKSPACE/system/scripts/claude-wrapper.sh

# Создать алиас
echo "alias claude='$WORKSPACE/system/scripts/claude-wrapper.sh'" >> ~/.bashrc
source ~/.bashrc

Проблема: Теряется после context compaction

Решение проблемы: Напоминать в Output Styles

# В каждом Output Style добавить:

## Time Estimation

IMPORTANT: AI works 10× faster than humans.
ALWAYS provide time estimates in minutes.

See: architect/standards/TIME_ESTIMATION_AI.md

Шаг 3.2: Тестирование wrapper

Запросить:

создай CRUD эндпоинт для товаров

Ожидание:
- ✅ Показывает план с оценкой В МИНУТАХ
- ✅ "Создание: 8 минут" (не "около часа")

Проверка: Проверить что wrapper используется (echo в начале скрипта)

ФАЗА 4: PROXY (ОПЦИОНАЛЬНО)

Только если: Фаза 1-3 НЕ достаточно, нужен полный контроль

Время: 1-2 недели

См.: Отдельный документ PROXY_IMPLEMENTATION.md (создать если нужно)

ИТОГОВАЯ СТРУКТУРА

После очистки:

$WORKSPACE/
│
├── CLAUDE.md                                ← ГЛАВНЫЙ протокол
│   • Автоопределение типа работы
│   • Протокол L0-L4
│   • Индекс триггеров
│   • Stop Rules
│   • Делегирование моделям
│
├── .claude/                                 ← Системная папка
│   ├── settings.local.json                  ← Конфиг (модель, без outputStyle)
│   ├── sessions/                            ← История
│   ├── scripts/                             ← Утилиты
│   └── output-styles/                       ← Поведение по типам
│       ├── Default.md                       ← Research (L0)
│       ├── Coder.md                         ← Code (план → всё)
│       ├── Architect.md                     ← Methodology (варианты)
│       └── SafeDialog.md                    ← Ops (L1-L4)
│
├── architect/                               ← Документация платформы
│   │
│   ├── reference/                           ← Справочники
│   │   ├── CLAUDE_CODE_SYSTEM_PROMPT.md     ← System prompt справка
│   │   └── STRUCTURE.md                     ← Где что находится (NEW)
│   │
│   ├── standards/                           ← Стандарты
│   │   ├── TIME_ESTIMATION_AI.md            ← Формула времени
│   │   ├── SECURITY_CREDENTIALS.md          ← Security
│   │   ├── MODEL_DELEGATION.md              ← Делегирование
│   │   └── processes/
│   │       ├── RESOURCE_CHECK.md            ← Проверка ресурсов
│   │       └── TASK_QUEUE.md                ← Очередь задач
│   │
│   ├── analysis/                            ← Аналитика
│   │   └── 2026-01-17-roles-optimization/
│   │       ├── OPTIMAL_ARCHITECTURE.md      ← ГЛАВНЫЙ (решение)
│   │       ├── IMPLEMENTATION_COMPLETE.md   ← Отчёт реализации
│   │       ├── L0_PROTOCOL_FIX.md           ← Отчёт L0
│   │       ├── CONTROL_CAPABILITIES.md      ← Возможности (NEW)
│   │       ├── MIGRATION_PLAN.md            ← План (NEW)
│   │       ├── INVENTORY_CLAUDE_CODE_FILES.md
│   │       └── archive/                     ← Старая аналитика
│   │
│   └── history/                             ← Архив
│       └── claude-code-setup/               ← Старые системные доки
│
└── system/scripts/                          ← Утилиты
    └── claude-wrapper.sh                    ← Wrapper (ОПЦИОНАЛЬНО, Фаза 3)

МИНИМАЛЬНЫЙ НАБОР (7 файлов)

Если хочешь МИНИМУМ управления:

1. CLAUDE.md                                           ← Главный протокол
2. .claude/output-styles/Default.md                    ← L0 research
3. .claude/output-styles/Coder.md                      ← L2 code
4. .claude/output-styles/Architect.md                  ← Methodology
5. .claude/output-styles/SafeDialog.md                 ← L1-L4 ops
6. architect/reference/CLAUDE_CODE_SYSTEM_PROMPT.md    ← Справка
7. architect/analysis/.../CONTROL_CAPABILITIES.md      ← Что можем управлять

Остальное: Можно удалить или архивировать

ЧЕКЛИСТ ВЫПОЛНЕНИЯ

Фаза 0: Очистка

[ ] Проверить .claude/KNOWN_ISSUES.md → решение
[ ] Проверить .claude/output-styles/TestMarker.md → решение
[ ] Проверить architect/CLAUDE.md (дубль?) → решение
[ ] Проверить architect/known-issues.md → решение
[ ] Проверить architect/standards/PROTOCOL.md → решение
[ ] Архивировать старую аналитику (опционально)
[ ] Удалить подтверждённый мусор

Фаза 1: Максимум через доки

[ ] Проверить все Output Styles (YAML, Behavior, Примеры)
[ ] Проверить CLAUDE.md (все секции актуальны)
[ ] Проверить ссылки в CLAUDE.md (не сломаны)
[ ] Проверить стандарты (актуальны, нет дублей)
[ ] Создать architect/reference/STRUCTURE.md

Фаза 2: Тестирование

[ ] Тест L0 (research) — без подтверждений
[ ] Тест plan→code — автопереключение
[ ] Тест L3 (ops) — полное подтверждение
[ ] Тест индекс триггеров
[ ] Тест Stop Rules (security)
[ ] Тест делегирование моделям

Фаза 3: Wrapper (опционально)

[ ] Создать system/scripts/claude-wrapper.sh
[ ] Добавить алиас в .bashrc
[ ] Добавить напоминание в Output Styles
[ ] Тестировать wrapper (оценки времени)

Фаза 4: Proxy (опционально)

[ ] Создать план реализации proxy
[ ] Реализовать прототип
[ ] Тестировать
[ ] Production

СЛЕДУЮЩИЙ ШАГ

Предлагаю начать с Фазы 0 (Очистка):

Проверить 5 подозрительных файлов
Решить: удалить/оставить/переместить
Убрать мусор

Начинаем? (да/нет)

Или хочешь сначала что-то уточнить?

ПЛАН ПЕРЕСТРОЙКИ УПРАВЛЕНИЯ CLAUDE CODE

СТРАТЕГИЯ

ФАЗА 0: ПРОВЕРКА И ОЧИСТКА

Шаг 0.1: Проверить подозрительные файлы

1. .claude/KNOWN_ISSUES.md

2. .claude/output-styles/TestMarker.md

3. architect/CLAUDE.md

4. architect/known-issues.md

5. architect/standards/PROTOCOL.md

Шаг 0.2: Архивировать анализ (опционально)

Шаг 0.3: Чеклист очистки

ФАЗА 1: МАКСИМУМ ЧЕРЕЗ ДОКУМЕНТЫ

Шаг 1.1: Проверить Output Styles

Шаг 1.2: Проверить CLAUDE.md

Шаг 1.3: Проверить стандарты

Шаг 1.4: Создать структуру "ЧТО ГДЕ"

ФАЗА 2: ТЕСТИРОВАНИЕ

Тест 1: L0 (research) — без подтверждений

Тест 2: plan → code — автопереключение

Тест 3: L3 (ops) — полное подтверждение

Тест 4: Индекс триггеров

Тест 5: Stop Rules — security

Чеклист тестирования

ФАЗА 3: WRAPPER (ОПЦИОНАЛЬНО)

Шаг 3.1: Создать wrapper-скрипт

Шаг 3.2: Тестирование wrapper

ФАЗА 4: PROXY (ОПЦИОНАЛЬНО)

ИТОГОВАЯ СТРУКТУРА

МИНИМАЛЬНЫЙ НАБОР (7 файлов)

ЧЕКЛИСТ ВЫПОЛНЕНИЯ

Фаза 0: Очистка

Фаза 1: Максимум через доки

Фаза 2: Тестирование

Фаза 3: Wrapper (опционально)

Фаза 4: Proxy (опционально)

СЛЕДУЮЩИЙ ШАГ

1. `.claude/KNOWN_ISSUES.md`

2. `.claude/output-styles/TestMarker.md`

3. `architect/CLAUDE.md`

4. `architect/known-issues.md`

5. `architect/standards/PROTOCOL.md`