Software Design Document: The Missing Bridge Between PRD and Code

Susiloharjo

Software Design Document: The Missing Bridge Between PRD and Code Series: Understanding SDLC — Part 4 of 10 I’ve written PRDs. I’ve reviewed SRS documents. But there’s one document that consistently separates projects that ship on time from ones that derail in implementation: the Software Design Document (SDD). Here’s the thing — a PRD tells … Read more

Understanding BRD: The Document That Makes Bosses Understand

Susiloharjo

Understanding BRD: The Document That Makes Bosses Understand (Not Developers) Ever finished building a feature, showed it to your boss, and heard: “Wait, that’s not what I asked for?” Or worse: you coded for months, only to find out nobody uses the feature because it doesn’t solve the actual business problem. This isn’t a coding … Read more

I Self-Hosted Langfuse to Watch My AI Agents Think

Langfuse LLM observability monitoring interface

I Self-Hosted Langfuse to Watch My AI Agents Think Two weeks ago I shipped an AI agent that helps our procurement team check vendor proposals against our ERP database. It worked great in testing. In production? Silent failures. The LLM would sometimes return garbled JSON, sometimes skip steps entirely, and I had no way to … Read more

Building a PostgreSQL AI Agent in 200 Lines of Python

Cybersecurity threat landscape digital art

Reading Simon Willison’s Blog at 11 PM I was catching up on Simon Willison’s blog late last night when I saw he shipped Datasette Agent — an AI assistant that answers natural-language questions about your SQLite databases. The demo sold me: “When did Simon most recently see a pelican?” The agent queried his personal database … Read more