Playbooks & production notes

Maintainability, page 2

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

Maintainability

The definition of due diligence, in plain words: what it means, the types, how long it takes, and what technical due diligence adds

13 min read
Maintainability

How to create architecture diagrams for a web app: what to include, a template, and the check against production

17 min read
Maintainability

Owning an app someone else built: the takeover checklist for the repository, accounts, domain, keys and hosting

12 min read
Maintainability

Production readiness review: how to run a PRR for a small team in one hour, and the questions the reviewer asks

12 min read
Maintainability

The runbook template for a small SaaS: deploy, rollback, key rotation, restore, and one runbook per alert

16 min read
Maintainability

Software architecture for a small SaaS: what the word means, the views that matter, and how to write yours down

14 min read
Maintainability

What does a developer handoff look like? The seven things you should leave with

13 min read
Maintainability

When a new developer cannot run the project locally: one command, an env example, pinned versions and seed data

16 min read
Maintainability

Code quality checks when you cannot read the code: the checks, the numbers, and what they are worth

20 min read
Maintainability

The code review checklist and template: a test for every line, the report it produces, and the setup that makes it happen

17 min read
Maintainability

Engineering standards for AI-assisted teams: the 11 code health controls, each with a test

19 min read
Maintainability

Guardrails for AI coding agents: the rules file, the protected patterns, and the CI check that stops an agent undoing them

20 min read
Maintainability

How to write end to end smoke tests, and the auth and billing unit tests, for the smallest suite that catches a broken signup, login or payment

17 min read
Maintainability

License scanning for an AI-built web app: the license audit, the report and the SBOM a reviewer asks for

12 min read
Maintainability

What is a code scan: what a scanner reads in an AI-built app, which one to run on your stack, and how to prove it runs

20 min read
Maintainability

Delivering an AI-Built App to Your Client: What the Agency Owes at the End

23 min read
Maintainability

Lovable for Agencies: What Your Workspace Decides About Client Work

21 min read
Maintainability

What Is a White-Label App? One Product, Several Clients' Names

21 min read