just runs the recipes, not Make
Decided with Cansin on 2026-11-02, #492 (the research is its body: Make, just and Task side by side). Amended 2026-11-02 (#547): the older ADRs’ commands to run are
justrecipes; their history keepsmake. Amended 2026-11-02 (#611): Claude Code’s own deny list in.claude/settings.json, not a hook of ours, keeps the heavy recipes for CI.
The Makefile had grown to 44 targets with one real file dependency; the rest were commands. About 33 of its 54 commits
on main edited the one shared .PHONY line, so two PRs adding a target clashed, and the Claude Code hook found the
heavy targets with a regex over rule headers. So the commands live in a justfile and run with
just:
- One pin. just comes with the dev dependencies (
rust-justin pyproject, locked in uv.lock), so CI runsuv run just <recipe>and needs nothing else installed; the CI images dropmake. - No
.PHONY, groups instead of a regex. A recipe that takes the heavy lock is in[group('heavy')]; Claude Code’s deny list names each recipe in it, and tests read the group fromjust --dump --dump-format jsonto hold the list and every recipe that uses the lock to it. - Comments are the help.
just --listshows each recipe with the comment above it. - Arguments after the recipe, variables before it:
just view noggin-neck,just BLENDER=blender pictures. - Up to date stays ours. just has no timestamps (its
[cache]is unstable);ourskeeps its.key, the trajectories their stamps, and the MicroPython build checks for its binary.
The ADRs before this one keep the make words of their day where they record what was done; where they say
what to run, they name the just recipe.
Considered options
Section titled “Considered options”- Make with one
.PHONYper target: the smallest change, but the hook’s regex and the merge clashes on inserts stay. - Task (Taskfile.yml): checksums we can’t use (
ourshashes an import graph, not globs), parallel dependencies that would racevenv, task variables that win over the command line, and a hook that would have to regex YAML.
noggin v0.2.26-6-g09bf9b7 · 09bf9b7