"Knowledge is always cumulative and we therefore concede that future eras will know more than we do." — Kathryn Schulz
Welcome to my personal, living handbook for building software solutions holistically and sanely. This repository captures my evolving mental models, design principles, and best practices across the entire spectrum of software creation—from the high-level architecture down to the daily routines that keep us productive.
This knowledge base is organized into five core parts, representing the dimensions of effective software delivery:
- Architecture: The "Why" and "Where". Systems thinking, evolutionary architecture, Domain-Driven Design, and the structural patterns that allow software to bend instead of break.
- Engineering: The "What". The tactical implementation details across APIs, Backend, Frontend, Cloud Infrastructure, Security, and AI integration.
- Management: The "Who" and "When". Agile methodologies, the software development lifecycle, engineering leadership, and team dynamics.
- Productivity & Mindset: The "How I Work". Mental models, critical thinking, problem-solving frameworks, and personal time management (Eat That Frog, PARA, ABCDE).
- Communication: The "How We Connect". The art of wordsmithing, documentation frameworks (Diátaxis, Zettelkasten), and effective team communication (LMAO, ELMO).
| Strategy | Mindfulness |
|---|---|
| API-first | Speak concisely and directly |
| Feature Flags / Circuit Breaker | Be consistent in group meetings |
| Diagram as Code | Professionalism and leadership |
| Well Architected | 80/20 Principle |
| Finite State Machine | Self Decentralization |
| uArch / "Customer Journey" | |
| Effective: Working on the right thing | |
| Throw-away-code (refactor) |
Simplicity is a great virtue, but it requires hard work
| ⚡ ACT NOW | 💘 PROACTION |
|---|---|
| 💬 DISTRACT | 🛑 DETRACT |
Dive right into the Table of Contents (SUMMARY.md) to explore the full structure of the book.
Design, Decide, Simplify, Code, Document, Communicate, Estimate, Balance, Consult, Market.