| name | run-and-verify |
| description | Use after changing CLIST Python code to pick and run the correct, narrowest checks — Django tests, Ruff lint/format, or running a management command in the dev container — before considering work done. Keywords: test, run tests, lint, ruff, verify, check, manage.py, docker compose exec. |
Run & verify CLIST changes
The dev service is long-running and hosts runserver + RQ workers. Run
commands inside it; don't start a second server.
Choose the narrowest check first, then widen
Reality check on the test suite: CLIST's <app>/tests.py files are mostly
stubs (SimpleTest doing assertEqual(1, 1)). Real coverage is near zero, so a
green test run is weak evidence of correctness. Treat it as a smoke check that
the app imports and the runner works — the real verification is running the
actual management command / RQ job / parser in the dev container and inspecting
its output. Add real tests alongside new behavior when feasible.
Tests (Django runner; <app>/tests.py):
docker compose exec dev ./manage.py test <app>.tests.SomeTest.test_x
docker compose exec dev ./manage.py test <app>
docker compose exec dev ./manage.py test
Lint / format (Ruff, config in .ruff.toml, line length 120, double quotes):
mise exec -- ruff check src/path/you/changed.py
mise exec -- ruff format src/path/you/changed.py
Run Ruff from the host through mise. JS/CSS/JSON use Biome (biome.json).
Run a management command (e.g. to exercise a parser or check a job):
docker compose exec dev ./manage.py <command>
docker compose exec dev ./manage.py shell
Order of operations after an edit
- Most specific test for the touched module.
- If it passes, the app's test group.
- Full suite only when the change is broad.
ruff check (and ruff format) on changed files.
- Fix root causes, not symptoms. Don't weaken assertions or silence errors to
make checks pass.
If a check can't run, say exactly why and give the human the command to run.
When done, report
Which commands ran, their results, what you fixed, and anything left unverified.