Add introduction

Author: iwillig

source/conf.py

@@ -6,7 +6,7 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project = 'Intentional development with LLM and Clojure'
+project = 'Agentic Engineering with Clojure'
 copyright = '2026, Ivan Willig'
 author = 'Ivan Willig'
 

source/index.rst

@@ -3,15 +3,38 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Intentional development with LLM and Clojure documentation
-==========================================================
+Agentic Engineering with Clojure
+================================
 
-Add your content using ``reStructuredText`` syntax. See the
-`reStructuredText <https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`_
-documentation for details.
+This book is a guide on how to best use the Clojure Programming
+language and LLM coding agents. It is a reflection of a year of
+constant use. I hope this book helps you get the most out of Clojure
+and LLM agents.
+
+Why
+----
+
+Clojure is a dynamic, lisp designed for the JVM. It is unorthodox in
+many ways. In an age of typed languages with C syntax, Clojure stands
+out. It is focused, concise and functional. Its S Expression based
+syntax is unusual. In the era of LLM agents, where the training data
+set is dominated by TypeScript, Python and C, there is a fear that
+more unorthodox languages will come under threat.
+
+Over the past year, intense development with LLM based agents has led the
+authors of this book to the opposite conclusion. The fundamentals of
+the Clojure language make it an excellent language for agentic
+development. Specifically, Clojure’s focus on functional programming,
+REPL based development and intentional development lends itself to the
+age of Agentic Engineering.
+
+The author's hope is that this book will keep Clojure relevant in this
+era.
+
+Installation
+------------
 
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
-