Perfect is the enemy of Good.
At some point you’re no longer improving the solution. You’re just delaying its existence.
Field manual · Volume one
FMS / 2026
Rules for building, fixing, documenting, and knowing when to leave well enough alone.
These rules did not arrive in a walnut-paneled boardroom. They showed up in failed updates, repaired machines, midnight command lines, hard-won second chances, and the quiet satisfaction of a system that finally does what it is supposed to do.
Not because they were profound.
Because they were tested.
Reality gets a vote
The job is not to defend the plan. The job is to improve the result. Start with the system that actually exists, including the strange parts everyone has learned to walk around.
At some point you’re no longer improving the solution. You’re just delaying its existence.
When the same failure keeps returning, stop blaming the weather. The result is telling you how the system really works.
Temporary solutions acquire users, dependencies, folklore, and eventually a line item in the budget.
A stable system does not need to participate in every new idea. Improvement has a burden of proof.
The discipline of restraint
Competence is not demonstrated by the number of changes made. Sometimes the expert move is to gather evidence, write down what works, and go home.
Late-night curiosity has a remarkable ability to turn tomorrow’s maintenance into tonight’s incident.
Age is not a defect. Novelty is not a requirement. If the system remains safe, supportable, and useful, let it earn another day.
A quiet system is the ideal time to record the decisions, commands, dependencies, and escape routes that made it quiet.
Define the symptom, reproduce it, and establish the desired outcome. Otherwise you are troubleshooting a mood.
Judgment after dark
Tools matter. Judgment matters more. Fatigue changes the odds, pride changes the story, and both become expensive when they are holding root access.
If you change three things, you’ll troubleshoot four. Make the smallest useful change, verify it, and only then take the next step.
A green light is encouraging. A tested result is evidence. Believe the system after it proves the thing you actually care about.
Your next decision determines which. Fatigue changes the odds because judgment suffers under fatigue.
Maintenance interval
Maintenance is not failure. Rest is not surrender. Documentation, cleanup, learning, and walking away before judgment degrades are all part of the work.
Rule 12
The system should work. The team should understand it. The next person should inherit fewer mysteries, not more.
Everything else is implementation details.
End of volume one. The field work continues.