carlos-algms / agentic-testing
mini.test red/green loop, revert check, and which test references to load. Use before creating, editing, or reviewing tests, and before TDD behavior changes.
Agentic Testing
The rules are in tests/AGENTS.md. Read it first. This skill holds the
procedure.
TDD procedure
For every bug fix or behavioral change:
- Bootstrap missing symbols first so the test loads.
- Write the failing assertion.
Run
make test-file FILE=<path>and confirm it fails for behavior, not
setup:- wrong: missing module, nil method, syntax error, unresolved import
- right: value/state/output mismatch
- Implement the minimum code to pass.
- Fix and re-run
make test-file FILE=<path>until green. Revert check: undo the fix (keep the test), run
make test-file FILE=<path>, and confirm red. Restore the fix. Still green
with the fix undone = the test does not discriminate; rewrite it (see "A
test must be able to fail" intests/AGENTS.md). A test that exists only to
force a type check goes red undermake luals, notmake test-file; run
the revert check there.
Use make test-file FILE=<path> for the whole loop. It runs one file in
seconds.
Load references only when needed
references/assert-spy.md: custom assert, spy, and stub API detailsreferences/child-nvim.md: child process tests and RPC helpersreferences/async-tests.md: scheduled and deferred code