ontoref/reflection/migrations/0004-just-convention.ncl

{
  id          = "0004",
  slug        = "just-convention",
  description = "Justfile validates against the canonical module convention",
  check       = {
    tag     = "Grep",
    pattern = "project_root\\s*:=",
    paths   = ["justfile"],
  },
  instructions = "
Run the validator to see what is missing:
  ONTOREF_ACTOR=agent ontoref validate justfile

Fix each violation:

missing required modules (build, test, dev, ci):
  Create justfiles/{name}.just with at minimum:
    [doc(\"Show {name} help\")]
    help:
        @just --list
  Add to root justfile:
    import 'justfiles/{name}.just'

missing required recipes (default, help in root justfile):
    default:
        @just --list
    [doc(\"Show available recipes\")]
    help:
        @just --list

missing required variables:
    project_root := justfile_directory()

Verify:
  ONTOREF_ACTOR=agent ontoref validate justfile
",
}