When the Map Starts Learning: Building a Shared Memory for Humans and AI
What happens when documentation stops being a destination and becomes living context for product, engineering, and AI.
- AI Systems
- Knowledge Systems
- Engineering Practice
Writing
Notes from building, operating, and thinking.
Essays about production AI systems, distributed software, engineering judgment, and the knowledge teams build together.
9 essays
The Map Is Not the Theory: Why Docs and Diagrams Will Mislead You
Written artifacts are just approximations; the real system lives in the team's head.
- Engineering Practice
- Knowledge Systems
Programming as Theory Building: Why Reading the Docs Is Not Enough
Why understanding code requires more than documentation alone.
- Engineering Practice
- Knowledge Systems
Railway-Oriented Programming in C#: Errors Without the Spaghetti
A practical guide to Railway-Oriented Programming in C#, with real examples for keeping error-handling logic explicit and composable.
- C#
- Software Design
Understanding Authorization: A Practical Guide
A practical introduction to authorization, OAuth, OpenID Connect, tokens, scopes, and the decisions behind protecting application resources.
- Security
- Architecture
A Factory Pattern for Simpler Object Creation
A C# factory pattern that reduces repeated object-creation logic while keeping concrete types and parameters easy to extend.
- C#
- Software Design
Eight Git Commands for Everyday Work
Eight Git commands that cover most daily work, plus safe ways to inspect, synchronize, rebase, and recover.
- Developer Tools
Extension Methods, Fluent Interfaces, and Method Chaining in C#
How extension methods, method chaining, and fluent interfaces can make C# code more expressive without hiding what it does.
- C#
- Software Design
The Leap of Faith
A personal reflection on opportunity, calculated risk, and what can happen when you choose to take the leap.
- Personal