Kubai Kevin

14 articles tagged Software Architecture

7 ADR traps that cause stale decisions

How architecture decision records go stale: template bloat, drifting status fields, hidden storage, broken numbering, missing context, no workflow trigger, no review.

15 min read · 12 November 2026

Agentic systems: architecture principles that hold

How to enforce deadlines, token budgets, idempotency keys and bounded fan-out around multi-model agent graphs, with Python code and tests.

15 min read · 23 October 2026

Promotions in the AI era: the mechanism

Why code volume stopped being a promotion signal, and how decision artifacts — ADRs, PR descriptions, instrumented tradeoffs — restore legible evidence of judgment.

17 min read · 8 October 2026

Agent architecture: the new model trap

Newer models made prompt chaining obsolete but not policy enforcement. How to keep a deterministic layer around a capable planner.

17 min read · 27 September 2026

Agent API versioning: why clients break on upgrade

Why agent version upgrades break downstream clients, the contract drift behind the errors, and how to pin, check and roll out versions safely.

12 min read · 14 September 2026

Why scaling agents kills plain logs

Why plain-text logs and unpinned models break down past a handful of agents, and how to add structured logging plus hash verification.

11 min read · 11 September 2026

LLM agents: why monoliths win

Why splitting an LLM agent into micro-services often costs latency, audit continuity and money, and how to measure before you decompose.

11 min read · 10 September 2026

Only boring stacks survive AI services

Why monoliths beat microservices for solo AI builders, how to spot the "one more abstraction" trap, and how to measure when vertical scaling stops working.

16 min read · 31 August 2026

Evolve your monolith without rewriting in 2026

A three-layer FastAPI layout (API, domain, infra) that keeps a monolith evolvable: worked code, failure modes, cache stampede fixes, and how to measure.

15 min read · 19 August 2026

Designing Fintech Backends Around Audit Deadlines

Regulatory audit deadlines change how you should split services. A worked example of transaction boundaries, outbox patterns and WAL-based audit reads.

13 min read · 3 July 2026

AWS Local Zones vs LocalStack: AI microservices in

Compare AWS Local Zones and LocalStack for AI microservices: latency, cost, compliance, and a decision framework, plus how to measure p99 at the edge.

14 min read · 28 June 2026

Monolith to services without a rewrite

Most monolith-to-services migrations fail on data coupling, not code structure. Here is how to audit coupling and measure the latency tax before extracting.

14 min read · 27 June 2026

Why monoliths die slowly in 2026

Monolith decomposition usually fails on data locality, not routing. A step-by-step order for extracting data first, routing traffic later, with checks.

13 min read · 19 June 2026

Cutting cloud egress costs: architecture that works

Egress costs come from small, frequent cross-boundary calls. Learn the architecture patterns that reduce data transfer and how to verify savings.

13 min read · 11 June 2026