The reading room
Posts on living specifications, AI-assisted coding, and the documentation that quietly goes stale
Latest
PRODUCT MGMT4 MIN READComprehension Debt: The Real Cost of AI-Assisted Coding
AI-assisted coding ships code faster than anyone can read it. Comprehension debt is the new technical debt — and it's widening with every release.
PRODUCT MGMT4 MIN READNobody on Your Team Can Explain the Whole Product
Product knowledge lives in people's heads — fragmented, incomplete, and one resignation away from gone. Here's why that's structural, not a people problem.
PRODUCT5 MIN READSpecsight vs Confluence: Living Specs vs Wiki Pages
Confluence excels at many things. Keeping product behaviour specs accurate isn't one of them. Here's how Specsight compares — and when each tool makes sense.
PRODUCT MGMT5 MIN READContext, Action, Outcome: A Better Format for Product Specs
Most product specs are too vague or too technical. Context/Action/Outcome is a format precise enough to be unambiguous, readable enough for anyone on the team.
PRODUCT MGMT3 MIN READWhat Is a Living Product Specification?
A living specification is an always-accurate, automatically maintained record of how your product actually behaves. Here's what it contains and who it's for.
PRODUCT MGMT4 MIN READWhy Product Documentation Always Falls Out of Sync
Specs fall out of sync almost as soon as they're written. It isn't laziness — it's a mismatch between how specifications are made and how products change.