Introduction This essay is a reflection on using LLM agents with the Clojure programming language. At Shortcut , we have spent the last year building Korey , an LLM agent focused on product management. During that time, we have attempted to use different LLM agents to work with our rather large Clojure code base, ~250,000–300,000 lines of Clojure code. In doing so, we discovered a lot. I hope this…
Dyslexia is a difference in the way the brain processes language. It is often defined as the difference between intelligence (vaguely defined via the fake IQ test) and a person's ability to read. That is, a dyslexic with normal intelligence will underperform compared to their peers in learning how to read. There are many different theories on what the cause is, but most people believe that there…
Introduction The blog post describes how I use pandoc and Slidy WC3 to build engineering focused presentations. Software engineering requires a lot of communication with stakeholders, your colleagues, and to LLM agents. There are many ways you can build a presentation these days, but I often find myself using Pandoc 's presentation mode. Pandoc allows me to write a presentation as a simple…
I've migrated this blog to a new setup. Here's how it works now: Stack Lektor - Static site generator with a nice content model Pandoc - Builds my resume from YAML to HTML just - Command runner for build tasks GitHub Actions - Automatic deployment on push to main PureCSS - Lightweight CSS framework How It Works Content lives in YAML and Lektor's .lr files. The build process: just resume - Pandoc…
Pandoc is a markup transformation tool that converts documents between formats. It's an invaluable tool for any software engineer who works with documentation. In this guide, we'll build a "technical manual" using Pandoc. Our manual will be a collection of Markdown documents with PlantUML diagrams. We'll use Pandoc to combine these documents into a single HTML page, rendering PlantUML diagrams as…
Note: This post is a bit out of date. I no longer use GNU Guix and Haunt for this blog. Instead, I've migrated to Lektor as my static site generator, with Pandoc still handling resume generation. Welcome to Software Wanderings, a technical blog where I'll be documenting my experiences, learnings, and observations about software engineering. I hope this blog will encourage me to write about my…