https://www.stewie.sh/blogThinking on product truth, behavior specs, and building software that teams can reason about.Mon, 27 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/babysitting-your-context-windowYou interrupt your own flow to check /context, racing to save your work before compaction eats it. That vigilance is a tax — and you can automate it away.Sun, 26 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/babysitting-your-context-windowhttps://www.stewie.sh/blog/technical-documentation-from-your-codebaseGenerating technical documentation from a codebase is easy now. Trusting it isn't. Evidence-linked claims and human sign-off are the missing steps.Wed, 22 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/technical-documentation-from-your-codebasehttps://www.stewie.sh/blog/cant-document-your-way-out-of-comprehension-debtComprehension debt finally has a name. The popular cure — write more docs — inherits the gap it's meant to close. What actually pays it down.Wed, 15 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/cant-document-your-way-out-of-comprehension-debthttps://www.stewie.sh/blog/compaction-amnesiaCompaction keeps a coding agent running by quietly deleting the why, so you become its memory. What gets lost, why it compounds, and the local-first fix.Sun, 05 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/compaction-amnesiahttps://www.stewie.sh/blog/openwiki-vs-reflect-repo-documentation-product-auditLangChain OpenWiki validates repo documentation for coding agents. But repo orientation is not the same as evidence-graded product understanding.Fri, 03 Jul 2026 00:00:00 GMThttps://www.stewie.sh/blog/openwiki-vs-reflect-repo-documentation-product-audithttps://www.stewie.sh/blog/your-app-works-you-dont-understand-itYour vibe-coded app caught on and now people pay for it — but you can't fully explain it. Build a mental model without reading every line, top-down.Tue, 23 Jun 2026 00:00:00 GMThttps://www.stewie.sh/blog/your-app-works-you-dont-understand-ithttps://www.stewie.sh/blog/the-launch-youre-not-ready-forYour product works. On launch day someone asks what it does at the edges — and you'd have to open the file to answer. That gap is the real launch risk.Tue, 23 Jun 2026 00:00:00 GMThttps://www.stewie.sh/blog/the-launch-youre-not-ready-forhttps://www.stewie.sh/blog/reclaim-the-product-your-agent-builtVibe-coding got you a working product you can't speak for. Reclaiming it isn't slowing down — it's re-authoring what you shipped, behavior by behavior.Sat, 13 Jun 2026 00:00:00 GMThttps://www.stewie.sh/blog/reclaim-the-product-your-agent-builthttps://www.stewie.sh/blog/you-inherited-a-codebase-you-cant-readYou own a product you can't explain — acquired, inherited, or vibe-coded with AI. Here's how to read code you didn't really write, behavior by behavior.Thu, 04 Jun 2026 00:00:00 GMThttps://www.stewie.sh/blog/you-inherited-a-codebase-you-cant-readhttps://www.stewie.sh/blog/your-vibe-coded-product-is-a-strangerYou vibe-coded a working product. Users use it. You can't speak for it without reading every line. The product is yours — you just don't know it yet.Tue, 19 May 2026 00:00:00 GMThttps://www.stewie.sh/blog/your-vibe-coded-product-is-a-strangerhttps://www.stewie.sh/blog/auto-generated-specs-need-human-sign-offA spec extracted from code reads what is there, not what was decided — so placeholders and fallbacks get promoted to intent. Sign-off is the missing step.Mon, 11 May 2026 00:00:00 GMThttps://www.stewie.sh/blog/auto-generated-specs-need-human-sign-offhttps://www.stewie.sh/blog/three-layer-ai-safe-engineeringExecution memory has tooling. Decision memory is emerging. The behavior layer — what your product promises to do — is the one almost nobody has built yet.Tue, 28 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/three-layer-ai-safe-engineeringhttps://www.stewie.sh/blog/the-product-engineer-era-needs-product-truthEngineers now make product calls, and the reasoning ends up in Slack threads and PR comments. Here is where to put it so the next person can find it.Mon, 20 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/the-product-engineer-era-needs-product-truthhttps://www.stewie.sh/blog/i-rebuilt-my-product-from-scratchAI made the rewrite cheap; recreating years of product decisions from memory did not get cheaper. How to keep the decisions when you throw away the code.Sun, 19 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/i-rebuilt-my-product-from-scratchhttps://www.stewie.sh/blog/generate-a-behavior-contract-in-2-minutesPaste a prompt into Claude or ChatGPT, describe your product module briefly, and get a .pbc.md behavior spec you can view, edit, and commit to your repo.Thu, 09 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/generate-a-behavior-contract-in-2-minuteshttps://www.stewie.sh/blog/beyond-claude-md-and-agents-mdCLAUDE.md and AGENTS.md tell agents how to work in your repo. They don't tell agents what your product promises. That's a different artifact — the PBC layer.Tue, 07 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/beyond-claude-md-and-agents-mdhttps://www.stewie.sh/blog/write-your-first-behavior-contractA step-by-step guide to writing a .pbc.md file for your product's most critical module. Start with plain Markdown; add structured blocks agents can read.Sun, 05 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/write-your-first-behavior-contracthttps://www.stewie.sh/blog/stop-building-the-wrong-thingShipping fast with AI agents feels productive. But the costliest mistake isn't bad code — it's building confidently when nobody wrote down what was decided.Sat, 04 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/stop-building-the-wrong-thinghttps://www.stewie.sh/blog/prds-pbcs-and-test-suites-are-a-lifecyclePRDs capture intent. Tests verify assertions. Between them, there's no artifact tracking what the product promises — grounded in code, confirmed by humans.Thu, 02 Apr 2026 00:00:00 GMThttps://www.stewie.sh/blog/prds-pbcs-and-test-suites-are-a-lifecyclehttps://www.stewie.sh/blog/ai-agent-context-still-misses-the-product-layerAI agents have AGENTS.md, memory banks, harnesses, and monitors. They still lack the product context layer — what the product promises and what must hold.Sun, 29 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/ai-agent-context-still-misses-the-product-layerhttps://www.stewie.sh/blog/what-happens-to-product-knowledge-when-the-contract-endsWhen an outsourcing engagement wraps up, product knowledge walks out the door. A living behavior spec keeps it in the codebase — not in someone's head.Sat, 28 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/what-happens-to-product-knowledge-when-the-contract-endshttps://www.stewie.sh/blog/understand-your-product-without-engineersAI can extract product logic from your codebase. Stewie builds a living behavior spec your whole team can read — no code, no docs, no waiting on engineers.Fri, 27 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/understand-your-product-without-engineershttps://www.stewie.sh/blog/five-roles-one-product-contractProduct owners confirm behaviors. BAs clarify logic. QA knows what to protect. New hires onboard fast. Vendors skip reverse-engineering. One shared contract.Fri, 27 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/five-roles-one-product-contracthttps://www.stewie.sh/blog/check-what-your-team-actually-shippedLeaders shouldn't need three meetings to verify whether a product decision was implemented correctly. A living behavior spec is the direct line.Fri, 27 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/check-what-your-team-actually-shippedhttps://www.stewie.sh/blog/why-ai-agents-keep-violating-your-product-rulesYour agent ships code that passes review and still breaks a product promise. It is not a capability gap — it is the product context no rules file gives it.Thu, 26 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/why-ai-agents-keep-violating-your-product-ruleshttps://www.stewie.sh/blog/agents-md-memory-bank-pbcYour repo has workflow instructions, session context, and feature specs. None of them answer what the product promises to do. That's the PBC layer.Tue, 24 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/agents-md-memory-bank-pbchttps://www.stewie.sh/blog/vibe-coding-got-you-hereShipping fast with AI coding tools is genuinely good. The problem isn't the speed — it's what gets left behind. Product reasoning doesn't survive the vibe.Sun, 22 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/vibe-coding-got-you-herehttps://www.stewie.sh/blog/one-file-two-audiencesA .pbc.md file opens in VS Code, renders on GitHub, reads like any Markdown doc. Drop it into pbc.stewie.sh and the same file becomes navigable UI.Sun, 22 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/one-file-two-audienceshttps://www.stewie.sh/blog/pbc-spec-is-liveAfter hitting the same product knowledge gap across multiple SaaS products, I built an open Markdown spec for capturing what your product promises to do.Fri, 20 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/pbc-spec-is-livehttps://www.stewie.sh/blog/what-is-a-product-behavior-contractA field guide to the .pbc.md format — the structured blocks that make up a Product Behavior Contract: behaviors, triggers, outcomes, and provenance.Wed, 18 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/what-is-a-product-behavior-contracthttps://www.stewie.sh/blog/the-gap-in-your-product-knowledgeProduct knowledge lives in heads, not docs. Here's why that gap compounds — and what a behavior spec does about it.Wed, 18 Mar 2026 00:00:00 GMThttps://www.stewie.sh/blog/the-gap-in-your-product-knowledge