An honest look at the playbook behind one developer maintaining many apps — including where it breaks.
Building was never the bottleneck. Maintenance is where fleets sink — unless verification is automated and context lives in files.
graph LR
A[Plain files in repo] --> B[Scriptable CLI steps]
B --> C[Automated verification]
C --> D[Agents work safely]
D --> E[More apps per human]
E --> A
Pricing, priorities, escalations happen in meetings and chats. Insisting on Markdown-only truth makes engineering invisible to PMs, sales, and leadership.
Ten people in flat issues/ files recreate — badly — what trackers solved: assignment, notification, paging. Files don't wake anyone at 3 a.m.
The conventions are documented; the taste that evolves them is not. One-author systems are liabilities with great test coverage.
"Human in control" assumes the operator owns the outcome. With 400 humans, control correctly becomes audit trails and approval layers.
Sometimes shipping the band-aid is the rational call. A method with no vocabulary for acceptable debt reads as perfectionism with a Makefile.
Failure modes of local-first at scale are failures of scope, not substance.
Fund preflight gates and golden suites before adopting agents. Never create faster than you verify.
Keep the tracker — stop losing the why. Two-paragraph decision files end code archaeology.
AGENTS.md + spec + one verify command: the best onboarding doc ever written, for humans and agents alike.
make preflight — green or red, local or CI, no dashboard login on the critical path.
Thirty lines proving the bucket is writable and the token refreshes kill whole classes of cross-team tickets.
One schema-validated spec file beats "ask Dave which value is real." Reviewable, diffable, generatable.
graph LR
subgraph Keep
T[Trackers & paging]
G[Governance]
M[Meetings]
end
subgraph Adopt
V[Verification-first]
R[In-repo decisions]
P[One-command preflight]
end
T --- V
G --- R
M --- P
CLI-first and local-first optimize the layer where code is made and verified — and at that layer, they win everywhere.
imagine what a team could keep alive, once its repos can explain themselves.