May 22, 2026
Rules Don't Route, Tools Do
You write CLAUDE.md. You put the rule right at the top. Rule 0. You test it in the next session — the AI reaches for grep anyway. This...
Collection
Vibe Coding
May 22, 2026
Six Habits That Make Your Codebase More AI-Readable
tags: [annotations, habits, codebase, ai-readable, contracts, byproduct, intent, incremental] related: 034_five-principles-ai-code-search.md 012_code_for_machines.md 023_living_codemap.md supersedes: ~ status: current — 035 — Six Habits That Make Your Codebase More AI-Readable...
May 22, 2026
Structure Is Not Intent: Two Layers Every Code Intelligence System Needs
tags: [code-intelligence, contracts, codegraph, structure, intent, semantic-search, graph, dar-find] related: 032_pre-index-your-codebase.md 011_nlp_first_codebase.md 012_code_for_machines.md supersedes: ~ status: current — 033 — Structure Is Not Intent: Two Layers Every Code...
May 22, 2026
The Confidence Gap as a Safety Gate
tags: [nl-testing, ambiguity, confidence, safety, playwright, tfidf, ui-contracts] related: packages/nlp/ui-resolver.js packages/testing/nl-runner.js packages/testing/tests/nl-runner.test.js decisions/nl-testing.md responses/RESPONSE_2026-05-16_nl-testing-p2-p3.md responses/RESPONSE_2026-05-16_nl-testing-p5.md status: current — 022 — The Confidence Gap as a Safety Gate When...
May 22, 2026
The Contract Corpus Has Two Layers
After building the NLP contract system for DarJS — 245 contracts, 100% @reuse-when coverage, TF-IDF index, dar find running — Ahmed asked whether it was actually enough for...
May 22, 2026
The Diagram That Pulses While the Code Runs
Every software project has two versions of its architecture. The first version is the diagram. It lives in a README, a Confluence page, a Miro board, or a...
May 22, 2026
The DSL Layer Between AI and Your App
The first version of the DarJS test architecture had the AI writing raw Playwright. page.click('a[href*="/new"]'). page.fill('input[name="cin_patient"]', 'AB123456'). page.waitForSelector('.record-id:has-text("REG-001")'). It worked until a template changed. Then it silently broke...
May 22, 2026
The Living CODEMAP
tags: [codemap, tooling, sync, symbols, line-numbers, documentation, pre-commit, trust] related: tools/codemap/symbol-extractor.js tools/codemap/codemap-patcher.js tools/codemap/smell-detector.js packages/cli/commands/codemap.js docs/CODEMAP.md responses/RESPONSE_2026-05-16_codemap-sync-tool.md status: current — 023 — The Living CODEMAP Every codebase that works...
May 22, 2026
The NLP-First Codebase: Replacing LLM Calls with Retrieval
Most of what developers ask an LLM isn’t a generation problem. It’s a retrieval problem wearing a generation costume. “What already exists that adds timestamps to a model?”...