git.giacomolli.uk - onechat/blob - .agents/skills/check/SKILL.md

   1 ---
   2 name: check
   3 description: Format, lint, test, and build. Use before every commit.
   4 ---
   5
   6 # Check
   7
   8 Run every command in the Nix development shell. Use
   9 `nix develop -c COMMAND` when direnv does not load the shell.
  10
  11 ## Procedure
  12
  13 1. Format all files with `bin/format`.
  14 2. Run the checks with `bin/check`.
  15 3. Run `git add` on new files, then run `nix build` and
  16    `nix flake check`.
  17 4. Fix every failure and run the steps again. Do not disable a linter or
  18    add a `nolint` directive to get a pass, unless the user agrees.
  19 5. Review the final diff against the rules. Passing tools do not replace
  20    this review.
  21    - Read `AGENTS.md` and the `SKILL.md` of each skill of the task again
  22      from disk now. Do not work from memory of an earlier read.
  23    - Go through the diff one rule at a time, and for each rule look at
  24      every changed line that it covers. For Go code, check each section
  25      of `go-code`, also for the tests.
  26    - Fix each finding, then run steps 1 to 4 again.
  27
  28 Tell the user about each check that cannot run and each failure that
  29 stays.