diff --git a/.editorconfig b/.editorconfig
index fc6650c..6c922ce 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -63,6 +63,6 @@ indent_size = 2
 indent_style = space
 indent_size = 4
 
-[justfile]
+[*.just]
 indent_style = space
 indent_size = 4
diff --git a/.gitattributes b/.gitattributes
index 6d99ca0..fe6730c 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -37,7 +37,7 @@
 .gitattributes text eol=lf
 .editorconfig  text eol=lf
 .tool-versions text eol=lf
-justfile       text eol=lf
+*.just         text eol=lf
 Makefile       text eol=lf
 Containerfile  text eol=lf
 
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index c118a33..a3e2b7d 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -15,7 +15,7 @@ toolbox enter jaffascript-dev
 # Install dependencies manually
 
 # Verify setup
-just check   # or: cargo check / mix compile / etc.
+just jaffa check examples/hello.affine   # type-check an example
 just test    # Run test suite
 ```
 
diff --git a/.machine_readable/contractiles/Justfile b/.machine_readable/contractiles/Justfile
index 43cce32..290f655 100644
--- a/.machine_readable/contractiles/Justfile
+++ b/.machine_readable/contractiles/Justfile
@@ -18,6 +18,9 @@ set positional-arguments := true
 # Re-generate with: contractile gen-just
 import? "contractile.just"
 
+# JaffaScript task runner (check, run, build, preview, lint, hello): `just jaffa <recipe>`
+mod? jaffa "jaffa.just"
+
 # Project metadata — customize these
 project := "rsr-template-repo"
 OWNER := "hyperpolymath"
diff --git a/EXPLAINME.adoc b/EXPLAINME.adoc
index 46a2b9c..9292031 100644
--- a/EXPLAINME.adoc
+++ b/EXPLAINME.adoc
@@ -26,7 +26,7 @@ Key principle: *Different faces, same cube.*
 |`examples/` |JaffaScript examples showing face-specific syntax
 |`docs/` |JaffaScript-focused documentation
 |`tests/` |Face transformer regression tests
-|`justfile` |Common tasks: `check`, `run`, `build`, `preview`, `lint`
+|`jaffa.just` |Common tasks, run as `just jaffa <task>`: `check`, `run`, `build`, `preview`, `lint`, `hello`
 |`.github/` |GitHub workflows and issue templates
 |===
 
diff --git a/Justfile b/Justfile
index 43cce32..290f655 100644
--- a/Justfile
+++ b/Justfile
@@ -18,6 +18,9 @@ set positional-arguments := true
 # Re-generate with: contractile gen-just
 import? "contractile.just"
 
+# JaffaScript task runner (check, run, build, preview, lint, hello): `just jaffa <recipe>`
+mod? jaffa "jaffa.just"
+
 # Project metadata — customize these
 project := "rsr-template-repo"
 OWNER := "hyperpolymath"
diff --git a/README.adoc b/README.adoc
index 94a1085..a881502 100644
--- a/README.adoc
+++ b/README.adoc
@@ -73,9 +73,9 @@ affinescript compile --face jaffa examples/hello.affine -o hello.wasm
 ./bin/jaffa eval examples/hello.affine
 ./bin/jaffa compile examples/hello.affine -o hello.wasm
 
-# Or via the justfile:
-just run examples/hello.affine
-just preview examples/hello.affine    # show the canonical lowering
+# Or via the `jaffa` just module (jaffa.just):
+just jaffa run examples/hello.affine
+just jaffa preview examples/hello.affine    # show the canonical lowering
 ----
 
 Source files use the canonical `+.affine+` extension. The face is
diff --git a/justfile b/jaffa.just
similarity index 84%
rename from justfile
rename to jaffa.just
index eaccf70..8d12a1b 100644
--- a/justfile
+++ b/jaffa.just
@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: MPL-2.0
 # SPDX-FileCopyrightText: 2024-2026 Jonathan D.A. Jewell (hyperpolymath)
-# justfile — JaffaScript task runner
+# jaffa.just — JaffaScript task runner, a module of the root Justfile: `just jaffa <recipe>`
 
 default:
-    @just --list
+    @just --list jaffa
 
 # Type-check a file
 check FILE: