Changelog

This document tracks the evolution of the Agentic Engineering with Clojure manual.

[0.5.0] - 2026-03-17

Changed

  • Expanded repl-development.rst from stub placeholders into a full chapter:

    • What is the REPL? – Introduced the REPL concept and its role in preventing LLM hallucinations

    • Starting the REPL – Added deps.edn setup for nrepl and cider-nrepl, startup commands, and clj-nrepl-eval connection example

    • Reload – Added clj-reload integration and the passive-prompting technique of printing docstrings on namespace load

    • Interactive Development – Explained REPL-grounded workflow for LLM agents: evaluation gives facts from the running system instead of guesses from training data

    • The REPL as Hallucination Prevention – New section covering:

      • Validation-before-saving discipline with a sum-evens worked example

      • Exploration-before-use pattern using clojure.repl/doc, dir, apropos, find-doc, and source

      • Codebase awareness via require + clojure.repl/dir

    • The Paren Edit Death Loop – Documented the delimiter-repair cycle that LLM agents fall into and how clj-paren-repair breaks it

    • Passive Prompting Through the REPL – Technique for printing docstrings on dev-namespace reload to keep agents informed without repetition

    • Best Practices – New sub-sections on keeping the nREPL process running, test fixtures and clojure.test/run-test-var, and pipeline debugging with intermediate def bindings

[0.4.0] - 2026-03-05

Added

  • Added reusable LLM agent prompt templates (common-user-prompts.rst)

  • Added this changelog

[0.3.0] - 2026-03-04

Added

  • Git Hygiene workflow for automated commit message validation

  • GitHub Actions integration for pull request checks

  • Local LLM model support for commit linting via iwillig/git-hygiene action

[0.2.0] - 2026-03-04

Added

  • PI Agent configuration guide and setup instructions

  • Enhanced agentic toolchain documentation

  • Integration patterns for local LLM models

[0.1.0] - 2026-03-01 to 2026-03-04

Added

  • Project README with build instructions and prerequisites

  • Comprehensive installation guide covering: - Homebrew setup for macOS - SDKMAN for JVM/Clojure management - OpenCode AI agent installation - Gonodlin browser automation tool - PI Agent configuration

  • Agentic browser automation chapter (agentic-browser.rst) with Etaoin examples

  • REPL-driven development best practices

  • Testing strategies for agentic workflows

  • Sphinx documentation configuration and build system

  • Basic project structure with reStructuredText source files

  • Makefile and Windows batch build scripts

  • Python dependencies via Pipfile (Sphinx, Etaoin)

  • Clojure dependencies for code examples (deps.edn)

  • Babashka tasks for nREPL management (bb.edn)

Changed

  • Improved documentation layout and sidebar navigation

  • Fixed width constraints for better readability

Initial Commit - 2026-02-26

  • Created Sphinx documentation project structure

  • Added introduction chapter explaining the manual’s purpose

  • Established foundational vision: Clojure’s relevance in the age of LLM agents