Keep Clojure repositories reviewable by ignoring build and REPL artifacts, standardizing formatting, committing source truth rather than live REPL state, and documenting runnable commands.
Git is the same tool you already know, but Clojure projects tend to generate a different set of artifacts and benefit from consistent formatting.
target/, caches, editor/REPL artifacts).src/ and test/.| Repo hygiene item | Why it matters |
|---|---|
.gitignore for build outputs |
Prevents generated jars, caches, and test artifacts from polluting reviews |
| Consistent formatter | Reduces noisy diffs in parentheses-heavy code |
| Reproducible commands in README | Lets Java teammates run the REPL, tests, and packaging without guessing |
| Small commits | Makes data-shape and namespace changes easier to review |
| CI test command | Catches “works only in my REPL” mistakes before merge |
Practical tip: a clean
.gitignoreplus consistent formatting removes a lot of friction in Clojure code reviews.
This section focuses on the small repo hygiene choices that keep teams productive over time.