Discussion about this post

User's avatar
Rohit Yadav's avatar

The harness analogy is the sharpest framing I've seen for this - juniors needing a deliberate training harness the same way agents need an execution harness to stay on track. It connects directly to what I found looking at AI-first codebases: systems nobody fully understands because the people who'd normally build that understanding through review are the ones being skipped. Does the ADR-as-training-discipline approach hold up when the junior isn't writing the code at all - can architectural judgment form purely through review and decision records, or is there a floor of hands-on implementation below which it doesn't stick? Happy to connect, let's talk more about it.

The Next Evolution's avatar

The shift from implicit to explicit is the right diagnosis, and the ADR discipline is a genuine part of the fix. But architecture and patterns are the wrong things to put first if the goal is someone who can actually save a system when it breaks.

Reusable code, the right architecture model, security by design — none of my generation learned those as rules from a book. They were built by writing the bad version first, watching it fail, and doing the work of understanding why. That's the same judgement an AI model doesn't have. It can generate the pattern-correct answer without ever having lived with the consequence of getting it wrong, which is exactly why it doesn't know good from bad — it's never had to.

Teaching the WHAT top-down closes half the gap. It gives a junior the vocabulary to describe a decision and reference the pattern that justifies it. It doesn't give them the ability to open a system that's already broken, work out why, and fix it — because that skill only comes from having built and broken things by hand, not from reading the architecture that explains how they were supposed to work.

Which is the actual test this doesn't have an answer for yet: not the design review, but the outage — when the thing that failed can't explain itself, and the only useful skill left in the room is someone who can read the code directly and knows what wrong looks like.

No posts

Ready for more?