Blog
Notes on technical documentation, AI workflows, content systems, and developer experience.
Subscribe via RSSDoes more reasoning actually lead to better decisions, or just more latency? After testing an AI 'thinking' mode on my personal job-search tool, I found that marginal gains don't make up for the 7x increase in time for a daily workflow.
After years of fighting clunky spreadsheets on my phone, I realized the problem wasn't the data, but the interface. Here is how I used AI orchestration to build a custom, mobile-first finance dashboard without writing traditional code.
A few days ago I wrote about how I built a tool to automate my job hunting process. The feedback I got was that it would be useful for others, so I made it available for anyone to use. Here's how I scaled my personal tool into a public one.
Stop scrolling, start applying. I built a system that scrapes job boards, filters out the noise with local LLMs, and only pings my phone when there is actually something worth my time. A look at my hybrid approach to using AI as a career tool rather than a replacement.
This morning I heard sirens. High temperatures means fire season, so I wondered: what if there was a way I could be warned of a nearby wildfire before smoke filled my apartment? That's how I built a real-time notification app powered by volunteer data.
I've changed the title on my own website four times this month: Technical Writer, then Knowledge Engineer, then back. I know exactly what I do. I just can't find the word for it. Here's what the back-and-forth was actually telling me.
The label I've been using for five years — technical writer — is accurate and fundamentally misleading at the same time. Accurate, because I write. Misleading, because writing is the output, not the work.
There is a version of the AI narrative that tells you that AI writes content, therefore writers are obsolete. However this hasn't been my experience after a few months of building AI deeply into my daily workflow. AI has enabled me to do my job even better. Here's how.
As a technical writer, there are a lot of repetitive tasks I have to do manually that eat into my time. Over the past couple of months I've been building a system of AI-assisted workflows that handles the mechanical parts of my job — the parts that eat hours without requiring much creative judgment. And it's genuinely changed how I work.
A colleague of mine built a system he calls Project Brains. The AI reads the context file first and starts every conversation already knowing what it needs to know. His core insight is that AI assistants become dramatically more useful when they have structured context to work from, not just raw files. So I built a system that captures those decisions automatically for my workflow, and makes them available in every future session.
Over the past month or so I've built 22 slash commands that automate different parts of my documentation workflow with OpenCode. But at some point around command number 15, I noticed that I didn't know what commands I had. So I built an automated system that lets the AI discover commands for me and suggests the best one bases on intent.
The other day I closed a P1 ticket that asked me to review a 5-lesson internal training course and figure out what was missing from our developer docs. The scope was big: compare the training material against hundreds of existing pages, identify content gaps, draft new conceptual documentation, and create follow-up tickets for anything out of scope. Normally, this kind of work takes the better part of a week. Research alone — reading the training, cross-referencing existing docs, searching the wiki, identifying stakeholders — can easily take a few days at least before you write a single word. This was exactly why I've created a while back the `/research` command in [OpenCode](https://opencode.ai). Recently, I got to put it to the test for the first time with a big task, and the whole thing went from ticket to merged PR in about two working days.
A few months ago, I was asked to lead the documentation side of a large product renaming project. So I build a whole toolkit with the help of AI to automate and accelerate this project.
Tech writers spend a lot of time researching before they can start writing. Gathering context for a Jira ticket means jumping between several other tickets, existing documentation, internal wiki pages with PRDs or technical specs, among other sources. To help speed up the process of researching, I've used OpenCode to create a command that reads Jira tickets and researches all the appropriate sources.