Articles
What I learned building and reviewing systems: AI in development, architecture, quality and MLOps.
Software architecture
4- Hexagonal architecture with Spring Boot, from domain to tests Ports and adapters in Java 21 and Spring Boot: a framework-free domain, fakes instead of mocks, and dependency rules enforced with ArchUnit. 7 min read
- Architecture patterns: how to choose and how to scale Modular monolith, layers, microservices, events, hexagonal and serverless compared, plus the three scaling axes, caching and sharding. 8 min read
- Service communication and events with Kafka When to call and when to publish, partitions and per-key ordering, outbox, idempotent consumers, sagas and event sourcing in Java with Spring Kafka. 9 min read
- Designing REST APIs that survive production Resources, methods and idempotency, RFC 9457 errors, versioning and deprecation (RFC 9745), pagination, idempotency keys and webhooks. 8 min read
Delivery and quality
2- CI/CD for Java backends: from commit to cluster A Spring Boot pipeline on GitHub Actions or Jenkins: split tests, Testcontainers, deploy by digest, secrets, GitOps and deployment strategies. 7 min read
- Code quality in practice, and what I learned building archlens-ai The anti-patterns that degrade code the most, cycles, complexity, Fowler's technical debt quadrant, and a case study of my own tool, archlens-ai. 9 min read
AI in development
4- Refactoring with AI without breaking what works A safe workflow for refactoring with AI assistants: characterization tests, one technique at a time, behavior checks and the habits of generated code. 9 min read
- Spec-driven development with AI: shipping features without losing control Write a short spec before asking AI for code, with scope, out of scope and expected files, using ai-kit, a tool I built for this workflow. 7 min read
- MCP for software companies: giving your AI assistant the company's context How to build an MCP server with your company's architecture, patterns and business rules, using Streamable HTTP, registerTool and OAuth authorization. 9 min read
- What AI won't do for you: how I reviewed my templates and e-books before selling them Behind the scenes of products built with AI: what I checked before selling, the mistakes the AI made, and how I scale review to the risk of each change. 7 min read