Реестр системных изменений .claude/

Правило: Перед изменением любого файла в .claude/ — добавить запись сюда.

2026-03-25 — Починка хука SessionStart при resume

• Файл: /usr/local/bin/session (изменён)
• Что: Добавлен cd "$WORKSPACE" в начало скрипта перед любыми вызовами claude --resume
• Зачем: Без cd /opt/claude-workspace проект-уровневый .claude/settings.json не подхватывался → хук SessionStart не срабатывал → CLAUDE.md не инжектировался при resume
• Симптом: Инструкции CLAUDE.md применялись при start (новая сессия) но терялись при session --auto / session --choose (resume)
• Диагноз: start делал cd "$WORKSPACE", session — нет. Хук project-level требует правильного CWD
• Правило: Любой скрипт запускающий claude --resume ОБЯЗАН сначала cd /opt/claude-workspace
• Откат: Убрать строки WORKSPACE=... и cd "$WORKSPACE" из /usr/local/bin/session
• Стандарт: architect/standards/HOOKS_SESSION.md
• Автор: Claude (сессия a0c49727)

Формат:

## YYYY-MM-DD — Название изменения
- Файл: путь к файлу
- Что: что изменили
- Зачем: причина
- Откат: как вернуть назад
- Автор: Claude / человек

2026-03-07 — Context Stack механизм

• Файл: .claude/SESSION.md (новый)
• Файл: .claude/stack/.gitkeep (новая папка)
• Файл: CLAUDE.md — добавлен раздел "CONTEXT STACK"
• Что: Механизм сохранения контекста при смене темы. При резком уходе в сторону — I создаю файл паузы в .claude/stack/, обновляю SESSION.md. При возврате — читаю файл паузы и продолжаю.
• Откат: Удалить раздел из CLAUDE.md, удалить .claude/SESSION.md и .claude/stack/
• Автор: Claude (сессия c8f4a749)

2026-02-17 — SessionStart hook (session-setup.sh)

• Файл: .claude/hooks/session-setup.sh (новый)
• Файл: .claude/settings.json (изменён)
• Что: Добавили хук SessionStart — восстанавливает контекст после startup/resume/compact
• Содержимое хука: Читает /opt/claude-workspace/CLAUDE.md и инжектирует в additionalContext
• Зачем: После /compact Claude терял все инструкции из CLAUDE.md
• Токены: ~7,000 токенов (только root CLAUDE.md)
• Откат: Удалить hooks/session-setup.sh, убрать секцию hooks из settings.json
• Автор: Claude (сессия 3484400a)

2026-02-17 — Тестовый маркер в CLAUDE.md

• Файл: /opt/claude-workspace/CLAUDE.md (изменён)
• Что: Добавлена секция ## 🔴 SESSION HOOK TEST в начало файла
• Зачем: Проверка что хук реально читает CLAUDE.md после /compact
• Маркер: HOOK OK — Claude отвечает этим в начале сообщения если хук сработал
• Откат: Удалить секцию SESSION HOOK TEST из CLAUDE.md
• Автор: Claude (сессия 3484400a)

2026-02-17 — Упрощение hook (убраны MAP и PROJECT_CONTEXT)

• Файл: .claude/hooks/session-setup.sh (изменён)
• Что: Убраны секции MAP (карта CLAUDE.md файлов) и PROJECT_CONTEXT
• Зачем: Экономия токенов: с ~12,000 до ~7,000 токенов
• Откат: Восстановить предыдущую версию session-setup.sh из git
• Автор: Claude (сессия 3484400a)

2026-02-17 — РФ требования в CLAUDE.md

• Файл: CLAUDE.md (изменён)
• Что: Добавлена секция "ТРЕБОВАНИЯ РФ" — чеклист, приоритет выбора, стоп-список, разрешённые инструменты
• Зачем: Все решения должны быть применимы в РФ, без SaaS зависимостей
• Откат: git checkout HEAD~1 -- CLAUDE.md
• Автор: Claude (сессия 3484400a)

История из git (ретроспектива)

2026-02-14 — Полная ревизия платформы (be5ac1dc)

• Файлы: .claude/output-styles/ (новые), CLAUDE.md (расширен), .claude/KNOWN_ISSUES.md (новый)
• Что: Добавлены 5 output-styles: Architect.md, Coder.md, Default.md, SafeDialog.md, TestMarker.md
• Что: Добавлена документация стандартов CLAUDE_HIERARCHY.md, reference/
• Зачем: Централизация и стандартизация платформы
• Коммит: be5ac1dc

2026-01-09 — Time estimation override (f2399371)

• Файл: CLAUDE.md (+86 строк)
• Что: Добавлен раздел ПРАВИЛО ВРЕМЕНИ — формула AI ÷ 10, override system prompt
• Зачем: Claude давал неправильные оценки времени (человеческие, не AI)
• Коммит: f2399371

2025-12-24 — Output styles + форматы заголовков (bf9f32aa, f534ed62, 624cad5b, 3f64d136)

• Файл: CLAUDE.md (несколько правок)
• Что: Обновлён формат заголовков (дата|время|модель|роль|режим|задача)
• Что: Добавлены правила OpenRouter (предлагать при задачах >1MB)
• Что: Правило времени: <2 мин → делать сразу
• Файл: .claude/scripts/session_picker.sh (новый)
• Коммиты: bf9f32aa, f534ed62, 624cad5b, 3f64d136

2025-12-02 — Протокол взаимодействия v16.3.0 (06b57f82)

• Файл: CLAUDE.md (+53 строки)
• Что: Добавлена секция ПРОТОКОЛ ВЗАИМОДЕЙСТВИЯ — шаги 1-7
• Зачем: Формализация диалога оператор↔Claude
• Коммит: 06b57f82

2025-12-01 — Переписан CLAUDE.md v16.1.0 + v14.0.0 (e658cd98, fa8bdc85)

• Файл: CLAUDE.md (переписан)
• Что: v16.1.0 — новая концепция, правила общения
• Что: v14.0.0 — жёсткая инструкция стартового меню
• Коммиты: e658cd98, fa8bdc85

2025-11-10 — Система стартового меню (eb70cd41)

• Файл: CLAUDE.md (649 строк, полная реструктуризация)
• Что: Полная система меню и режимов работы
• Файл: platform/.claude/last-session.md (новый)
• Коммит: eb70cd41

Стандарты документирования

Что фиксировать

• Изменения в .claude/settings.json
• Изменения в .claude/hooks/
• Изменения в /root/.claude/ (глобальные настройки)
• Изменения в /opt/claude-workspace/CLAUDE.md (корневой)

Что НЕ фиксировать

• Обычные файлы проектов (для них есть git)
• Временные файлы

Хранение старых версий

Перед серьёзным изменением — копировать файл:

cp .claude/settings.json .claude/versions/YYYY-MM-DD_settings.json

Папка .claude/versions/ создаётся по необходимости.