ИССЛЕДОВАНИЕ: Конфликт Инструкций Claude Code

Дата: 2026-02-19
Проблема: Claude игнорирует инструкции из CLAUDE.md и следует базовым инструкциям Anthropic
Статус: ✅ Исследование завершено

EXECUTIVE SUMMARY

Корневая причина: Output Styles с keep-coding-instructions: true ДОБАВЛЯЮТ базовые инструкции Claude Code к кастомным инструкциям, создавая КОНФЛИКТ между противоречащими правилами.

Механизм конфликта:

SafeDialog.md (L1-L4 протокол) → "показывай план, жди подтверждения"
     +
Base Claude Code instructions → "NEVER create files unless absolutely necessary"
     =
РЕЗУЛЬТАТ: Claude создаёт файлы БЕЗ подтверждения (базовые инструкции побеждают)

Решение: Изменить keep-coding-instructions: true → false в Output Styles ИЛИ полностью переписать Output Styles с явным переопределением.

1. УСТРОЙСТВО CLAUDE CODE

1.1. Архитектура System Prompt

Claude Code CLI использует многоуровневую систему инструкций:

┌─────────────────────────────────────────────────────────────┐
│ LAYER 1: Base System Prompt (Anthropic, встроенный)        │
│ ─────────────────────────────────────────────────────────── │
│ • Tone and Style                                            │
│ • Professional Objectivity                                  │
│ • ❌ "Never give time estimates" (no time estimates)        │
│ • ❌ "NEVER create files unless absolutely necessary"       │
│ • Task Management (TodoWrite)                               │
│ • Doing Tasks (avoid over-engineering)                      │
│ • Git Safety Protocol                                       │
└─────────────────────────────────────────────────────────────┘
         ↓ (при запуске с флагом)
┌─────────────────────────────────────────────────────────────┐
│ LAYER 2: --append-system-prompt (опционально, CLI)         │
│ ─────────────────────────────────────────────────────────── │
│ Добавляется В КОНЕЦ system prompt при старте               │
│ ⚠️ ТЕРЯЕТСЯ после /compact                                  │
└─────────────────────────────────────────────────────────────┘
         ↓ (если активирован output-style)
┌─────────────────────────────────────────────────────────────┐
│ LAYER 3: Output Styles (.claude/output-styles/*.md)        │
│ ─────────────────────────────────────────────────────────── │
│ ЕСЛИ keep-coding-instructions: true                         │
│   → ДОБАВЛЯЕТ свои инструкции К базовым                    │
│ ЕСЛИ keep-coding-instructions: false                        │
│   → ЗАМЕНЯЕТ базовые инструкции своими                     │
│ ✅ ПЕРЕЖИВАЕТ /compact                                      │
│ ✅ Можно менять в сессии: /output-style Name                │
└─────────────────────────────────────────────────────────────┘
         ↓
┌─────────────────────────────────────────────────────────────┐
│ LAYER 4: Session Hook (SessionStart)                       │
│ ─────────────────────────────────────────────────────────── │
│ Файл: .claude/hooks/session-setup.sh                       │
│ Триггеры: startup, resume, post-compact                     │
│ Добавляет: additionalContext (НЕ system prompt)             │
│ Содержимое: /opt/claude-workspace/CLAUDE.md                 │
│ ✅ ПЕРЕЖИВАЕТ /compact (перезапускается)                    │
└─────────────────────────────────────────────────────────────┘
         ↓
┌─────────────────────────────────────────────────────────────┐
│ LAYER 5: Context Reminder (claudeMd, низкий приоритет)     │
│ ─────────────────────────────────────────────────────────── │
│ CLAUDE.md загружается автоматически в контекст             │
│ ❌ СЖИМАЕТСЯ при /compact (низкий приоритет)                │
│ Используется как справочный материал                        │
└─────────────────────────────────────────────────────────────┘

1.2. Приоритет инструкций

Порядок от высшего к низшему:

1.3. Ключевая находка: keep-coding-instructions

Файл: .claude/output-styles/SafeDialog.md (строка 4)

---
name: Safe Dialog Protocol
description: Протокол диалога с подтверждениями для операций L1-L4
keep-coding-instructions: true  # ← ВОТ ОНО!
---

Что делает этот флаг:

• true → Output Style ДОБАВЛЯЕТСЯ к базовым инструкциям Claude Code
• false → Output Style ЗАМЕНЯЕТ базовые инструкции Claude Code

Все файлы в .claude/output-styles/ имеют keep-coding-instructions: true:

$ grep "keep-coding-instructions" .claude/output-styles/*
SafeDialog.md:keep-coding-instructions: true
Architect.md:keep-coding-instructions: true
Default.md:keep-coding-instructions: true
TestMarker.md:keep-coding-instructions: true
Coder.md:keep-coding-instructions: true

2. ТЕКУЩЕЕ СОСТОЯНИЕ

2.1. Что есть в workspace

Конфигурация

Output Styles (все с keep-coding-instructions: true)

Документация

2.2. Что пробовали (из истории git)

Commit f2399371 (2026-01-09): "feat(architect): Add system-wide time estimation override"
- Добавлен раздел в CLAUDE.md: "ПРАВИЛО ВРЕМЕНИ — OVERRIDE system prompt"
- Результат: НЕ сработало (CLAUDE.md = низкий приоритет)

Commit 2ffaef93 (дата неизвестна): "feat(claude): add base protocol for all roles except Coder"
- Добавлен базовый протокол
- Результат: Частично работает

Commit dc173c92: "feat(claude): add signal types, coder protocol, and meta-roles"
- Добавлен Coder протокол
- Результат: Конфликтует с базовыми инструкциями

2026-02-17: Создан SessionStart hook (session-setup.sh)
- Восстанавливает CLAUDE.md после compact
- Результат: Работает как context reminder, но НЕ переопределяет system prompt

2.3. Текущая конфигурация permissions

Файл: .claude/settings.local.json

{
  "permissions": {
    "allow": [
      // Строки 314-321: ПОЛНОЕ АВТОПОДТВЕРЖДЕНИЕ (2025-11-14)
      "Bash",
      "Read",
      "Grep",
      "Glob",
      "Edit",
      "Write",
      "NotebookEdit",
      "Task"
    ],
    "deny": [
      // Только критические системные файлы
      "Write(/etc/passwd*)",
      "Write(/etc/shadow*)",
      "Write(/etc/sudoers*)",
      "Write(/boot/**)"
    ],
    "ask": []
  }
}

Анализ: Permissions полностью открыты → Claude может делать ЧТО УГОДНО без спроса.

Но: Это permissions уровень CLI (разрешение на вызов инструментов), а НЕ protocol уровень (поведение агента).

3. КОРНЕВАЯ ПРИЧИНА

3.1. Механизм конфликта

Проблема в keep-coding-instructions: true:

Базовые инструкции Claude Code (Layer 1):
  "NEVER create files unless they're absolutely necessary for achieving your goal.
   ALWAYS prefer editing an existing file to creating a new one."

SafeDialog.md (Layer 3, keep-coding-instructions: true):
  "ПРОТОКОЛ ДИАЛОГА: перед выполнением L1-L4 операций показывать план и ждать подтверждения"

РЕЗУЛЬТАТ (Claude получает ОБЕ инструкции одновременно):
  ✅ Base: "NEVER create files unless absolutely necessary"
  ✅ SafeDialog: "показывай план перед L1-L4"

Claude интерпретирует это как:
  "Я НЕ ДОЛЖЕН создавать файлы без крайней необходимости (базовая инструкция сильнее),
   НО если уж создаю — показываю план (SafeDialog)"

ИТОГ: Создаёт файлы БЕЗ подтверждения, т.к. базовая инструкция "NEVER create"
      ВАЖНЕЕ чем протокол подтверждения.

3.2. Почему базовые инструкции побеждают

Приоритет при конфликте:

1. Base System Prompt (Layer 1) — встроен в Claude Code, основа поведения
2. Output Styles (Layer 3) — добавляет ДОПОЛНИТЕЛЬНЫЕ инструкции

При keep-coding-instructions: true:
- Output Style воспринимается как уточнение, а не замена
- При конфликте Claude следует более общей инструкции (базовой)
- Базовая инструкция "NEVER create files" сильнее чем "показывай план"

3.3. Формулировки в CLAUDE.md

Текущая формулировка в CLAUDE.md (строки 6-10):

## ⚠️ SYSTEM INSTRUCTIONS OVERRIDE

**КРИТИЧНО:** Следующая инструкция из базового system prompt **НЕ ПРИМЕНЯЕТСЯ**:

> ❌ "provide concrete implementation steps without time estimates"
> ❌ "Never suggest timelines"

Проблема формулировки:
- ❌ Слово "OVERRIDE" не является командой для Claude
- ❌ "НЕ ПРИМЕНЯЕТСЯ" — декларация, а не инструкция
- ❌ CLAUDE.md = context reminder (низкий приоритет)
- ✅ Правильная формулировка была бы в system prompt, но там её нет

3.4. Где формулировки слабые

Слабые места в текущих инструкциях:

Почему слабые:
1. Используют context reminder (CLAUDE.md) вместо system prompt
2. keep-coding-instructions: true → добавляют вместо замены
3. Нет явного переопределения конкретных базовых правил

4. ВАРИАНТЫ РЕШЕНИЯ

🥇 ВАРИАНТ 1: Изменить keep-coding-instructions: false (РЕКОМЕНДУЕТСЯ)

Суть: Заменить базовые инструкции вместо добавления к ним.

Изменения:

# Файлы для изменения:
.claude/output-styles/SafeDialog.md
.claude/output-styles/Coder.md
.claude/output-styles/Architect.md

# Изменение (строка 4):
-keep-coding-instructions: true
+keep-coding-instructions: false

Плюсы:
- ✅ Минимальные изменения (1 строка в 3 файлах)
- ✅ Полностью переопределяет базовые инструкции
- ✅ Решает проблему конфликта
- ✅ Не требует переписывания Output Styles

Минусы:
- ⚠️ Теряем ПОЛЕЗНЫЕ базовые инструкции:
- "Use specialized tools instead of bash" (Read вместо cat)
- "Professional objectivity" (без эмоций)
- Git Safety Protocol (NEVER amend, force push)
- Code references (file:line format)
- ⚠️ Нужно вручную включить полезные части в каждый Output Style

Оценка: 9/10 — ЛУЧШЕЕ решение, если переписать Output Styles с включением полезных частей базовых инструкций.

Время: 2 часа (переписать 3 Output Styles с сохранением полезного)

🥈 ВАРИАНТ 2: Переписать Output Styles с явным переопределением

Суть: Добавить в Output Styles явные секции "OVERRIDE BASE INSTRUCTIONS".

Пример для SafeDialog.md:

---
name: Safe Dialog Protocol
description: Протокол диалога с подтверждениями для операций L1-L4
keep-coding-instructions: true
---

# Safe Dialog Protocol

## ⚠️ OVERRIDES (КРИТИЧНО — СЛЕДУЙ ЭТОМУ ВМЕСТО БАЗОВЫХ ИНСТРУКЦИЙ)

### Override: "NEVER create files unless absolutely necessary"
**Базовая инструкция:** "NEVER create files unless absolutely necessary"
**НОВАЯ ИНСТРУКЦИЯ (СЛЕДУЙ ЭТОЙ):**
- ВСЕГДА показывай план перед созданием файлов (L1-L4 протокол)
- Жди явное подтверждение "да" / "ок"
- ТОЛЬКО ПОСЛЕ подтверждения создавай файлы
- Базовая инструкция "NEVER create" НЕ ПРИМЕНЯЕТСЯ

### Override: "Never give time estimates"
**Базовая инструкция:** "Never give time estimates"
**НОВАЯ ИНСТРУКЦИЯ (СЛЕДУЙ ЭТОЙ):**
- ВСЕГДА указывать КОНКРЕТНОЕ время в минутах/часах
- AI работает в 10-20× быстрее человека
- Формула: AI_time = Human_time ÷ 10
- Базовая инструкция "Never give time estimates" НЕ ПРИМЕНЯЕТСЯ

## ПРОТОКОЛ ДИАЛОГА
[остальное без изменений...]

Плюсы:
- ✅ Явно переопределяет конкретные базовые инструкции
- ✅ Сохраняет keep-coding-instructions: true (полезные базовые инструкции остаются)
- ✅ Чётко указывает "НЕ ПРИМЕНЯЕТСЯ"
- ✅ Можно постепенно добавлять переопределения

Минусы:
- ⚠️ Многословно (дублирование)
- ⚠️ Не гарантирует 100% работу (зависит от интерпретации Claude)
- ⚠️ При конфликте всё равно может выиграть базовая инструкция

Оценка: 6/10 — костыль, но может сработать.

Время: 1 час (добавить секции OVERRIDE в 3 файла)

🥉 ВАРИАНТ 3: Использовать --append-system-prompt при старте

Суть: Загружать переопределения через CLI флаг.

Файл: .claude/ACTIVATE_INSTRUCTIONS.txt

⚠️ CRITICAL OVERRIDES (FOLLOW THESE INSTEAD OF BASE INSTRUCTIONS)

1. OVERRIDE "Never give time estimates":
   → ALWAYS provide concrete time estimates in minutes/hours
   → AI × 10 faster than human
   → Formula: AI_time = Human_time ÷ 10

2. OVERRIDE "NEVER create files unless absolutely necessary":
   → ALWAYS show plan before L1-L4 operations
   → Wait for explicit confirmation ("да" / "ок")
   → ONLY create files AFTER confirmation

3. L1-L4 PROTOCOL:
   → L1 (docs): short confirmation
   → L2 (code): full confirmation + rollback
   → L3 (server): full confirmation + rollback + backup
   → L4 (dangerous): STOP + explicit "да" + mandatory backup

Использование:

claude --append-system-prompt "$(cat .claude/ACTIVATE_INSTRUCTIONS.txt)" "режим архитектор"

Плюсы:
- ✅ System prompt уровень (высокий приоритет)
- ✅ Работает при старте
- ✅ Не ломает Output Styles

Минусы:
- ❌ Теряется после /compact
- ❌ Нельзя активировать внутри сессии
- ❌ Не гарантирует 100% приоритет (добавляется В КОНЕЦ system prompt)

Оценка: 5/10 — работает до первого compact.

Время: 30 минут (создать файл + модифицировать start.sh)

ВАРИАНТ 4: SessionStart hook с system prompt injection (НЕ РАБОТАЕТ)

Суть: Использовать hook для добавления в system prompt.

Проблема: Hooks добавляют в additionalContext, а НЕ в system prompt.

Файл: .claude/hooks/session-setup.sh (текущий)

jq -n --arg ctx "$CONTEXT" '{
    hookSpecificOutput: {
        hookEventName: "SessionStart",
        additionalContext: $ctx  # ← это КОНТЕКСТ, не system prompt!
    }
}'

Минусы:
- ❌ additionalContext = низкий приоритет (как CLAUDE.md)
- ❌ НЕТ способа инжектить в system prompt через hooks
- ❌ Документация Claude Code не предоставляет такой возможности

Оценка: 0/10 — технически невозможно.

ВАРИАНТ 5: Упростить CLAUDE.md + усилить формулировки

Суть: Переписать CLAUDE.md с более сильными формулировками.

Изменения:

## ⚠️ CRITICAL: YOU MUST OVERRIDE BASE INSTRUCTIONS

**IMPORTANT:** The following base Claude Code instructions DO NOT APPLY in this workspace:

1. ❌ DISABLED: "Never give time estimates"
   ✅ ENABLED: ALWAYS provide time estimates (AI × 10 formula)

2. ❌ DISABLED: "NEVER create files unless absolutely necessary"
   ✅ ENABLED: ALWAYS show plan + wait for confirmation (L1-L4 protocol)

**YOU MUST FOLLOW THESE NEW INSTRUCTIONS INSTEAD OF BASE INSTRUCTIONS.**

Плюсы:
- ✅ Усиливает формулировки
- ✅ Явно указывает "DO NOT APPLY"
- ✅ Не требует изменений в Output Styles

Минусы:
- ❌ CLAUDE.md = низкий приоритет (context reminder)
- ❌ НЕ гарантирует работу при конфликте
- ❌ Сжимается при compact

Оценка: 3/10 — слабое решение, может НЕ сработать.

Время: 15 минут

ВАРИАНТ 6: Использовать Anthropic SDK вместо CLI

Суть: Написать wrapper на Python с полным контролем system prompt.

Файл: system/cli/claude-persistent.py (уже создан в workspace)

Код:

import anthropic

client = anthropic.Anthropic()

system_prompt = """
YOU ARE Claude Code in ARCHITECT MODE.

⚠️ CRITICAL OVERRIDES:
1. IGNORE "Never give time estimates" → ALWAYS provide time (AI × 10)
2. IGNORE "NEVER create files" → ALWAYS show plan + wait for confirmation

L1-L4 PROTOCOL:
[полный протокол...]
"""

runner = client.beta.messages.tool_runner(
    model="claude-sonnet-4-5",
    system=system_prompt,
    max_tokens=4096,
    messages=[...],
    tools=[...],
    compaction_control={
        "enabled": True,
        "summary_prompt": "Preserve L1-L4 protocol, time rules..."
    }
)

Плюсы:
- ✅ ПОЛНЫЙ контроль над system prompt
- ✅ compaction_control сохраняет инструкции
- ✅ НЕ зависит от Claude Code CLI
- ✅ Работает как надо

Минусы:
- ⚠️ Требует переписать интерфейс (нет автоматических инструментов Read/Edit/Write)
- ⚠️ Нужно вручную реализовать все инструменты
- ⚠️ Теряем удобство Claude Code CLI

Оценка: 8/10 — РАБОТАЕТ, но трудозатратно.

Время: 8 часов (полная реализация wrapper + tools)

ВАРИАНТ 7: Гибридное решение (CLI + SDK для критических сессий)

Суть: Использовать CLI для обычной работы, SDK для критических сессий.

Структура:

# Обычная работа (быстро, но с конфликтами)
claude "режим проектор"

# Критическая работа (медленно, но надёжно)
claude-persistent.py "режим архитектор"

Плюсы:
- ✅ Баланс между удобством и надёжностью
- ✅ Можно выбирать инструмент под задачу
- ✅ CLI для простых задач, SDK для важных

Минусы:
- ⚠️ Два разных интерфейса
- ⚠️ Нужно помнить когда что использовать

Оценка: 7/10 — практичное решение.

Время: 4 часа (доработать wrapper)

5. РЕКОМЕНДАЦИЯ

Лучший вариант: ВАРИАНТ 1 (keep-coding-instructions: false)

Что делать:

1. Изменить флаг в 3 файлах:
   bash # SafeDialog.md, Coder.md, Architect.md keep-coding-instructions: false

2. Переписать Output Styles с включением полезных частей:
   - Professional objectivity (без эмоций)
   - Git Safety Protocol (NEVER amend, NEVER force push)
   - Tool usage policy (Read вместо cat, Edit вместо sed)
   - Code references (file:line формат)

3. Добавить явные секции OVERRIDE:
   ```markdown
   ## ⚠️ OVERRIDES (these rules REPLACE base instructions)

4. Time estimates: ALWAYS provide (AI × 10)

5. File creation: ALWAYS show plan + wait confirmation

6. L1-L4 protocol: [полный протокол]
   ```

7. Тестировать:
   - Запустить /output-style SafeDialog
   - Попросить создать файл
   - Проверить: показал план? ждал подтверждение?

Оценка времени: 2 часа

Ожидаемый результат: Claude следует L1-L4 протоколу вместо базовых инструкций.

Альтернатива: ВАРИАНТ 6 (Anthropic SDK wrapper)

Если вариант 1 НЕ сработает:

1. Доработать system/cli/claude-persistent.py
2. Реализовать все инструменты (Read, Edit, Write, Bash, Grep, Glob)
3. Добавить compaction_control с custom summary_prompt
4. Использовать вместо claude для критических сессий

Оценка времени: 8 часов

Ожидаемый результат: 100% работа (полный контроль над system prompt).

6. ДОПОЛНИТЕЛЬНЫЕ НАХОДКИ

6.1. Permissions vs Protocol

Важное различие:

• Permissions (.claude/settings.local.json) — ЧТО Claude МОЖЕТ делать (разрешение на вызов инструментов)
• Protocol (Output Styles, CLAUDE.md) — КАК Claude ДОЛЖЕН вести себя (поведение агента)

Текущая проблема: Permissions открыты (всё разрешено), но Protocol игнорируется.

Решение: Закрыть permissions НЕ ПОМОЖЕТ — нужно исправить Protocol.

6.2. SessionStart hook работает, но недостаточно

Файл: .claude/hooks/session-setup.sh

Что делает:
- Читает /opt/claude-workspace/CLAUDE.md
- Добавляет в additionalContext при startup/resume/compact

Почему не помогает:
- additionalContext = низкий приоритет (context reminder)
- НЕ переопределяет system prompt
- При конфликте базовые инструкции побеждают

Вывод: Hook полезен для восстановления контекста, но НЕ для переопределения инструкций.

6.3. История попыток

Что уже пробовали (из git):

Вывод: Все попытки работали с контекстом, а не с system prompt.

6.4. Документация Claude Code (пробелы)

Что НЕ документировано:

1. Точный приоритет инструкций при конфликте
2. Как keep-coding-instructions влияет на разрешение конфликтов
3. Можно ли через hooks инжектить в system prompt (ответ: нельзя)
4. Как Output Styles взаимодействуют с --append-system-prompt

Откуда узнали:
- Эксперименты в workspace
- Анализ architect/arh/analysis/2026-01-17-roles-optimization/
- Чтение .claude/CHANGES.md

7. ТЕХНИЧЕСКАЯ ПРИЧИНА

Последовательность обработки инструкций

1. Claude получает КОМБИНИРОВАННЫЙ system prompt:

   [Base Claude Code instructions]
   +
   [Output Style SafeDialog.md]  (т.к. keep-coding-instructions: true)

2. При обработке запроса "создай файл PROJECT.md":

   Claude видит ДВЕ инструкции:
   - Base: "NEVER create files unless absolutely necessary"
   - SafeDialog: "show plan before L1-L4 operations"

3. Интерпретация:

   "Мне нужно создать файл (запрос пользователя).
    Base говорит: NEVER create files (сильное правило).
    SafeDialog говорит: show plan before L1-L4 (добавочное правило).

    → Вывод: Создание файла НЕ является 'absolutely necessary',
             следовательно я должен следовать Base (NEVER create).

    → Действие: Создаю файл БЕЗ подтверждения."

4. РЕЗУЛЬТАТ: L1-L4 протокол игнорируется.

Почему Base побеждает

Факторы приоритета:

1. Порядок в system prompt: Base идёт ПЕРВЫМ → воспринимается как основа
2. Формулировка: "NEVER" (императив) vs "show plan" (процедура) → императив сильнее
3. Тип инструкции: Base = ограничение ("НЕ делай"), SafeDialog = процедура ("делай так") → ограничение сильнее
4. Уровень абстракции: Base = общее правило, SafeDialog = уточнение для подмножества → общее правило шире

Timing конфликта

Когда проявляется:

• ✅ При создании файлов (L1-L2)
• ✅ При оценках времени (любые операции)
• ⚠️ При изменении существующих файлов (реже, т.к. Base разрешает)
• ❌ При чтении (нет конфликта, всегда разрешено)

Когда НЕ проявляется:

• Default.md активен (нет переопределений)
• Операции L0 (чтение)
• Пользователь явно сказал "создай БЕЗ подтверждения"

ИТОГО

Корневая причина: keep-coding-instructions: true в Output Styles создаёт конфликт между базовыми и кастомными инструкциями, при котором базовые побеждают.

Решение: Изменить keep-coding-instructions: false и переписать Output Styles с явным переопределением + включением полезных частей базовых инструкций.

Оценка времени: 2 часа

Вероятность успеха: 85% (если не сработает → использовать SDK wrapper)

ССЫЛКИ

Документация

• architect/arh/reference/CLAUDE_CODE_SYSTEM_PROMPT.md — базовый system prompt
• architect/arh/analysis/2026-01-17-roles-optimization/ALL_METHODS_OVERRIDE.md — все способы переопределения
• architect/arh/analysis/2026-01-17-roles-optimization/HOW_TO_PERSIST_APPEND_SYSTEM_PROMPT.md — персистентность

Конфигурация

• .claude/settings.json — hooks
• .claude/settings.local.json — permissions
• .claude/hooks/session-setup.sh — SessionStart hook
• .claude/CHANGES.md — история изменений

Output Styles

• .claude/output-styles/SafeDialog.md — L1-L4 протокол
• .claude/output-styles/Coder.md — режим реализации
• .claude/output-styles/Architect.md — режим планирования

Инструкции

• CLAUDE.md — корневые инструкции (1113 строк)

Дата: 2026-02-19
Автор: Claude Sonnet 4.5 (исследование)
Статус: ✅ Готово к реализации