Playbooks & production notes

Maintainability

How to keep an AI-built codebase understandable, testable, and safe to change as prompts, features, contributors, and production pressure accumulate.

Keeping an AI-built codebase readable and safe to change as features, prompts, and contributors pile up. For founders who can feel every edit getting slower than the last. Start with "Why Your AI App Gets Harder to Change Every Week", then "CLAUDE.md Best Practices".

Maintainability

Choosing an API documentation tool for a small SaaS: the options, a template, and a worked example

16 min read
Maintainability

Application maintenance service: what it covers, how it is sold, and when hardening is the thing to buy first

12 min read
Maintainability

Due diligence of code when selling a business: what the buyer's reviewer will ask for, and how to be ready

10 min read
Maintainability

How to run a technical handover session: the one-hour agenda, what to record, and what to ask before the developer leaves

10 min read
Maintainability

The post-launch support checklist: defect cover, a question window, and how to agree both in writing

10 min read
Maintainability

The software project handover checklist: 20 items in five groups, and the handover document both sides sign

15 min read
Maintainability

Technical documentation for investors: the production readiness report and the due diligence pack, and how a reviewer reads them

13 min read
Maintainability

Frontend broke after backend change: typed contracts at every API boundary, and the CI check that catches the next one

15 min read
Maintainability

How to enable TypeScript strict mode on an AI-built app: turn it on, fix what it finds, keep the suppressions out

17 min read
Maintainability

How to find unused code in a repo: dead code and duplicated logic in an AI-built app, removed without breaking anything

16 min read
Maintainability

Legacy code takeover: a first-month plan for the engineer who inherited a codebase nobody can explain

16 min read
Maintainability

Linters and formatters on a codebase an AI wrote: one config, the rules worth failing a build over, and the suppressions to watch

17 min read
Maintainability

A secure code review checklist for AI-built apps: what to look for, in what order, and when reading has to stop

14 min read
Maintainability

Tech debt in an app you did not write: what the words mean, how to measure it, and what to pay down first

17 min read
Maintainability

Two screens show different values: giving every piece of state in an AI-built app one owner

12 min read
Maintainability

How to verify AI generated code before production when you cannot read it: seven pieces of evidence, and the five-minute version

10 min read
Maintainability

What belongs in a README, and how to lay out a repository someone else can read

13 min read
Maintainability

What is a codebase walkthrough: the 20 to 30 minute recorded tour, chapter by chapter

12 min read