Итоговый workflow Claude Code: от задачи до проверенного PR

Production-работа с Claude Code — это не один «идеальный prompt», а управляемый процесс от постановки задачи до проверенного pull request.

Краткий ответ

Production-работа с Claude Code — это не один «идеальный prompt», а управляемый процесс от постановки задачи до проверенного pull request. В нём контекст хранится в правильных местах, полномочия ограничены, изменения изолированы, а готовность подтверждается доказательствами.

Шаг 1. Подготовить среду и границы

Откройте правильный репозиторий, проверьте ветку и git status. Для параллельной работы создайте отдельный worktree. Убедитесь, что CLAUDE.md содержит актуальные команды и архитектурные правила, но не секреты. Выберите минимальный permission mode и sandbox, подходящие риску.

До старта зафиксируйте, какие внешние системы доступны и какие действия запрещены без отдельного подтверждения.

Шаг 2. Сформулировать контракт задачи

Опишите наблюдаемую проблему, полезные пути, ограничения, примеры и критерии готовности. Для сложной работы сначала запросите только исследование:

> Воспроизведи дефект, найди подтверждённую причину и предложи план. До согласования не редактируй файлы. В плане укажи regression-тест, риски совместимости и команды проверки.

Проверьте, что план решает требование, а не случайную гипотезу.

Шаг 3. Реализовать контролируемый срез

Разрешите минимальную реализацию. Следите, чтобы агент сохранял пользовательские изменения и не расширял scope. Длинное исследование делегируйте read-only подагенту, повторяемую процедуру оформляйте Skill, внешнюю систему подключайте через проверенный MCP, а обязательный барьер реализуйте hook или CI.

После каждого смыслового шага полезны целевая проверка и обзор diff.

Шаг 4. Проверить и опровергнуть

Потребуйте фактический вывод теста, lint, typecheck или сборки. Для UI добавьте браузерный сценарий и снимок. Затем проведите независимый review: пусть отдельный контекст ищет логические ошибки и пытается доказать каждую находку.

Не принимайте «все тесты проходят» без команды, времени запуска и результата после последнего изменения.

Шаг 5. Подготовить публикацию

Проверьте git status и весь diff, сформируйте понятный коммит. PR должен содержать проблему, решение, область, проверки, риск и способ отката. Push, создание PR, ответы в issue и merge — отдельные внешние действия, которые выполняются только по явному намерению.

Итоговое упражнение

Проведите реальную небольшую задачу через артефакты:

1. исходная постановка и критерии; 2. отчёт исследования с доказательствами; 3. согласованный план; 4. regression-тест; 5. узкий diff; 6. журнал проверок; 7. независимое review; 8. черновик PR.

После завершения определите, что стоит перенести в CLAUDE.md, Skill или CI, чтобы следующий цикл стал надёжнее.

Частые вопросы

Где заканчивается ответственность Claude Code?

Агент выполняет разрешённую техническую работу и предоставляет результат. Владелец проекта отвечает за требования, права, review и внешнюю публикацию.

Что важнее: хороший prompt или хорошая инфраструктура?

Они дополняют друг друга. Prompt задаёт цель, а тесты, Git, permissions, sandbox, hooks и CI не дают качеству зависеть только от текста.

Когда workflow можно автоматизировать полностью?

Когда вход ограничен, действия обратимы или изолированы, права минимальны, результат машиночитаемо проверяется, а ошибки и стоимость наблюдаемы. Высокорисковые внешние действия обычно сохраняют человеческий контроль.

Что важно запомнить

Надёжность создаёт весь процесс, а не одно сообщение модели.
Контекст, полномочия и файловая изоляция проектируются заранее.
Проверка должна оставлять воспроизводимое доказательство.
Публикация результата всегда отделена от локальной реализации.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-18