incremental-verify — правило для Claude Code
Правило incremental-verify держит агента на шаге «один падающий тест — минимальная реализация — коммит», чтобы тесты описывали написанный код, а не воображаемый.
MIT ★ 2 966 обновлён 2026-09-29
.cursor/rules/incremental-verify.mdcЧто делает incremental-verify
Правило задаёт порядок работы с тестами: один падающий тест, минимальная реализация, коммит, повтор. Пока поведение не написано, честно проверить его нельзя. Тесты, сочинённые заранее, описывают воображаемый код, ловят не те регрессии и ломаются от безобидного рефакторинга.
Внутри — принцип, чек-лист из четырёх вопросов и три типовые ошибки: проверка формы объекта вместо наблюдаемого результата, тесты, которые только настраивают моки, и «зелёный до красного». Последняя примета простая: если все тесты прошли с первого запуска, они не управляли дизайном.
Исключение одно — разведочные спайки на незнакомом API. Их ветку помечают как выбрасываемую, а тесты не мержат. В frontmatter стоит alwaysApply: true, так что правило действует в каждой сессии; на спайке это значит, что помечать ветку нужно сразу, а не задним числом.
Какие задачи решает
- разбить фичу на шаги: падающий тест, минимальная реализация, коммит
- поймать тесты, которые проверяют форму объекта вместо результата для вызывающего кода
- переписать тест, который только настраивает моки и проверяет их вызов
- заметить подозрительно зелёный прогон, где ни один тест не падал
- отделить разведочный спайк от кода, который пойдёт в основную ветку
Примеры запросов агенту
- Начни с одного падающего теста на валидацию
email, потом минимальная реализация и коммит. - Прогони чек-лист
incremental-verify: есть ли сейчас ровно один падающий тест? - Это разведочный спайк на незнакомом API — помечай ветку как выбрасываемую, тесты не мержим.
Как установить incremental-verify
Вручную: положить файлы
.cursor/rules/incremental-verify.mdcВо frontmatter: description, globs, alwaysApply
1Через маркетплейс плагинов
/plugin marketplace add rohitg00/pro-workflow/plugin install pro-workflow@pro-workflow2Вручную: положить файлы
.claude/rules/incremental-verify.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/incremental-verify.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/incremental-verify.mdВручную: положить файлы
.clinerules/incremental-verify.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы об incremental-verify
Как установить incremental-verify в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add rohitg00/pro-workflow, затем поставьте плагин: /plugin install pro-workflow@pro-workflow.
Что делает incremental-verify?
Запрещает писать тесты пачками до реализации. На каждое поведение — одна падающая проверка, минимальный код, который её закрывает, и коммит.
Когда можно отступить от правила?
На разведочном спайке, когда вы прощупываете незнакомый API. Ветку помечают как выбрасываемую, а её тесты не попадают в мерж.
Исходный текст
incremental-verify.mdc · MIT
--- description: Verify each behavior before building the next. One test, one implementation, one commit. No bulk-writing tests for behavior that does not yet exist. globs: alwaysApply: true --- # Incremental Verification ## Principle Behavior you have not written cannot be tested honestly. Writing many tests before any implementation produces tests shaped by **imagined** behavior, not actual behavior — they assert on function signatures and data shapes, survive real regressions silently, and break on harmless refactors. ## Rule For every new behavior: write one failing assertion, write the minimum implementation that makes it pass, commit, repeat. No batched test authoring. No scaffolding dozens of test cases before a single green run. ## Checklist - [ ] Is there exactly one failing test right now? If more, split the commit. - [ ] Does the test exercise a public interface a caller would actually hit? - [ ] Would the test still make sense after a full internal refactor? - [ ] Was the implementation written **after** seeing the test fail? ## Failure modes to catch - "Shape tests": asserting on object keys, array length, or types rather than observable output. Rewrite against a caller's perspective. - "Mock-driven tests": the test mostly configures mocks then asserts the mock was called. Move the mock to a system boundary or delete it. - "Green before red": if every test you wrote passed on the first run, the test did not drive the design — treat it as suspect. ## When to break the rule Exploratory spikes where you are probing an unknown API. Mark the spike branch as throwaway and do not merge its tests.
© Rohit Ghumare · MIT · rohitg00/pro-workflow