# Спека — требования к заметке-багу «чтение под стеной» для claude-brain

## Цель

Зафиксировать требования к новому файлу-заметке о дефекте чтения в режиме
реализации под стеной «роутер-наставник» — для передачи в claude-brain. Документ
описывает контракт, перечень случаев и приоритет починки; сам файл-заметка
пишется отдельным шагом плана, не этим документом.

## Что фиксируем — суть бага {#B1}

**Контракт.** Заметка обязана одной фразой назвать дефект: в режиме реализации
(под опечатанным планом) чтение разрешено только по пути текущего шага; всё
остальное — включая файлы, появившиеся в ходе прогона, и собственный вывод
запущенных инструментов — читать нельзя (гейт ДР-1).

**Критерий.** В файле есть короткая формулировка сути в одно-два предложения.

## Случаи, где дефект бьёт {#B2}

**Контракт.** Заметка перечисляет конкретные сценарии: (1) свой вывод команды в
temp-файле; (2) забытое до печати плана чтение; (3) файл, созданный сторонним
сервисом/процессом во время прогона; (4) нечем проверить результат шага; (5)
ветвление по содержимому файла невозможно; (6) диагностика ошибки по внешнему
логу; (7) промежуточный артефакт в цепочке инструментов; (8) перечитать только
что записанное; (9) неожиданно найденный файл; (10) файлы от параллельной сессии.

**Edge-case.** Указать живой пример: на прогоне go-live аудита так не прочитался
вывод Nuclei и был пропущен шаг gitleaks.

**Критерий.** В файле — нумерованный список сценариев с коротким пояснением каждого.

## Связь с рассинхроном указателя {#B3}

**Контракт.** Заметка фиксирует, почему наивный escape на чтение опасен: стена
двигает счётчик шагов даже когда действие не прошло (десинк F-J); если пустить
чтение через ту же машинерию шагов — очередь сдвинется. Вывод: чтение не является
шагом (шаги — только Write/Edit/Bash/MultiEdit), поэтому разрешение на чтение
должно работать «сбоку от очереди», не трогая счётчик.

**Критерий.** В файле явно сказано: счётчик не должен двигаться на чтении.

## Приоритет починки {#B4}

**Контракт.** Заметка предлагает порядок: (1) счётчик шагов += 1 только при
успешно завершённом настоящем шаге (чинит и десинк, и делает чтение безопасным);
(2) пассивно разрешить чтение своего вывода и файлов, созданных после
опечатывания, без escape и без касания очереди; (3) escape-метка `read:<путь>` —
крайний резерв, строго мимо счётчика шагов.

**Критерий.** В файле — список из трёх пунктов починки по приоритету, с пометкой,
что главное — починка счётчика, а escape — последнее.

```verified-context-json
[
  {"id":"vc1","kind":"EXTRACTED","ref":"docs/superpowers/router-mentor-wall-GUIDE.md","anchor":"Читать ПЕРЕД работой под стеной"},
  {"id":"vc2","kind":"EXTRACTED","ref":"docs/security/2026-06-17-go-live-security-report.md","anchor":"SECURITY GO-LIVE REPORT"}
]
```
