102
Make architecture decisions in writing
Decisions outlive the meeting. Put the options, the choice and the tradeoff on paper.
Significant choices get a short decision record: context, the options considered, what we chose, and what we are giving up. It keeps debates short, onboarding fast, and reversals honest.
Signals I watch
- New engineers can find why, not just what
- We revisit decisions on evidence, not mood
103
Balance delivery and technical debt
Debt is a financing decision. Take it on deliberately, record it, and pay it down where it costs interest.
I budget capacity for paying down debt every cycle and spend it where debt slows the roadmap: hot paths, flaky tests, risky deploys. Cosmetic debt waits.
Signals I watch
- Lead time and change-failure rate trend down
- Debt items are tied to the roadmap they block
106
Build systems the next team can own
Maintainable beats clever. Boring technology, clear boundaries, and documentation that stays current.
I choose conventional stacks that can be hired for, draw service boundaries along business lines, and treat runbooks and docs as part of done.
Signals I watch
- On-call is quiet
- Hand-overs take days, not months