Notes

Occasional notes about software engineering, architecture, AI and things I've learned while building systems.

Code isn't enough context anymore

Published Aug 19, 2026

As coding agents improve, repositories need to communicate architectural context, constraints and intent in addition to source code.

architecture documentation AI-native development

When an upgrade isn't an improvement

Published Aug 19, 2026

A major-version upgrade has an opportunity cost. Postponing can be technically responsible when support is intact and new capability does not advance product or architecture goals.

architecture platform strategy maintenance