Articles
In-depth articles on AI, web development, cloud native, and indie hacking.
When an Agent pauses, a paragraph of progress description is not enough for a developer to continue safely. This article uses a versioned handoff record bound to the Git worktree, recoverable artifacts, and an explicit acceptance protocol to avoid missing changes, duplicated work, and orphaned responsibility.
When search volume is high and you need full-text search, complex filtering, and aggregations, Elasticsearch is a powerful but heavyweight tool. This article explains its core concepts (indexes, shards, and inverted indexes), advantages over SQL full-text search, Query DSL essentials, Chinese tokenization with IK, and when ES is or is not justified.
Treating Agent comments directly as merge conclusions amplifies false positives and false negatives. This article designs evidence grading, issue reproduction, fix rounds, and human final decisions in PRs, forming a traceable code review loop.
Kafka is more than a message queue; it is an event streaming platform and a foundation for logs, stream processing, and event-driven systems. This article explains Kafka's topic, partition, offset, and consumer-group model, its high-throughput design, ordering and Exactly-Once guarantees, and when to use it.
When a coding Agent takes over a large repository, the biggest waste is indiscriminate file reading. This article designs a repository map, module boundaries, command evidence, and risk labels so the Agent establishes a verifiable working context before changing code.
On the cloud it's easy to 'get more expensive as you use it' — idle resources, over-provisioning, forgotten services, traffic fees. Covers cost optimization levers: compute (reserved/spot/right-sizing), storage (tiering/cleanup), network (egress/CDN), bill monitoring + alerts, and the 'FinOps' culture making costs visible and accountable.
An Agent can deliver green tests without actually implementing the requirement. This article uses versioned acceptance claims, a bidirectional evidence graph, counterexample samples, and quantified gates so every acceptance can be traced to a specific change and a result on the same snapshot.
APIs inevitably become hard to change. How can they evolve without breaking existing clients? This article explains URL path, header, query parameter, and content-negotiation versioning; their tradeoffs; when breaking changes are necessary; deprecation strategies; and a practical "forward compatibility first, major versions when necessary" approach.
The real risks of a coding agent usually come from the shell, the file system, and credentials, not from code completion. This article covers least-privilege sandboxes, path allowlists, network egress, ephemeral credentials, and audit strategy.
"Tuning RAG without an eval set is just guesswork." This guide uses RAGAS to explain four core metrics, building and running an evaluation set, and diagnosing issues so "it feels better" becomes "recall rose from 0.72 to 0.91."
Full regression suites are too slow, while guessing tests from filenames misses failures. This article uses a baseline commit, dependency graphs, dynamic coverage, and risk rules to build an explainable affected-test set and defines when a full test run is mandatory.
Creating a new database connection for every request can bring PostgreSQL down as concurrency rises. This article explains why PostgreSQL connections are expensive, application-side pooling, PgBouncer, transaction mode, and how to calculate connection limits.