раздел 12 · шпаргалка

Библиотека промптов

Готовые промпты для копипаста под частые задачи. Не идеальные, но рабочие - стартовая точка, которую вы будете дорабатывать под себя.

Понимание кодобазы

Быстрый обзор репозитория

Прочитай README и CLAUDE.md, изучи структуру верхнего уровня
и расскажи мне в трёх абзацах: что это за проект, какой стек,
где основная логика. Не лезь в детали - дай map of the territory.

Найти где что-то реализовано

Делегируй Explore: найди где в репо реализована аутентификация.
Верни список файлов с краткими аннотациями: что в каждом файле.
Не редактируй ничего.

Объяснить кусок кода

Прочитай app/services/payment.py и объясни мне как джуну:
- Что делает этот сервис в целом
- Как идут деньги (трассировка по функциям)
- Где могут быть ошибки или race conditions
- Что бы ты улучшил в первую очередь

Создание кода

Скаффолд нового сервиса

Создай новый FastAPI-сервис в services/notifications/.
Требования:
- async-handlers
- Pydantic v2 модели
- SQLAlchemy 2.0 + Postgres
- pytest для тестов
- Базовая структура endpoints: POST /notify, GET /notify/{id}, GET /notify/user/{user_id}
- Все типы аннотированы
- В конце - запусти tests и убедись что проходят

Новый React-компонент

Создай компонент <TaskCard /> в frontend/src/components/.
Требования:
- TypeScript, без default export
- Tailwind 4
- props: task: Task, onComplete: (id) => void
- Поведение: клик по чекбоксу - вызвать onComplete, оптимистический update
- Loading state когда onComplete возвращает Promise
- Все edge cases: пустой title, очень длинный title, undefined category
- Storybook story

Отладка

Найти баг по описанию

Пользователь жалуется: "При отправке формы с длинным комментарием
страница виснет на 5 секунд". Найди причину:
1. Воспроизведи локально (curl или браузер)
2. Изучи стек: где обрабатывается submit формы
3. Найди bottleneck (сеть, парсинг, DB, рендер)
4. НЕ фикси - сначала покажи root cause

Тест-репродукция

Этот баг закрыли два дня назад: <ссылка/описание>.
Напиши pytest-тест, который воспроизводит ровно эту ситуацию.
Тест должен падать на коде ДО фикса и проходить ПОСЛЕ.
Цель - не дать багу вернуться.

Тесты

Покрыть критические пути

Делегируй code-explorer: найди в app/services/ 5 самых критичных
функций - тех, без которых приложение неработоспособно. Для каждой
напиши pytest-тесты на счастливый путь + 3-5 edge cases. Используй
respx для моков HTTP, мокай Anthropic SDK через unittest.mock.

E2E через Playwright

Через Playwright MCP открой http://localhost:5173, авторизуйся
как test@example.com, создай новую задачу с title "test task",
проверь что она появилась в списке и имеет category="other".
Сохрани как playwright/tests/create-task.spec.ts.

Документация

README с нуля

Сгенерируй README.md для этого проекта. Структура:
- Что это (1 абзац для нетехнического читателя)
- Стек (списком)
- Запуск локально (команды по шагам)
- Структура проекта (только верхний уровень)
- Деплой
- Полезные ссылки
Не пиши общих фраз, всё конкретно с командами.

CLAUDE.md для проекта

/init

(встроенная команда - Claude сам прочитает репо и предложит CLAUDE.md)

Документация API

Сгенерируй OpenAPI-спецификацию для нашего FastAPI и поставь
автогенерацию TypeScript-типов через openapi-typescript в frontend.
Затем напиши Markdown-документацию для двух эндпоинтов: POST /api/tasks
и GET /api/tasks - с примерами curl и реальными ответами.

Деплой

Dockerfile с нуля

Сделай Dockerfile multi-stage для нашего Next.js 16 проекта.
Требования:
- output: standalone
- node:22-alpine
- Кеширование npm-зависимостей в отдельном слое
- USER nextjs (не root)
- EXPOSE 3000
- HEALTHCHECK
Затем docker-compose.yml с одним сервисом на порту 127.0.0.1:3109.

Smoke-тест

Напиши test/smoke.py - python-скрипт, который запускается после деплоя.
Проверяет:
- Главная страница возвращает 200 и содержит "<заголовок>"
- API /api/health возвращает {"status":"ok"}
- API /api/version возвращает версию из package.json
Если хоть один чек упал - exit 1.
Зависимости только curl + python3, без внешних пакетов.

Рефакторинг

Перейти на новую библиотеку

Plan mode.
Спланируй миграцию state-management с Redux на Zustand.
Учти: используется в 15 компонентах через useSelector,
middleware redux-thunk, селекторы с reselect.
План должен включать этапы по 2-3 файла за раз с возможностью
независимого тестирования.

Унификация имён

Делегируй Explore: найди все API endpoints, у которых пути в
camelCase (например /api/getUser). Верни список. Затем создай
PR-план переименования в kebab-case (/api/get-user) с обратной
совместимостью через deprecation на 1 релиз.

Полезные ссылки