documentation
9 articles
Demo mode as a pattern for software
Build demo mode into software so users can explore it with realistic sample data. A console case shows the design, testing, privacy and onboarding choices.
Diagnosing Retrieval Failures in a RAG Application
Use Ragbot’s biography lookup to separate routing, tokenization and ranking, then trace a context-budget change through five defaults from UI to retrieval.
Data Format Contracts for AI Pipelines
Timestamp, pagination, rate-limit and configuration failures taught me to define explicit data contracts, then test what each component sends and accepts.
Keeping Claude Code Refactors Consistent Across Long Sessions
Keep a long Claude Code refactor aligned with its conventions through instruction-loading checks, scoped code review and tests of the behavior being changed.
Build the Foundation Before Scaling AI Coding
Set architectural direction, build a complete reference feature and test the next addition. A worked API example shows what coding agents should extend.
How Claude Code Uses CLAUDE.md and Memory
Claude Code loads project instructions and saved memory under different rules. Check what survives compaction and whether the code follows your guidance.
What OpenAI's Sora Build Teaches Us About Synthesis Coding
What OpenAI's Sora Android case teaches about synthesis coding: give agents context, establish patterns, plan changes, and lead the work as it scales.
Polyrepo Synthesis: Working Across Repositories with Claude Code and VS Code
Configure Claude Code and VS Code for cross-repository work, map shared dependencies, and test both direct and indexed consumers after a schema change.
Reviewing Claude Code’s Work: Security and Performance
Four Claude Code cases show how engineering review improves authentication, caching, async calls, and security findings, with runnable local Python examples.