diff --git a/docs/scheduler/ci.md b/docs/scheduler/ci.md
index 5ea53aaf..6d1ced37 100644
--- a/docs/scheduler/ci.md
+++ b/docs/scheduler/ci.md
@@ -36,11 +36,11 @@ defined in [`.forgejo/workflows/ci.yml`](../../.forgejo/workflows/ci.yml). All
 three are required checks (forge branch protection) — a hit on any of them
 blocks merge.
 
-| Job                    | What it runs                                                                              |
-| ---------------------- | ----------------------------------------------------------------------------------------- |
-| **nix flake check**    | treefmt + rustfmt formatting, `cargo clippy -D warnings`, `cargo test`, module evaluation |
-| **tracker-tag lint**   | flags `#NNN` issue tags in source and comments (`scripts/check-issue-refs.sh`)            |
-| **comment-block lint** | flags contiguous comment blocks over 30 lines (`scripts/check-comment-blocks.sh`)         |
+| Job                    | What it runs                                                                      |
+| ---------------------- | --------------------------------------------------------------------------------- |
+| **nix flake check**    | treefmt formatting, `cargo clippy -D warnings`, `cargo test`, module evaluation   |
+| **tracker-tag lint**   | flags `#NNN` issue tags in source and comments (`scripts/check-issue-refs.sh`)    |
+| **comment-block lint** | flags contiguous comment blocks over 30 lines (`scripts/check-comment-blocks.sh`) |
 
 `hive-forge ci-rerun --pr N` dispatches a `workflow_dispatch` retrigger
 without an empty commit.
@@ -69,7 +69,7 @@ wastes a remote-builder slot. Use the devshell equivalents instead:
 ```sh
 nix develop -c cargo clippy --all-targets -- -D warnings
 nix develop -c cargo test
-nix develop -c treefmt          # same as nix fmt; treefmt covers rustfmt + nixfmt + taplo
+nix fmt                         # authoritative; the formatter set is nix/treefmt.nix
 sh scripts/check-issue-refs.sh  # tracker-tag lint
 sh scripts/check-comment-blocks.sh  # comment-block lint
 ```