testing-patterns — правило для Claude Code: тесты на Vitest
Правило testing-patterns для Claude Code задаёт соглашения по Vitest: расположение тестов, работу с моками LLM и запуск одного теста.
MIT ★ 1 319 обновлён 2026-09-24
.claude/rules/testing-patterns.mdЧто делает testing-patterns
Правило задаёт агенту порядок работы с тестами на Vitest. Настройки читаются из vitest.config.ts, общий сетап лежит в src/test/setup.ts и подгружается сам. Весь набор идёт через npm run test, одиночный файл запускается как npx vitest run src/scoring/__tests__/accuracy.test.ts.
Главное ограничение касается моков LLM. Вызовы @anthropic-ai/sdk, openai и @anthropic-ai/vertex-sdk уже замоканы глобально в сетапе, и в отдельном тесте их трогать нельзя. Для fs и child_process предписано vi.mock(), для проверки типов берите vi.mocked(). Переменные окружения сохраняют из process.env в beforeEach и возвращают в afterEach.
Файлы правило берёт только из src/**/__tests__/**. Тест в другой папке оно просто не увидит, поэтому соседство с исходником здесь не пожелание, а условие. Покрытие считается через npm run test:coverage, провайдер v8, пороги — в vitest.config.ts.
Какие задачи решает
- Разложить тесты по папкам
__tests__рядом с исходниками - Не дублировать моки LLM в каждом отдельном тесте
- Прогнать один упавший файл вместо всего набора
- Вернуть
process.envв исходное состояние после теста - Сверить покрытие с порогами из конфига
Примеры запросов агенту
- Напиши тест на
src/llm/config.ts, положи его вsrc/llm/__tests__/config.test.tsи замокайfsчерезvi.mock() - Прогони только
npx vitest run src/scoring/__tests__/accuracy.test.tsи покажи, какая проверка падает - Проверь покрытие через
npm run test:coverage; мокиopenaiв тесте не трогай
Как установить testing-patterns
Вручную: положить файлы
.claude/rules/testing-patterns.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/testing-patterns.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/testing-patterns.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/testing-patterns.mdВручную: положить файлы
.clinerules/testing-patterns.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о testing-patterns
Как установить testing-patterns в Claude Code?
Скопируйте файл правила в .claude/rules/testing-patterns.md внутри проекта.
Что делает testing-patterns?
Описывает агенту, как писать и запускать тесты на Vitest: структура файлов, моки зависимостей, одиночный прогон и покрытие.
На какие файлы действует правило?
Только на пути по маске src/**/__tests__/**, она стоит в шапке правила.
Исходный текст
testing-patterns.md · MIT
--- paths: - src/**/__tests__/** --- # Testing Patterns - Config: `vitest.config.ts` · Setup: `src/test/setup.ts` (auto-loaded) - Run all: `npm run test` · Single: `npx vitest run src/scoring/__tests__/accuracy.test.ts` - LLM calls globally mocked in `src/test/setup.ts` — never mock `@anthropic-ai/sdk`, `openai`, `@anthropic-ai/vertex-sdk` in individual tests - Use `vi.mock()` for `fs`, `child_process` · `vi.mocked()` for type-safe assertions - Colocated: `src/llm/__tests__/config.test.ts` tests `src/llm/config.ts` - Pattern: `describe` → `beforeEach(vi.clearAllMocks)` → `it` with `expect` - Env vars: save `process.env` in `beforeEach`, restore in `afterEach` - Coverage: `npm run test:coverage` (v8 provider, thresholds in `vitest.config.ts`)
© caliber-ai-org · MIT · caliber-ai-org/ai-setup