CheckcraftПравила для Cursor и Claude Code: файл проверки после каждой правки API
Checkcraft — программа для проверки API и логов без кода, есть бесплатная версия. Скачать без регистрации →
Агент быстро правит код и так же быстро может сломать ответ API. Несколько строк в правилах проекта заставляют его оставлять файл проверки, который можно запустить независимо от него.
Текст правила
Один и тот же текст подходит для всех инструментов ниже.
## Проверки API
После каждого изменения, которое затрагивает ответ API:
1. Создай или обнови файл checks/<операция>.testcase.json для программы Checkcraft.
2. Ожидаемые значения бери из требований задачи. Если их нет, спроси меня.
3. Не меняй ожидаемое значение ради зелёной проверки без моего согласия.
4. В ответе назови, какие файлы проверки изменились и какие требования они покрывают.
Формат файла:
{"exportType":"test_case","formatVersion":1,"name":"название","description":"","steps":[]}
Шаги в steps:
{"type":"VALIDATE_FIELD","params":{"field":"status","operator":"equals","value":"PAID","typeCheck":"is_string"},"runWhen":null}
{"type":"CALCULATE_VARIABLE","params":{"variableName":"expectedTotal","expression":"sum(\"$.items[*].amount\")"},"runWhen":null}
{"type":"VALIDATE_FIELD","params":{"field":"total","operator":"equals","value":"%expectedTotal%"},"runWhen":null}
{"type":"WHITELIST","params":{"source":"current","rules":"root: orderId, status, total"},"runWhen":null}
operator: equals, not_equals, contains, not_contains, >, >=, <, <=, notEmpty
typeCheck: is_string, is_integer, is_boolean
value всегда пиши строкой. Других шагов и параметров не придумывай.Cursor
Создайте файл .cursor/rules/checkcraft.mdc. В начале файла укажите, что правило действует всегда:
---
description: Файл проверки Checkcraft после изменений API
alwaysApply: true
---Ниже добавьте текст правила. Cursor учитывает только расширение .mdc в этой папке. Он также читает AGENTS.md в корне проекта, это более простой вариант без настроек. Старый файл .cursorrules считается устаревшим.
Claude Code
Добавьте текст правила в CLAUDE.md в корне проекта. Claude Code читает этот файл в начале каждой сессии. Файл AGENTS.md он сам не читает, поэтому если правила уже лежат там, импортируйте их строкой @AGENTS.md из CLAUDE.md.
Другие агенты
Многие агенты читают AGENTS.md в корне проекта. Если ваш инструмент его не поддерживает, вставьте текст правила в начало задачи.
Что правила не гарантируют
Агент может пропустить правило, поэтому в конце задачи проверяйте, что файл действительно изменился. Само по себе наличие файла ничего не доказывает: запустите его на правильном и заведомо неверном ответе. Запускать проверки на сервере сборки можно через checkcraft-cli, об этом есть руководство по CI. В Free в наборе для сервера сборки до 3 проверок.
Запускайте то, что подготовил агент
Checkcraft открывает файлы проверки и запускает их независимо от агента: вручную или на сервере сборки. Free работает на Windows и Linux без ограничения срока.
Скачать FreeКак получить и запустить приложениеСкачивание без регистрации и почты, архив готов за пару минут. Состав бесплатной версии опубликован на странице тарифов.
Документация для сверки
Материал сверен 4 ноября 2026 года. Claude Code о файле CLAUDE.md.