maintainable.software

"You will never learn anything new [if it's not] significantly different from what you already know"

Adapted from Rich Hickey - Simple made easy

How I Use Living Plans for Spec-Driven Development

May 1, 2026

Spec-driven development is useful when the spec is not a stale document. I use short-lived living plan files as temporary execution contracts for one bounded feature or change so discovery, implementation, checks, docs, and implementation discoveries stay connected while the work is active.

How to Succeed with Agentic Engineering - Part 2

How to Design a Maintainable Codebase for AI Coding Agents

Apr 5, 2026

Learn how to design a maintainable, AI-agent-friendly codebase. The key principles are locality, small blast radius, boundary integrity, navigability, cohesive modules, ownership-aligned boundaries, and restrained complexity, so coding agents can build a correct local model and change software safely.