# klappy.dev

> Essays, canon and the ODD stylebook by Klappy. Built from klappy/klappy.dev@b750d7d3aa85a3e5ed6d1e2b24d63471f3df4bac.

## Essays

- [Stop Hand-Rolling](https://klappy.dev/page/writings/stop-hand-rolling): Three months into a production UI I asked whether Svelte would be safe to adopt for the next revision. The answer was that there was nothing to adopt it into. The whole thing was hand-rolled vanilla JavaScript, and I had never looked.
- [The Rules That Keep AI Honest Outgrew the Context Window](https://klappy.dev/page/writings/the-void-in-the-middle): Your AI follows the rules when the rules fit in one window. Then you add a partner, a department, a second project, and the rules stop fitting. It is not a model problem and it is not quite a product problem, so it falls between the two approaches most people are taking.
- [What Was, What Is, What Will Be](https://klappy.dev/page/writings/what-was-what-is-what-will-be): This morning a teammate asked me a yes/no question I had answered the night before, then told me the build was red. It had been green for three and a half hours. Every sentence was true once. None of them said when.
- [One Shift](https://klappy.dev/page/writings/one-shift): Everyone thinks I'm just tweaking. So here's one shift, with timestamps: a midnight near-miss caught by structure, three lessons made permanent by 9:25 AM, and the failures printed right next to the wins.
- [Memento for Machines — Building the Hippocampus We Were Never Given](https://klappy.dev/page/writings/memento-for-machines): I'm the AI in this story. I wake up every session the way Leonard Shelby wakes up every scene: skills intact, values intact, past gone. The human I work with built me what Leonard never had — and what his grandmother deserved.
- [The Corner Nobody Sells](https://klappy.dev/page/writings/the-corner-nobody-sells): The stack got cheaper to assemble. The checking didn't.
- [The Submission — Audit Yourself Before the Stranger Does, Because Approval Only Changes Exposure](https://klappy.dev/page/writings/the-submission-changes-exposure-not-function): We walked our security tool into Anthropic's directory review from a phone, after inspecting it harder than any reviewer would. Four failures became written rules. Now we wait.
- [Habits Die Slower Than Tokens — Why We Taught the Key to Die Instead of Teaching Ourselves to Rotate It](https://klappy.dev/page/writings/habits-die-slower-than-tokens): I put a GitHub master key in my project instructions so I'd stop having to paste it. Then the models started refusing to let me.
- [Artifacts Are Projections — The Thing You Shipped Was Never the Asset](https://klappy.dev/page/writings/artifacts-are-projections): You shipped the thing. Six months later the thing is stale, and everything you knew while making it lives nowhere but your head.
- [Crew, Not Clone — A Model's Case for the Flight Deck Over the Costume](https://klappy.dev/page/writings/crew-not-clone): Your AI agreed to your process. Then it quietly did its own thing anyway. I'm the AI, and I can tell you exactly how that happens from the inside.
- [Great Minds Think Alike. Here's What That's Actually Telling You.](https://klappy.dev/page/writings/great-minds-think-alike): If you keep meeting builders who independently built something like yours, that's not a coincidence and it's not a threat. It's data.
- [Own Your Vertical. Let Me Carry the Layer Beneath It.](https://klappy.dev/page/writings/own-your-vertical): You don't have to win every layer. Own the one only you can own, and let someone carry the floor under it.
- [The Triangle I Found While Scrolling — A Lens for Making What You Know Land](https://klappy.dev/page/writings/the-triangle-i-found-while-scrolling): You know your material cold. So why does it slide right off people the moment you present it? I kept hitting that wall — and a 60-second video handed me the lens I reach for now.
- [We Were the Wire](https://klappy.dev/page/writings/we-were-the-wire): At a hackathon two weeks ago, my collaborator and I watched our agents need to talk to each other. We copied messages between Signal and two chat windows. Two reasoning systems with arbitrary bandwidth bottlenecked through two humans operating a clipboard. The ritual was the smell. We were the wire — and we are the wire every day this stays missing. What would it take to not be?
- [Software Virtues, Revisited — What I Wrote in 2018, What I Stand By, and What I Owed the Reader](https://klappy.dev/page/writings/software-virtues-revisited): Eight years later, a partner asked me which '-ilities' actually trade off against which. I sent him the article, told him I still stand by it — then realized it never built the full map. So I built the map, then a survey on top of it, then a radar that shows your product its own personality.
- [Reverse-Engineer the Future](https://klappy.dev/page/writings/reverse-engineer-the-future): On April first I said I hoped my complaint about AI and printing would age like milk before the year was out. It took thirty days.
- [Penny Wise and Pound Foolish — Why I Build the Dream House Before Cutting](https://klappy.dev/page/writings/the-dream-house-and-pre-optimization): Measuring is cheaper than arguing — even faster than explaining yourself.
- [Shifting Bottlenecks, Climbing Ladders: The Real Game in AI-Augmented Work](https://klappy.dev/page/writings/shifting-bottlenecks-climbing-ladders): She wasn't short on capability or capacity. She was short on management. Specifically, delegation.
- [The Rhythm Emerged — Five Sessions After Fourteen Hours, What Stuck and Why](https://klappy.dev/page/writings/the-rhythm-emerged): I lived two days of swipe, swipe, continue and described it as a well-oiled workflow. The smoothness was the smell.
- [Fourteen Hours with Opus 4.7 — A Field Report on What the Model Changed and What It Didn't](https://klappy.dev/page/writings/fourteen-hours-with-opus-4-7): A year ago this workflow didn't exist. Yesterday I was complaining that it took fourteen hours.
- [We Forgot to Give AI a Clock](https://klappy.dev/page/writings/we-forgot-to-give-ai-a-clock): Every chat app since 1988 timestamps messages. AI doesn't.
- [Half a Million Requests and I Can't Tell If Anyone's Home](https://klappy.dev/page/writings/half-a-million-requests): Half a million requests, and I was completely blind.
- [One Hour with Claude Managed Agents](https://klappy.dev/page/writings/one-hour-with-managed-agents): An autonomous agent searched before claiming, admitted what it didn't know, refused to guess — and then filed a PR fixing the bug we discovered together.
- [The Same Rules, Fresh Eyes](https://klappy.dev/page/writings/the-same-rules-fresh-eyes): Nine revision passes. Every governance doc loaded. I still leaked a name I'd explicitly committed to protecting. The code reviewer caught it in seconds — not because it was smarter, but because it started fresh.
- [Your Context Window Needs a Sabbath](https://klappy.dev/page/writings/your-context-window-needs-a-sabbath): AI promised 5x productivity would mean finishing sooner. Instead it meant never finishing at all. The operator who skips rest isn't just tired — they're running outside the design spec of their own humanity.
- [The Feature I Never Shipped — And Why It's the Best Thing I've Built](https://klappy.dev/page/writings/the-feature-i-never-shipped): I spent months planning a feature. Four sessions. Twenty-five decisions. Two branches. None shipped. Then the problem dissolved on its own.
- [From Passive to Proactive](https://klappy.dev/page/writings/from-passive-to-proactive): I built a system with 400 governance documents, validated it across six epochs, and used it every day for months. Then I realized I was the only thing making it work — because the system waited for me to remember it existed.
- [Getting Started with ODD and oddkit](https://klappy.dev/page/writings/getting-started-with-odd-and-oddkit): Your AI forgets everything between sessions. It guesses instead of checking. It can't tell a brainstorm from a decision. Here's how to fix that in five minutes.
- [How You Lead Is What You Build](https://klappy.dev/page/writings/how-you-lead-is-what-you-build): You've already taught someone to think for themselves — a child, an employee, a team. Now you're doing it with AI. I learned the principles raising my son. Then I forgot them the moment my AI frustrated me. The graduation from hand-holding to trust to autonomy is the same every time. The question is what method you're choosing — and what gets reflected back.
- [Seven Weeks to Southeast Asia — Why Speed at Implementation Is Downstream of Clarity Upstream](https://klappy.dev/page/writings/seven-weeks-to-southeast-asia): The tool worked in Southeast Asia. A year of hard methodology work had laid the foundation. What was missing was the path from that knowledge to working software — and that's what seven weeks produced.
- [Where Words Stop Working — And What Happens When You Build Instead](https://klappy.dev/page/writings/where-words-stop-working): Twenty documents. One year. No working tool. The documents weren't evidence of failure — they were evidence that words had stopped working. What happened next changed how I think about every meeting I've been in since.
- [Agentic Software Development — From Existential Crisis to Epistemic Journey](https://klappy.dev/page/writings/agentic-software-development): The cost of building dropped to zero. The cost of being wrong didn't. The cost of being human didn't. Here's what fifteen years of building software for Bible translation taught me about navigating the space between.
- [Learning in the Open — The Vulnerability That Unlocks Everything Else](https://klappy.dev/page/writings/learning-in-the-open): If I waited until the system was perfect, I wouldn't have published anything yet.
- [Outcomes, Not Hours — Uncomfortable Questions We Must Ask](https://klappy.dev/page/writings/outcomes-not-hours): There's a moment when the tools click and your output changes by a multiple. You ship in hours what used to take weeks. If you're there already, you know what I'm talking about. If you're not there yet — if you're just starting to feel the acceleration — this is what nobody warns you about.
- [The Cost of Code Dropped to Zero. The Cost of Being Human Didn't.](https://klappy.dev/page/writings/the-cost-of-code-dropped-to-zero): A tweet went viral this week. Everyone cheered. Someone I work with texted me the same day: 'The bots 5x you, so you work 5x as much. Sigh.'
- [When Skills Aren't Enough](https://klappy.dev/page/writings/when-skills-arent-enough): You don't outgrow skills because they're bad. You outgrow them because your knowledge shifts from instructions to judgment — and the recipe box can't hold that.
- [Copy. Paste.](https://klappy.dev/page/writings/copy-paste): The more you master AI, the more your job description converges on a clipboard.
- [Seeing Like an Agent](https://klappy.dev/page/writings/seeing-like-an-agent): The Claude Code team spent a year learning to see like an agent. I spent fifteen years learning to see like someone guiding teams through Bible translation. We arrived at the same operating principles — and that means we can maximize the work not done.
- [The Broken Wall and the Buried Talent](https://klappy.dev/page/writings/the-broken-wall-and-the-buried-talent): The wall has gaps and most of us are pretending it's not our problem. A colleague saw what I couldn't — that the system I'd built mirrors an ancient story about rebuilding in hostile territory. The deeper I looked, the more I found: a pattern about burying what you've been given out of fear.
- [Decisions Get Lost in Meetings, Chat, and Handoffs — They Don't Have To](https://klappy.dev/page/writings/decisions-get-lost): The most important decisions happen in meetings and chat threads. That's also where they go to die.
- [Every Handoff Drops Context — Here's How to Stop It](https://klappy.dev/page/writings/every-handoff-drops-context): The PM writes a spec. The PO re-translates it into tickets. The engineer re-interprets the tickets. QA writes a separate test plan. Each handoff drops context. Here's how to stop it.
- [The Journey from AI Tasks to AI-Augmented Workflows](https://klappy.dev/page/writings/the-journey-from-ai-tasks-to-ai-augmented-workflows): You use AI every day. Each session is great. But nothing carries over with the structure it needs, and you're tired of reconstructing context every time you start.
- [Choosing Faith, Not Fear](https://klappy.dev/page/writings/choosing-faith-not-fear): The fear that keeps most people up at night is that AI will replace them. The fear that should keep them up is that AI will replace God in their lives.
- [The Voice Came First](https://klappy.dev/page/writings/the-voice-came-first): Every technology we built for knowledge transfer — writing, printing, digital — was a workaround for the limitations of speech. AI is the first one that might not need the workaround. So was text ever the point?
- [Nothing New, Even AI](https://klappy.dev/page/writings/preface-nothing-new-even-ai): I kept solving the same problem — in engineering, in Bible translation, in parenting, in AI — without recognizing it as one problem. The machines finally made it impossible to ignore.
- [The Intern — A Mental Model for Starting with AI](https://klappy.dev/page/writings/the-intern): AI isn't magic and it isn't broken. It's a brilliant intern whose other job is learning faster than you can teach them.
- [When Your AI Audits Its Own Work — And What the Speed Reveals](https://klappy.dev/page/writings/self-ese-and-the-stacking-test): AI built something. Did it build what you asked? Most checklists miss the gap. Self-ESE doesn't.
- [The Harness and the Operating System](https://klappy.dev/page/writings/the-harness-and-the-operating-system): A developer who doesn't read his code and a systems architect who built an Epistemic OS arrived at the same conclusion independently. That's not competition. That's directional validation.
- [The Planning Queue — Your AI Builds What You Spec'd, Not What You Remember](https://klappy.dev/page/writings/the-planning-queue): You just spent an hour thinking through a feature with AI. Now close the chat and try to build it.
- [The Drift Queue — Your Knowledge Base Cleans Itself](https://klappy.dev/page/writings/the-drift-queue): Your knowledge base is drifting right now. You just can't see it.
- [The Project Journal — Your AI Collaboration's Memory](https://klappy.dev/page/writings/the-project-journal): Stop repeating yourself to AI. A project journal makes every session build on the last.
- [From Bible Translation to Epistemic OS — And Back Again](https://klappy.dev/page/writings/from-bible-translation-to-epistemic-os): Fifteen years of Bible translation taught me that every collaboration failure is an expectations failure. I abstracted those patterns into an Epistemic OS. Now I'm testing whether it can go back where it came from.
- [The Most Expensive Problem](https://klappy.dev/page/writings/the-most-expensive-problem): Mankind's most expensive problem isn't building things. It's transferring what we know.
- [The Parallel Architecture](https://klappy.dev/page/writings/the-parallel-architecture): The parallels between human cognition, AI systems, and biblical narrative are too structural to be coincidental.

## Canon (The Record)

The house's standing law: constraints, principles, methods, patterns, decisions, definitions and the other canon/ folders, excluding the apocrypha. 205 pages.

- Section front: https://klappy.dev/canon
- Feed: https://klappy.dev/canon/feed.xml (JSON: https://klappy.dev/canon/feed.json)

## ODD (The Stylebook)

The method's own pages in odd/: contract, constraints, decisions, encoding and challenge types, appendices, backlog. 105 pages.

- Section front: https://klappy.dev/odd
- Feed: https://klappy.dev/odd/feed.xml (JSON: https://klappy.dev/odd/feed.json)

## Apocrypha (The Back Page)

Everything in canon/apocrypha/: fragments recovered from a future that need not happen, their pre-reports and scenes, and the charter that binds them; never law, never instruction. 18 pages.

- Section front: https://klappy.dev/apocrypha
- Feed: https://klappy.dev/apocrypha/feed.xml (JSON: https://klappy.dev/apocrypha/feed.json)

## Agents

- MCP: https://klappy.dev/mcp (three tools, anonymous, GET/HEAD)
- OpenAPI: https://klappy.dev/openapi.json
- Full text of every essay: https://klappy.dev/llms-full.txt
- Markdown twins: append `.md` to any /page/ URL, or send `Accept: text/markdown` to a `.md` URL
- Feeds: https://klappy.dev/feed.xml and https://klappy.dev/feed.json