// Topic
Design
Definition
Design coverage in this archive spans 4 posts from May 2016 to Jan 2026 and leans into practical engineering craft: interfaces, testing, and maintainable implementation details. The strongest adjacent threads are architecture, ai, and go. Recurring title motifs include ai-native, api, architecture, and patterns.
Key claims
- The through-line is clarity first: simple designs that survive change beat clever abstractions.
- The consistent theme from 2016 to 2026 is disciplined execution over hype cycles.
- This topic repeatedly intersects with architecture, ai, and go, so design choices here rarely stand alone.
Practical checklist
- Keep interfaces small, automate regressions early, and make operational assumptions explicit in code.
- Start with the newest post to calibrate current constraints, then backtrack to older entries for first principles.
- When boundary questions appear, cross-read architecture and ai before committing implementation details.
Failure modes
- Abstracting before usage patterns are stable enough to justify indirection.
- Treating style consistency as optional until quality and velocity both degrade.
- Applying guidance from 2016 to 2026 without revisiting assumptions as context changed.
Suggested reading path
- Start here (current state): AI-Native Architecture Patterns 2026
- Then read (operating middle): Your API Is a Contract You Can’t Take Back
- Finish with (foundational context): API Design Principles That Stand the Test of Time
Related posts
- AI-Native Architecture Patterns 2026
- Architecting AI-Native Applications (Without the Delusion)
- Your API Is a Contract You Can’t Take Back
- API Design Principles That Stand the Test of Time
References
4 posts
- AI-Native Architecture Patterns 2026: Production Guide
Production AI architecture patterns for gateways, retrieval, evaluation, fallbacks, cost control, and ownership.
Architecting AI-Native Applications (Without the Delusion)
The architecture of an AI-native app is fundamentally different from bolting a model onto a CRUD app. Here is how I structure them -- with code, layers, and hard-won opinions.
Your API Is a Contract You Can't Take Back
Hard-won lessons on designing HTTP APIs that survive real integrations, drawn from building fintech and mobility platforms.
API Design Principles That Stand the Test of Time
Lessons from building the fintech startup's financial data API: the REST conventions that actually matter, the ones that don't, and why consistency beats cleverness every time.