Architecture
Systems design, infrastructure patterns, and the structural decisions that determine whether a project scales or collapses under its own weight.
13 posts
- 5 min read
The Green-Light Problem
The most expensive mistake in platform migrations isn't choosing the wrong platform. It's recommending one before you've validated the assumptions the recommendation depends on. A green light with unresolved checkpoints isn't a recommendation — it's a liability.
- 6 min read
SideMark: Building a Markdown Editor for Two Authors
Every markdown editor assumes one author. When AI agents became co-editors, the 'file changed on disk' dialog became a workflow killer. SideMark is what happens when you solve that problem from the inside.
- 5 min read
The Costume Change Problem
Switching your AI between 'CEO mode' and 'engineer mode' produces better output than one generic assistant. But when every role shares the same context window, review becomes self-review in a different hat. The real question isn't what persona your AI should wear — it's what your AI shouldn't know when it evaluates this work.
- 4 min read
Cognitive Property: Who Owns the Way You Think?
Your AI governance frameworks and decision-making logic are repeatable, transferable, and extractable. That's not a productivity feature. It's cognitive property.
- 6 min read
Cognitive Offloading
Every system I tried — notebooks, apps, even a custom AI tool — solved the capture problem but failed at retrieval. Cognitive offloading is the methodology behind it all: deliberately choosing what stays in your mind and building systems to handle the rest.
- 7 min read
The Governance Documents
ROADMAP.md, ARCHITECTURE.md, CLAUDE.md, and CHANGELOG.md aren't project management overhead. They're the system that gives AI agents persistent memory across sessions — and the mechanism that makes Pass@1 work.
- 7 min read
Governance Is Architecture
Most people treat AI governance as a compliance problem — policy documents, review committees, usage guidelines applied after the system is built. That's backwards. Governance is an architectural decision, and it needs to be designed in, not bolted on.
- 8 min read
The AI Perimeter: Where Automation Should End and Judgment Should Begin
AI is the most powerful tool most of us have ever had. That makes knowing when not to use it the actual skill.
- 9 min read
LLMs Are Practically ADHD
ADHD and LLMs share the same failure modes — context loss, confabulation, drift without governance. The coping architectures for one transfer directly to the other.
- 7 min read
Your Reminders Don't Work Because They're Too Predictable
Traditional reminder apps fail ADHD brains because predictability breeds dismissal. I built a Telegram bot with fuzzy scheduling, natural language, and a relentless nag mode.
- 5 min read
Your AI Builds the Code. Who Reviews It?
If the same AI agent that writes your code also reviews it, you have someone grading their own homework. I built an adversarial code review agent to fix that.
- 6 min read
Auto-Compaction Is Costing You Sessions
Claude Code auto-compacts at ~83% context usage. You lose the chance to control what's preserved. I built a script that warns you before it happens.
- 5 min read
What Is Pass@1?
Pass@1 is a development methodology where governance documents are thorough enough that AI generates correct implementations on the first attempt. Speed is a byproduct. Governance is the product.