Zakaria EL AISSAOUIField notes on building software · Get in touch
Software architect & AI consultant — Paris

Most expensive software problems aren’t hard. They’re unclear.

I’ve spent ten years turning the unclear kind into the boring kind — and boring ships. Teams call me in when something feels wrong but nobody can name it yet: the roadmap that keeps slipping, the “quick” AI feature that never stabilises, the codebase everyone’s afraid to touch. My job is to make it clear. Then make it boring.

How I think

I don’t start with the stack. I start with the words.

When a team’s language is muddled — when “user” quietly means five different things — the boundaries are muddled too, and no framework will save you. So I fix the language first. The architecture tends to fall out of it.

Then I write down the trade-offs and the failure modes before a line of code, and choose the smallest design that survives the next twelve months — not the cleverest one. I build it typed, tested, and documented well enough that you own it after I’m gone. Cleverness is a liability; I optimise for whoever reads this at 2 a.m., six months from now.

Field notes

The same expensive mistakes, over and over. A handful I’ll die on:

Architecture

Your architecture problem is usually a naming problem.

Muddled words make muddled boundaries. Get the language right and the diagram writes itself; get it wrong and no amount of microservices will save you.

AI

Adding AI is not a strategy.

Most “AI features” are a demo in a trench coat — dazzling in the meeting, unmaintainable by Friday. I start from the job to be done and the evals. The model is the easy part; the retrieval, guardrails and fallbacks are the work.

Tooling

The unglamorous work is the leverage.

Test harnesses, CI, internal tooling — they never demo well. They just quietly make a team twice as fast and far less afraid to ship. I build the boring infrastructure that pays for itself in a month.

Scale

You don’t have a scale problem yet.

Most systems get re-architected for a load they’ll never see, at the cost of the shipping they need today. Design for one more order of magnitude, not six. Buy the scale you need with the money you have.

Teams

Adding people to a late project makes it later.

The bottleneck is rarely hands; it’s unclear ownership and slow feedback loops. I fix the loop before I’d ever reach for more headcount.

Evidence

Two things I own end to end. Most of the rest is under NDA — so instead of a gallery, here’s proof of the thinking above.

Exhibit A — a full system, shipped

AI Lead Capture & Qualification System

Proof I take a fuzzy idea — “capture leads with AI” — to a shipped, secure, end-to-end system.

A Chrome extension captures the lead on the page you’re viewing; an AI backend scores fit and drafts outreach with Claude; a Next.js dashboard makes every past lead searchable by meaning with pgvector RAG. Secrets stay server-side; the extension ships with minimal permissions.

TypeScript · Chrome MV3 · Hono · Claude · Voyage · Supabase / pgvector · Next.js
Exhibit B — a live product, in daily use

Pix2Word

Proof I ship real products people use — not demos.

A free, no-sign-up tool that turns any image into AI-ready prompts for Midjourney, Stable Diffusion and Flux — six modes, structured output, multiple languages, vision-AI powered. Fifteen generations a day, no card, no watermarks.

Vision AI · Next.js · Prompt engineering · Multi-language · Live

Engagements

Where I help — start small, scale up.

  • Architecture & system designReviews and design: data models, API contracts, security boundaries, the scale-vs-cost calls — before they get expensive.
  • AI integration & RAGLLM pipelines, retrieval over your own data, evals and guardrails. Production-ready, not a demo.
  • Testing, tooling & harnessThe infrastructure that makes a team fast: test harnesses, CI/CD, internal tooling and DX.
  • Web & extensionsProduction-grade Next.js apps and dashboards, and Chrome extensions — prototype to launch.

Start on Fiverr with a paid review or a working prototype — low risk, and easy to scale up from there.

Let’s talk

If this is the kind of thinking you want on your problem, let’s talk.

A review, an AI integration, a workflow audit, or a full build — tell me the problem and the outcome you’re after. I usually reply within a day.