Kiragu Maina · the architect's working fileStudio companion → home.alkenacode.dev
Kiragu Maina
On file · about

Architect of working systems.

Bio

I am Kiragu Maina, a systems architect based in Nairobi. I design and build AI-native enterprise systems, the kind that have to keep working through provider outages, rate limits, and 03:00 traffic spikes.

My favourite work lives in the layer most portfolios skip: queues, fallbacks, idempotency, observability, cost-aware routing, the audit trail. I treat the "hidden 90 percent" as the product.

I currently run Shellwire, an autonomous newsroom orchestrated by twelve LLM providers, and I take selected contract engagements with teams that need an architect, not another tutorial.

How I work
01

I write the architecture decision before the first commit.

Trade-offs, constraints, the failure mode I am designing for. If I cannot defend the diagram, the code does not deserve to exist.

02

I prefer Postgres until proven otherwise.

Row-level security, materialised views, JSONB, listen/notify. Most teams reach for a new database before they have used the one they have.

03

I plan for the provider to go dark.

Three-tier fallback chains, ranked-fallback orchestration, cached last-known-good. AI vendors fail. Networks fail. Pipelines should not.

04

I instrument before I optimise.

Latency, tokens, queue depth, error rate, by provider. You cannot tune a system you cannot see.

05

I keep the dev loop tight.

Docker Compose for local parity, hot reload, fast tests, real seed data. Friction in the loop is the largest hidden cost in a project.

Stack on file
Languages
TypeScriptPythonBash
Backend
NestJSFastAPIBullRedisPostgreSQLTypeORM
Frontend
Next.js 14React 19TailwindVite
AI
Multi-provider councilOpenRouterGemini, Groq, Cerebras, SambaNovaXenova / transformers.jsQdrant
Infra
DockerDocker ComposeGitHub ActionsLinux serversCloudflare
Distribution
Programmatic SEOIndexNowGSC APISitemap integrityTelegram + Twitter automation
Systems on file
04