## Решения
- Требуется проверка наличия apiKey в post-reboot окружении через свежую запись в _debug.log — Две записи показывают apiKey=НЕТ, но обе до ребута; post-reboot проверка запишется после завершения текущего хода [→1]
- Если apiKey остался НЕТ после ребута — переделать секретарь на чтение ключа из файла вместо env переменных — Хук читает файл каждый раз, что исключит проблему с env переменными [→1]
- Оставить Хайку (200 токенов) вместо Sonnet — быстро и дёшево, небрежность по категориям приемлема — Хайку поймал суть верно, ошибки в сортировке категорий некритичны для MVP [→20]
- Исправить баг в secretary-transcript.mjs — tool_result теряет текст юзера и действия — tool_result это сообщения с ролью user, разбор берёт не тот индекс [→20]
- Хук должен форсить реальный номер хода в провенансе, не `[→1]` — Хайку не знает номер и угадывает, хук это знает — должен сам подставить [→20]
- Активировать штатный режим с экономией 100% и всеми паттернами — Пользователь запросил штатный режим [→1]
- После подтверждения выполнить багфиксы в порядке: баг 1 (действия + текст юзера на ходах с инструментами) → провенанс (реальный номер хода вместо [→1]) → кириллица в имени дела → удаление временного debug-лога — Системный план работ по TDD где возможно [→2]
- Оставить модель Хайку с возможностью поднятия до Sonnet одной правкой переменной SECRETARY_LLM_MODEL — Выбор пользователя; архитектура позволяет менять без изменения кода [→2]
- Баг 1 (корневой) в parseLastExchange固定: пропускал tool_result, теряя действия и текст промпта — TDD: RED тест показал потерю текста при tool_result, найдена и исправлена логика разбора [→22]
- Провенанс хука форсит реальный номер хода вместо [→1] — Убрана временная разметка, хук теперь показывает точный turn [→22]
- Кириллица в имени дела теперь обрабатывается корректно — Добавлена поддержка в prompt-hook, дело 'тест' не уходит в general [→22]
- Удален временный debug-лог из stop-hook — Очистка кода перед финализацией [→22]
- parseLastExchange пропускает tool_result, ищет настоящий промпт выше [→22]
- Коммит 4253cd7 запушен в gitea (liderra/brain.git) с обходом pre-push hooks (LEFTHOOK=0) — Бэкап всех 5 коммитов секретаря; github недоступен [→23]
- Слой 1 (сырьё) — новый файл на каждую сессию (docs/secretary/raw/<id-сессии>.log) — Резерв данных не смешивается между сессиями [→23]
- Протокол по делу (docs/secretary/<дело>/protocol.md) — сквозной, накапливается через все сессии — Единица организации — дело, не сессия; память не теряется при смене сессии [→23]
- Подготовить промпт для следующей сессии, который обеспечит контекст и продолжение работы — Пользователь запросил промпт для следующей сессии с чтением гайда, CLAUDE.md, слоя 1 и графа проекта [→24]
- Секретарь протокола работ собран, развернут и работает вживую на aitunnel с Haiku — Подтверждение статуса: 8 модулей, 3 хука, 26 тестов green, функциональность проверена [→24]
- Требуется добавить строку coverage в начало ответа — Хук enforce-coverage-verify обнаружил мутирующие вызовы без отчета о покрытии [→1]
- Формат: coverage: skill:<name> или coverage: direct:<role> — Стандарт проверки для валидации реально вызванных компонентов [→1]
- Выбрать между живой демонстрацией (включить → 1–2 хода → выключить → протокол + steps/turn-N.md) или сразу за качество (Sonnet / промпт Хайку) — Ассистент запрашивает явный выбор пользователя для продолжения работы [→2]
- Формат оглавления дел: [<дело>](<дело>/protocol.md) — <тема одна строка> · <статус> · <ГГГГ-ММ-ДД ЧЧ:ММ> — Оглавление нужно компактным и информативным для быстрого поиска и понимания сути; текущий шаблон выводит заглушку '(дело)' вместо темы и дату без времени [→3]
- Добавить поле 'тема' в выжимку модели (secretary-extract.mjs), парсер протокола (secretary-protocol.mjs) и хук остановки (secretary-stop-hook.mjs) — Источник реальной темы дела — последняя непустая строка сути от модели; нужна сквозная цепь: мотор → протокол → оглавление [→3]
- title: work, goal: реальная тема из протокола, status: текущий статус, date: ГГГГ-ММ-ДД ЧЧ:ММ [→3]
- Спека docs/superpowers/specs/2026-06-22-secretary-index-subject-time-design-v2.md получила вердикт GO от наставника и судьи — Проверка через Grep mentor-verdict-*.json подтвердила одобрение; баннер degraded не является блокером [→4]
- Тесты produce-verify-receipt охватывают секретарские файлы и пригодны для RED/GREEN цикла — Конфиг свода исключает только ruflo-* и subagent-prompt-prefix; базовый свод зелёный [→4]
- Коммит отложен до завершения исполнения плана TDD — Результат показывается владельцу без коммита; коммит вне области текущей правки [→4]
- Удалить при финализации (остаётся только -v2) [→4]
- Требуется добавить coverage-отчет в начало ответа при мутирующих вызовах — Хук enforce-coverage-verify обнаружил отсутствие строки `coverage:` в ответе [→1]
- Требуется добавить строку coverage в начало ответа при мутирующих вызовах — Enforce-coverage-verify hook не получает информацию о покрытии в ответе [→5]
- Первой строкой: coverage: skill:<name> или coverage: direct:<role> [→5]
- Требуется первой строкой ответа указывать coverage-метрику (skill:<name> или direct:<role>) — Hook enforce-coverage-verify проверяет наличие строки `coverage:` в ответах с мутирующими вызовами [→2]
- Требуется указать coverage в первой строке ответа — Инструмент enforce-coverage-verify обнаружил отсутствие строки coverage: в ответе ассистента [→6]
- Требуется выбрать вариант решения: 1) выполнить в терминале, 2) уступить наставнику, 3) предложить своё [→6]
- JSON дороже Markdown для контекста из-за служебных символов, повторения названий полей и встроенного балласта (base64 embeddings) — Каждая кавычка, скобка, двоеточие — отдельный токен; названия полей повторяются в каждой строке; machine-readable данные (embeddings) не нужны человеку [→3]
- Правильная тактика — не глотать сырые JSON-логи целиком, а запросить итог через фильтр (скрипт или помощник) — Экономия на 10-20x раз по токенам; сессия остаётся лёгкой; сохраняется память на осмысленный контекст [→3]
- protocol.json и protocol.md содержат одно и то же дело, различаются только форматом — JSON для машинной обработки, MD для чтения человеком [→4]
- JSON тяжелее MD на ~37% (25401 vs 18530 байт) при идентичном содержании — Служебная обвязка структуры: кавычки, ключи, скобки на каждый пункт [→4]
- Оба файла протокола (protocol.md и protocol.json) содержат идентичный контент — 5 разделов и одинаковые пункты — Результат сверки через file-compare (чтение и сравнение без изменений) [→5]
- JSON представление на ~37% больше по объему (25401 vs 18530 байт) из-за служебной обвязки — Техническая характеристика формата [→5]
- В штатном режиме ассистент работает автономно без промежуточных вопросов до полного результата — Пользователь требует максимальной автономности и эффективности [→8]
- Активны все паттерны обработки по умолчанию с 100% экономией токенов — Оптимизация ресурсов при самостоятельной работе [→8]
- Активировать штатный режим с экономией 100% и всеми паттернами — Пользователь запросил штатный режим [→9]
- Стена (ограничение) снимается только при второй фразе-подтверждении — Первая фраза — только триггер, требуется подтверждение [→9]
- Остановить все действия до явного указания пользователя — Пользователь запретил менять содержание; ассистент поспешил с изменениями [→10]
- Ожидание выбора: откатить все правки ИЛИ оставить правки кода [→10]
- Формат содержания остаётся markdown, JSON только во внутреннем обсуждении — Пользователь уточнил требование [→11]
- Удаление черновиков через node-скрипт с unlinkSync, обход ограничения PowerShell — Правило 8 блокирует удаление через PowerShell, гайд §3 предписывает способ [→11]
- Тему генерирует модель в выжимке (новое поле), время ставит хук — Обеспечить динамическое наполнение оглавления актуальными данными [→11]
- Секретарь не активирован из-за опечатки в команде — Детектор ищет точное совпадение 'включи секретар...' но получил 'включи секреторя' (через 'о' вместо 'а') [→12]
- Секретарь включён на дело general — Пользователь дал команду 'включи секретаря', система активировала протоколирование [→13]
- Флажок секретаря (~/.claude/runtime/secretary-mode.json) — глобальный на всю машину, не привязан к сессии — Единственный файл без id сессии в имени, содержит одно поле work и mode — общие для всех сессий [→14]
- При двух параллельных сессиях память/протокол/оглавление перемешиваются в одно дело — Stop-хук читает work из глобального флажка, последняя сессия перезатирает его — обе сессии пишут выжимку в один protocol.md [→14]
- Вкл/выкл секретаря — общий рубильник для обеих сессий — mode=off в глобальном файле гасит секретаря везде одновременно, нарезка steps идёт по состоянию последней трогавшей сессии [→14]
- Сырьё (raw) не смешивается — хранится отдельно по session.log — Raw пишется по реальному id сессии из события, восстановление данных возможно [→14]
- Правка 1 — флажок secretary-mode-<session>.json вместо глобального, использовать ev.session_id в обоих хуках — Убирает смешивание дел между сессиями, каждая сессия ведёт своё независимо [→15]
- Правка 2 — дедуплификация при записи решений: не добавлять пункт, если его нормализованный текст уже есть и не зачёркнут — Убирает накопление дубликатов одного и того же решения, реализует сверку вместо свалки [→15]
- 1 протокол = 1 сессия (как Слой 1), стартовый промпт содержит пересказ прошлой сессии для континуитета — Убирает смешивание данных на корню, экономит память, полная картина в последнем протоколе [→16]
- Картина дела должна быть проговорена текстом в первом ответе ассистента, не просто Read — Хук видит только текст обмена; содержимое файлов в выжимку не попадает [→16]
- Реализовать по TDD одним чистым коммитом с полным набором изменений — Избежать полу-шагов, схема меняет маршрутизацию [→16]
- Протокол дела должен накапливаться автоматически хуком без пересказа агентом — stop-хук уже читает и дополняет protocol.json перед записью, механизм работает, нужна только маршрутизация [→17]
- Использовать session-specific флажок вместо глобального для каждой сессии — Два параллельных процесса перетирают единый secretary-mode.json, разделение по сессии предотвращает смешивание [→17]
- Добавить дедуп при записи — не писать пункт, если его текст уже есть — Копящийся хлам от дублей; сверка перед дозаписью решает [→17]
- Атомарная запись протокола (temp + rename, опционально файл-замок) — Закрыть край race condition при одновременной записи из двух сессий в одно дело [→17]
- У каждого окна своя записка-флажок (не одна на весь компьютер) — Избежать перезаписи флажка и смешивания дел из разных окон в одну тетрадь [→18]
- Включить дедупликацию — одна строка на решение/намерение вместо дублей — Избежать хлама в тетради, если решение или действие повторилось несколько раз в одном разговоре [→18]
- Название дела работает как кодовое слово для включения/выключения секретаря — Простой и без техники способ управления записями [→19]
- Одно слово без пробелов — правило именования дела — Избежать ошибок парсинга при вводе команды [→19]
- Одно слово = одна тетрадь; повторное использование слова в новом окне продолжает то же дело — Обеспечить накопление памяти дела через сессии [→19]
- При отсутствии слова используется дело по умолчанию 'general' — Предотвратить потерю данных и обработать неполные команды [→19]
- Каждое новое окно секретарь стартует выключенным — Требовать явного включения, контролировать запись [→19]

## Твоя воля / запреты
- Ассистент прочитает свежую запись _debug.log после получения одного слова от пользователя [→1]
- Чинить баг 1 (действия) + провенанс + кириллицу в имени дела
- Коммит после чистого рабочего состояния
- Ожидание подтверждения: ровно «да, штатный» [→2]
- Финальная живая проверка на следующем Stop: проверить в raw файлах появление [ДЕЙСТВИЕ] и текста [→22]
- Секретарь включен (Хайку каждый ход ~0.5₽) — ждёт команды 'выключи секретаря' [→23]
- Подтвердить вживую, что действия ([ДЕЙСТВИЕ]) теперь пишутся в raw (фикс бага 1) [→24]
- Рассмотреть использование Sonnet вместо Haiku для повышения качества выжимки категорий [→24]
- Возможно добавить .gitignore на docs/secretary/ (рантайм-данные) [→24]
- Начинать ответы с coverage-строки при наличии мутирующих операций [→1]
- Первой строкой ответа добавить coverage tag (coverage: skill:<name> или coverage: direct:<role>) [→2]
- Напечатать спеку контракта оглавления (файл -design-v2.md прошёл печать наставника) [→3]
- Напечатать план TDD: тесты → изменения в трёх модулях → проверка сводом → show результат (без коммита) [→3]
- Исполнить TDD план: 7 шагов (тесты → RED → реализация → GREEN) для полей secretary-extract.mjs, secretary-protocol.mjs, secretary-stop-hook.mjs [→4]
- Подать результат владельцу без коммита [→4]
- Начинать ответы со строки coverage: skill:<name> или coverage: direct:<role> при выполнении мутирующих операций [→1]
- При следующих мутирующих вызовах указывать coverage с реально вызванным навыком или ролью [→5]
- Ассистент ждёт уточнения: показать ту же строку целиком в обоих видах coverage или остановиться [→2]
- Промерить точные цифры токенов: сырой JSON-лог vs. человеческая версия [→3]
- Фиксировать оглавление (тема + время) по TDD методологии [→8]
- Подготовить зелёный свод результатов [→8]
- Удалить 6 черновиков спек и планов [→8]
- Показать готовый результат без остановок [→8]
- При получении подтверждения 'да, штатный' молча выполнить окончательный фикс [→9]
- Протестировать живой ход с включённым секретарём для проверки вывода темы и времени [→11]
- Написать команду ровно: 'включи секретаря' (через 'а') [→12]
- Сделать один любой ход для примера [→12]
- Выключить секретаря командой 'выключи секретаря' [→12]
- Провести один обычный ход для демонстрации работы секретаря [→13]
- Выключить секретаря после демонстрационного хода [→13]
- Сделать флажок секретаря привязанным к сессии (secretary-mode-<session>.json) чтобы параллельные сессии не топтали друг друга [→14]
- Закоммитить готовый фикс оглавления отдельно (31 тест зелёные), потом новым делом Правка 1 + 2 по TDD [→15]
- Добавить флажок по сессии: secretary-mode-<session>.json [→16]
- Структурировать протокол по сессии: docs/secretary/<session>/protocol.md + steps/ [→16]
- Создать содержание.md со строкой на сессию (тема + дата/время + ссылка) [→16]
- Добавить дедуп при записи в applyExtraction (спека D5) [→16]
- Реализовать 3 детерминированные правки в хуке под TDD [→17]
- Внедрить две правки одним делом по TDD (ждёт подтверждения «делай») [→18]
- Сделать 3 правки: записка-флажок на окно, дедуп, атомарная запись [→19]

## Открытые вопросы
- Ожидается ввод одного слова от пользователя для триггера чтения post-reboot логов [→1]
- Добавить runtime-данные secretary (raw/, general/) в .gitignore опционально [→22]
- Качество выжимки Haiku небрежное по категориям — требует оценки и потенциального улучшения [→24]
- claude-mem: /plugin в текущей среде недоступен — отложено на потом [→24]
- Определить какие skills/roles были реально задействованы в текущем ходе для coverage-отчета [→1]
- Выбор стратегии демонстрации: живая демонстрация целиком vs сразу за качество [→2]
- Обеспечить корректный coverage tag в следующем ответе с документированием реально вызванных функций [→2]
- Ожидание вердикта наставника по спеке (асинхронно, таймер ~2,5 минуты) [→3]
- Ожидание печати плана от наставника и судьи (таймер ~3 минуты); затем автономное исполнение 7 шагов TDD [→4]
- Реализовать логику отслеживания вызванных навыков/ролей для coverage-отчета [→1]
- Implement coverage reporting format в responses с мутирующими операциями [→5]
- Требуется ли демонстрация полного формата coverage-метрики (оба варианта: skill и direct) на примере? [→2]
- Арбитраж: какой вариант действия выбрать для разрешения конфликта coverage-верификации [→6]
- Проверить точное соответствие MD, собранного из JSON (нет ли рассинхрона, потерянных пунктов) [→4]
- Требуется ли точная построчная сверка JSON и MD на предмет потери пункта между форматами или сверка завершена? [→5]
- Ожидание подтверждения 'да, штатный' для активации режима [→8]
- Ожидание второй фразы-подтверждения 'да, штатный' для снятия стены [→9]
- Выбор пользователя: 1) откатить все правки + обсудить план ИЛИ 2) оставить правки кода [→10]
- Уточнить требования к формату содержания и обновлению тем в оглавлении [→10]
- Оценить качество темы, генерируемой Хайку; рассмотреть переход на Sonnet если результат будет небрежным [→11]
- Активировать режим секретаря с корректной командой [→12]
- Показать содержание.md с реальной темой и временем [→13]
- Показать нарезанные steps/turn-N.md файлы [→13]
- Нужно ли срочно фиксить глобальный флажок или это отдельная задача? [→14]
- Редкий край: две сессии на одно дело одновременно требуют замка/слияния — отложить на потом если понадобится [→15]
- Обеспечить поиск и быстрый доступ к нужному протоколу из архива [→16]

## Сделано / дальше
- [ ] Проверить наличие apiKey в свежей записи _debug.log [→1]
- [ ] По результату: либо подтвердить успех ребута, либо переделать секретарь на файловое чтение ключа [→1]
- [ ] Убрать временный debug-лог из хука
- [x] Коммит 4253cd7 встал: 4 файла, 26 тестов GREEN, баг 1 FIXED [→22]
- [ ] Выключить секретаря после теста (экономия 0.5₽ за ход на Haiku) [→22]
- [ ] Опционально: подтвердить в следующий ход, что фикс действений работает (просмотр свежего raw-файла) [→23]
- [ ] Скопировать готовый промпт и использовать его первым сообщением в следующей сессии [→24]
- [ ] По желанию: выключить секретаря командой «выключи секретаря» + «выключи штатный» для аккуратного завершения [→24]
- [ ] Добавить coverage-строку в следующий ответ согласно формату [→1]
- [ ] Получить явный выбор пользователя по стратегии работы [→2]
- [ ] Проверить вердикт по спеке и напечатать план работ [→3]
- [ ] Выполнить шаги плана (TDD: тесты → код → зелёный свод) [→3]
- [ ] Показать результат (без коммита, после одобрения) [→3]
- [ ] Реализовать поле «тема» в secretary-extract.mjs с привязкой к реальной теме и времени [→4]
- [ ] Обновить secretary-protocol.mjs для обработки темы и времени в оглавлении [→4]
- [ ] Модифицировать secretary-stop-hook.mjs для кормления оглавления реальными данными [→4]
- [ ] Запустить RED/GREEN через node tools/produce-verify-receipt.mjs [→4]
- [ ] Проверить журнал выполнения и указать корректное имя вызванного навыка или роли [→1]
- [ ] Добавить coverage:<type>:<name> в начало ответа при вызове tool/enforce-coverage-verify [→5]
- [ ] Пояснить различие между coverage: skill и coverage: direct на примере одной строки лога [→2]
- [ ] Получить решение от пользователя по трём вариантам разрешения [→6]
- [ ] Получить дословное подтверждение активации штатного режима [→8]
- [ ] Молча выполнить фикс до конца при получении подтверждения [→9]
- [ ] Ждать явной команды пользователя перед любыми действиями с файлами [→10]
- [x] 31 тест зелёные (добавлено 5 по TDD) [→11]
- [x] Синтаксис хука проверен [→11]
- [x] 6 черновиков удалены, скрипт убран [→11]
- [ ] Повторить команду активации с правильной орфографией [→12]
- [ ] Сделать демонстрационный ход (описание или вопрос по делу) [→13]
- [ ] Выбрать вариант: коммитить оглавление отдельно (вариант 1) или сложить всё в одну пачку (вариант 2) [→15]
- [ ] Реализовать схему: флажки + по-сессионная структура + дедуп + содержание [→16]
- [ ] Заменить secretary-mode.json на secretary-mode-<session>.json [→17]
- [ ] Добавить applyExtraction дедуп: проверка наличия текста перед дозаписью [→17]
- [ ] Внедрить атомарную запись с temp-файлом и rename [→17]
- [ ] Получить подтверждение пользователя на запуск реализации [→18]

## История (заменено, не стёрто)
- ~~parseLastExchange ловил tool_result как настоящий промпт~~ → parseLastExchange пропускает tool_result, ищет настоящий промпт выше [→22]
- ~~title: work, goal: '(дело)', status: 'открыто', date без времени в secretary-stop-hook.mjs~~ → title: work, goal: реальная тема из протокола, status: текущий статус, date: ГГГГ-ММ-ДД ЧЧ:ММ [→3]
- ~~Черновик спеки ...-design.md~~ → Удалить при финализации (остаётся только -v2) [→4]
- ~~Ответ без строки coverage:~~ → Первой строкой: coverage: skill:<name> или coverage: direct:<role> [→5]
- ~~coverage: direct:secretary-index-design~~ → Требуется выбрать вариант решения: 1) выполнить в терминале, 2) уступить наставнику, 3) предложить своё [→6]
- ~~Правки в 5 файлах кода/тестов (содержание.md остаётся markdown)~~ → Ожидание выбора: откатить все правки ИЛИ оставить правки кода [→10]