{
  id          = "0004",
  slug        = "just-convention",
  description = "Justfile validates against the canonical module convention",
  check       = {
    tag         = "NuCmd",
    cmd         = "cd $env.ONTOREF_PROJECT_ROOT; $env.ONTOREF_ACTOR = \"agent\"; let r = (do { ^ontoref validate justfile --fmt json } | complete); if $r.exit_code != 0 { exit 1 }; let result = ($r.stdout | from json); if $result.ok { exit 0 } else { exit 1 }",
    expect_exit = 0,
  },
  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
",
}
