Skip to content

Blog

Practical insights on software architecture, AI-augmented development, and building engineering teams that ship.

24 posts

A hand arranges connected reference cards beside a laptop on a sunlit wooden desk.
software-craftai

What to Put in an AI Coding Context File

Build an AI coding context file that captures your system's rules, reference paths, and boundaries. A worked example shows what belongs in the file.

November 2, 20268 min read
Read
A team working together with laptops around an office table
engineering-leadershipfeedbackcommunication

How to Give Technical Feedback Engineers Actually Act On

Most technical feedback gets ignored because it's vague, late, or framed as a verdict. Here's how to give feedback that changes behavior, drawn from 20+ years of engineering leadership.

June 18, 20269 min read
Read
A team gathered around a whiteboard covered with colorful sticky notes
engineering-leadershipteam-alignmentsoftware-craft

Why Engineering Teams Think They're Aligned (But Aren't)

Most engineering teams leave meetings believing everyone agrees. Then integration fails weeks later. Here's the cognitive science behind alignment illusions and a practical framework for building shared mental models.

March 24, 202612 min read
Read
Close-up of a monitor displaying syntax-highlighted code
software-craftdeliberate-practiceengineering-leadership

What Is Deliberate Practice in Software Engineering?

Deliberate practice in software engineering is the discipline of mastering your craft by drilling one small detail at a time. Here's how it differs from just writing more code.

February 25, 20267 min read
Read