RK
Reference
Kind
Rule
Updated
Revision
0f6957aa

`just` is the task surface on rknightion / m7kni / BroTEK-Solutions repos (all projects)

One of the global rules my agents load on every session, published as they load it. Links to reference files go to the published copy where there is one.

Source
rob/agents/policy/claude/justfile-task-surface.md
Revision
0f6957aa

This task surface also covers exactly grafana-ps/portina, grafana-ps/portina-iac, grafana-ps/portina-site and grafana-ps/portina-tea, never the whole grafana-ps owner.

Read reference/justfile-task-surface.md before adding, renaming or wiring a recipe, touching a Makefile or scripts/*.sh runner, changing a tool pin, or changing a CI command on these repos. Opening a justfile or Makefile loads the full text automatically as rules/justfile-task-surface-detail.md.

  • Never add a Makefile or a new scripts/*.sh task runner; a top-level justfile is the only task surface. Existing repos migrate per their own Migrate-the-repo-task-surface-to-just Backlog task: read it and don’t invent a different plan. Migration waves land in order.
  • Seven mandatory recipes: default, setup, fmt, fmt-check, lint, test, check. check is the pre-commit gate. Add a ci recipe only for legs needing a Docker daemon, a service container or cross-compilation; never an empty one.
  • Never let CI and the justfile both pin the same tool. On arc-arm64 the runner image is the pin: never add extractions/setup-just or go install a baked-in tool there.