loci.nvim

Use when writing a scripts/tasks/processes entry or a manager module. Covers which surface to use, guarding enterShell echoes, and the 0/1/2/3 exit contract.

Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.

Use when you edited a modules/ file, devenv.nix, or env.* and nothing changed. Resolves the lock + eval-cache staleness loop.

Use when starting a server or any long-running / heavy task. Use processes + devenv up; don't block the shell; poll logs instead of piping out of view.

Use on ModuleNotFoundError or import failures inside the devenv shell, or after a fresh venv. The venv exists but deps may not be installed.

Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.

Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.

Route ALL version control through gitman (jj + colocated git). Never run raw jj/git.

Start here for any work in this repo. Routes to the right manager and owns the lifecycle order (verify before save, scaffold before change).