Грабли, токены, безопасность

Команды, которые работают с агентами по несколько месяцев, наступают на одни и те же грабли. Внутренний опрос таких команд дал шесть повторяющихся проблем: разросшиеся сессии, устаревший AGENTS.md, счёт за reasoning, MCP-зоопарк, секреты в контексте, правки, применённые без чтения.

Каждую проблему разбираем парой «симптом → приём». По симптому узнаёшь ситуацию у себя, приём применяешь в текущей сессии orders-api. Начни с честного ответа: сколько задач уже побывало в твоей рабочей сессии.

Симптом: сессия живёт второй день, в ней побывали баг отрицательного количества из модуля 2, скидки из модуля 5 и половина README. Каждый новый вопрос уносит всю историю в запрос: ответы замедляются, счёт растёт, агент смешивает условия разных задач.

Приём: одна задача, одна сессия. Закончил задачу, открыл /new. Контекст из старой ещё нужен, сожми его /compact: агент заменит историю выжимкой и продолжит быстрее и дешевле.

Симптом: ты добавил src/services/payments.ts, просишь дописать к нему тест, а агент правит старый модуль или спрашивает, где новый файл лежит. Частая причина рядом: раздела про этот сервис в AGENTS.md нет, либо структура в файле устарела после рефакторинга.

Приём: отдай файл явно через @, тогда агент прочитает его до ответа; диапазон строк задаётся решёткой. Затем сверь AGENTS.md с кодом: /init пересоберёт черновик по текущей базе, остальное допиши руками по инструкциям.

Симптом: вечер переименований и обновления двух README оплачен как рефакторинг архитектуры. Причина в варианте reasoning: #high размышляет над каждым шагом, и эти рассуждения тарифицируются как токены. Рутине такая глубина рассуждений ничего не добавляет.

Приём: вариант reasoning под задачу. F2 открывает недавние модели, вариант дописывается решёткой к идентификатору модели, например openai/gpt-5.2#low. Чистую рутину отправляй на бесплатную модель OpenCode (список смотри в /models): переименования и форматирование ей по силам, счёт за них не растёт.

Симптом: за месяц подключились Context7, Playwright, корпоративный трекер и пара серверов «на будущее». Каждый MCP-сервер приносит свои инструменты в контекст каждого запроса, даже когда задача про код заказов. Ответы дорожают, агент путается в похожих инструментах.

Приём: раз в месяц аудит /mcps. У сервера нет текущих задач, отключай его в opencode.jsonc полем enabled: false; вернёшь тем же полем, когда сервер понадобится.

Симптом: агенту нужна переменная окружения, и он предлагает записать значение в .env или прочитать файл целиком. Токен попадает в контекст сессии и остаётся там: уходит в /compact, в логи, в следующий вопрос.

Приём: в OpenCode v2 чтение *.env и *.env.* уже по умолчанию спрашивает разрешение, *.env.example свободен. Закрепи защиту в opencode.jsonc: правку .env запрети, секреты вноси руками, агенту оставь чтение из process.env.

Симптом: третья правка за минуту, кнопка always нажимается уже без чтения, и удалённая проверка количества обнаруживается на красном CI. В опросе команд слепое доверие диффам назвали самой дорогой привычкой из шести проблем.

Приём: дифф читается до выбора. Правка непонятна, жми reject и спроси, что она делает. Лишнее уже применилось, откатит /undo: команда отменяет сообщение и все его изменения файлов. Отдельно проверяй правки вне задачи: рефакторинг рядом, переформатирование, удаление проверок. Потренируйся на текущей сессии: открой последний применённый дифф и найди строку, которую не запрашивал.