Markdown and Claude Code
My business notes as plain markdown files in git: one folder that I, my agents and my scripts all read.
Read the articleClients, tasks, money and decisions live in a folder of markdown files. Agents read it and propose; I accept.
Read: I'm Moving My Whole Business Onto Markdown and Claude Code- What it is
- My system
- On my tools page
- Running the business
- Updated
- November 2026
Where I write about Markdown and Claude Code
Articles on this site that mention it.
Jun 3, 2026 · AI
I'm Moving My Whole Business Onto Markdown and Claude Code
Plain markdown files as the single source of truth for my business. Everything else, the AI included, reads from them, derives from them, or is a view.
Nov 6, 2026 · AI
How I'm Building an AI Marketing Factory
One sentence in, a checked carousel, story set and reel out. How my AI marketing factory is built, what a week of it cost, and which calls stay mine.
Sep 9, 2026 · AI
The Bug That Regenerated My AI Summaries 2,575 Times
My AI's own writes kept re-arming its trigger: 2,575 summary rewrites in two weeks. The fix: regenerate when the inputs change, never on a clock.
Nov 12, 2026 · Engineering
The 4.7 MB File I Didn't Split
A 4.7 MB JSON file crashed my app on read, and splitting it looked obvious. I timed it first: 13 ms. The bug was in how the file was written.
Oct 16, 2026 · AI
My AI Agents Can't Write. They Propose, I Accept.
I took the write tools away from every AI agent in my system. Nothing got slower. Everything got safer.
Aug 12, 2026 · AI
Before You Ship Your First AI Feature: A Checklist
Eight things I put in place before an AI feature touches real data, learned the hard way on the system I run my business on.