Appendix
About This Manual
What This Is
A field manual for software engineers. Practical, reference-oriented, available when you need it.
The frameworks here (P-Cubed, Levels of Work, The Body Plan) emerged from real projects, real failures, and the pattern recognition that comes from solving problems across different domains. They are not theory, and they are not a universal method: they are one engineer's working model, composed from ideas learned from others, refined through use, and still evolving. The Blank Terminal states the contract for reading them.
What Informs It
-
The canon: Sandi Metz, Kent Beck, the GOOS authors, Martin Fowler, John Ousterhout. The reading list in The Canon appendix represents books worth your time.
-
Mistakes made: Every framework here came from getting it wrong first. Shipping too fast, shipping too slow, building the wrong abstraction, skipping the spike.
-
Military discipline: Twenty years in the Air Force before software. The principles transfer: master your gear, train how you fight, you fall to your training.
Philosophy
Engineers are problem solvers first and coders second. The code is an artifact of the work, not the work itself.
This manual treats architecture as tradeoffs, not "best practices." Every decision is choosing what you're willing to give up.
You fall to your training. The habits you build in calm are the habits you'll have in crisis.
Steel sharpens steel. The veterans invested in me. This manual pays it forward.
Colophon
The Engineer's Manual Volume I, Working Edition Revised continuously
This is a working edition. Content is still being cut, revised, and proven against real use.
Built with Eleventy and Tailwind CSS. Hosted on GitHub Pages. Set in system fonts for maximum compatibility and speed.
Errata & Contributions
Found an error? Have a suggestion? Reach me on LinkedIn.
License
This work is licensed under Creative Commons Attribution-ShareAlike 4.0. Share it, adapt it, give credit and share alike.
Author
Tommy Caruso linkedin.com/in/tommycaruso