troubleshooting.md

В прошлом посте я рассказал про свой сетап. Теперь про то как устроен Claude Code - концепции которые стоит понять прежде чем выстраивать воркфлоу. Скиллы Инструкции структурирующие работу и повышающие перфоманс в определенном домене. Подробнее про мои кастомные скиллы расскажу в отдельном посте. Агенты В Claude Code есть два типа изоляции выполнения задачи (не про сендбоксы и дев контейнеры): Агент - все элементарно: изолированный контекст получает задачу + [ claude.md ]( http://claude.md/ ), не может задавать уточняющие вопросы, может только завершить задачу. Раньше я явно писал в [ claude.md ]( http://claude.md/ ): "если агент столкнулся с необходимостью принятия решения которое не обсуждалось при планировании - он должен завершить задачу и задать уточняющий вопрос." Команда агентов - плюсы для себя: при планировании команды можно сделать обязательного ревью-агента отложенного на каждый stage агенты могут свободно общаться с тобой и между друг другом через блок message Оба типа могут работать в git worktree. Память - user/project claude.md user claude.md - будет с вами в каждой сессии, тут описываем паттерны работы. project claude.md- МИНИМУМ концентрированной информации о проекте. Как работает у меня: в claude.md самое важное + там указана директория docs, в которой подробная чистая документация на тысячи строк каждая - database, backend, frontend, search-engine, infra и тд. Агенты взаимодействуют с этими md файлами через эксплорер. Следим за актуальностью в конце каждой сессии. Можно настроить хук по обновлению доки если забываете - на git add/commit/push. Кастомные скиллы - где брать Я просто читаю топовые репозитории и редачу под себя. Есть паттерн RGT по написанию скиллов - ты выбираешь пул текущих задач, тестишь на разных скиллах и так определяешь скилл наиболее эффективный. Рекомендую всем так делать чтобы не возникало конфликтующих инструкций и вам чаще нравился результат. Ресурсы: skillsmp - имеют API, прошу Claude Code поискать промпты на оп