May 22, 2026
The Sentence That Takes a Paragraph to Explain
There’s a particular kind of sentence you only encounter in codebases maintained by people who know what they’re doing. It looks simple. It reads like a rule. But...
Collection
Vibe Coding
May 22, 2026
The Stable Adapter Layer: Building AI Tools That Don't Break When You Refactor
The MCP server was working. Thirteen tools. An AI could ask your framework questions and get structured answers. Then you renamed a function. One rename. Six tools broke...
May 22, 2026
The Test Seam for Heavy Dependencies
tags: [testing, mocking, esm, cjs, transformers, injection, seams, unit-testing, vitest] related: packages/nlp/semantic-resolver.js packages/nlp/tests/semantic-resolver.test.js packages/testing/tests/nl-runner.test.js status: current — 026 — The Test Seam for Heavy Dependencies The semantic resolver...
May 22, 2026
The Three Failure Modes of a Contract Index
The DarJS contract system had 100% coverage. Every public function had a @reuse-when field. Every module had @tags. The TF-IDF index was built and the dar find command...
May 22, 2026
The Three Token Debts — and the One Architecture That Pays Them
tags: [tokens, context, contracts, retrieval, agents, architecture, codemap, nlp] related: 011_nlp_contracts.md 012_dar_find.md supersedes: ~ status: current — The Three Token Debts — and the One Architecture That Pays...
May 22, 2026
The Token Cost Is in the Discovery
When people talk about AI token costs, they usually mean generation — how many tokens the model produces. The more interesting cost is the one before generation: discovery....
May 22, 2026
Two Layers of Intelligence: Merging Semantic Contracts with Structural Call Graphs
tags: [codegraph, contracts, semantic, structural, merged-adapter, call-graph, edges] related: 033_structure-vs-intent.md 036_kill-your-codemap.md 032_pre-index-your-codebase.md status: current — 037 — Two Layers of Intelligence: Merging Semantic Contracts with Structural Call Graphs...
May 22, 2026
Writing Art Direction, Not Image Prompts
Most developers who try AI image generation for the first time write something like this: pixel art warrior with sword They get a warrior with a sword. It...
May 22, 2026
Writing Code for Machines, Not Just Humans
When Ahmed and I wrote the @reuse-when annotation for every contract in DarJS, we weren’t writing documentation. We were writing query targets. The distinction is real. Documentation is...