Khalid ShamsPrincipal Solutions Architect

Principal Solutions Architect · Full-stack builder · Enterprise cloud, data & AI

I design the estate, and I still write the code that runs on it.

Architects compare three alternative system models and a blank recommendation record at a cobalt-accented table.Systems, trade-offs and decisions, made visible. Explore the illustrated library →

Fifteen years in enterprise technology, five of them at Microsoft across cloud architecture, solution assessment, customer success and partner leadership. The whole time, I kept building products of my own, end to end: the data model, the API, the identity, the front end, the pipeline, the bill. I work where the expensive decisions get made, in regulated, multi-tenant, mission-critical estates where being wrong costs real money and someone has to own the call.

What AI changed. Not what a good system is. Where the cost sits. Building used to be the expensive part; a small team can now produce a working system in a week. The expensive part is deciding what that system is allowed to do, proving it does only that, grounding it in data someone governs, and being able to stop it. That is architecture work, and it is the reason I never stopped building: you cannot set those boundaries well for a system you could not build yourself.

The old way was design it, build it, hope. The new way is decide what it may do, prove it, then let it build itself under supervision.

Work with me · Principal architecture

Before you commit the budget,
challenge the architecture.

A cloud bill without a clear explanation. A tenant boundary no one has tested. A workflow ready for automation, with no agreed limits. Bring me one consequential decision. I will help you make it with the assumptions, risks and next steps in view.

The deliverable · A decision your team can defend

Architecture Decision Review

I work with founders, engineering leads and consulting partners who need an independent technical judgment on one system or workflow. Cloud, data, SaaS, reliability or AI. The answer may be a smaller change, a different design, or a reason to stop.

  1. 01

    Frame the decision

    A 90-minute working session: the constraint, the evidence, the dependencies and what a good outcome must preserve.

  2. 02

    Make the trade-offs explicit

    A written brief with a current-state sketch, two or three viable options, cost assumptions, failure modes and a recommendation with conditions.

  3. 03

    Leave a usable next move

    A sequenced action list, an owner and acceptance check for each step, then a 30-minute handoff with your team.

Open a sample decision brief Illustrative, not a client result

Decision note 01 · Illustrative extract

Resize the database, or isolate the noisy workload?

Decision
Whether a shared tenant pool needs more capacity or a different placement rule.
Evidence needed
Per-tenant load, query waits, peak concurrency, current spend and the latency target. An aggregate CPU chart alone is insufficient.
Options
Resize the pool; isolate the demanding tenant; or first address the dominant query. Compare operational effort, recurring cost and failure impact.
Conditional recommendation
If one tenant dominates contention after query tuning, test isolation before resizing the full estate. Otherwise revisit capacity against the measured workload.
Acceptance and rollback
The platform owner compares latency and cost against the agreed baseline, checks tenant boundaries, and retains a tested route back if the trial misses its criteria.

Your brief names the actual evidence, decision owner and thresholds. This example deliberately makes no savings claim.

My starting point: fifteen years in enterprise technology, including five at Microsoft, and hands-on work across cloud platforms, multi-tenant systems and production software.

Read the work behind the judgment →

The learning library, playbooks and tools stay free. The paid work is applying that judgment to your particular system.

A requester brings a damaged lamp to a workshop. A software operator works at a cobalt context tray while an owner and a reviewer oversee the boundary.Outline operator: software metaphor · ⏸ Review boundary

How I draw an AI system

One request, followed through a governed system.

Every drawing on this site uses the same parts: solid figures are people, outline figures are software, a dashed line is a boundary, a gate is where a decision is enforced, gold is cost. Learn the parts once and every page reads the same way. The atlas is where they move.

The SHAMS Method Where AI belongs in your enterprise, and how to keep it safe. An interactive map of the six layers you already run and the seven places AI can go, re-weighted for your industry. Then the eight gates I make a team sign before it acts, and a live check you can run on your own system. Read the method →

Learn AI · start here

Three doors into the same place.

Forty-four ideas on a living map, two illustrated lessons you can run, six guided paths through them, and a route for architects who already know what they are building.

Door 1

I'm new to this

Six short paths, in order. Each one ends with something you can picture and explain.

Start path 1

Architects compare three alternative system models and a blank recommendation record at a cobalt-accented table.
Read the concept diagram

Door 2

I design systems

Say what you are building. Get the lesson to watch, the gate to run, the playbook and a worked example.

Choose a situation

Door 3

Explore freely

The living map, the two atlas lessons, the stack, the questions people ask. Go anywhere; progress is kept.

Open the map

Tools · reference calculators Check the number before you say it out loud. The availability you can actually promise is every hard dependency multiplied together, and the recovery time is whatever the restore takes when somebody runs it. The first tool does both, in your browser, and ends in a note for the design document. Open the tools →

Playbooks

How I build it: the questions first, then the Azure tools in the order they go in.

Six principal-level playbooks, one per area I'm asked to own. Each has the questions I ask before anything is built, the build sequence, why that order matters, what it looked like when it was real, and what I leave behind. Written to be kept and reused.

01From a demo that works to a system people depend onAgentic AIAgents, grounding, evaluation, and governance: the questions I ask, the Azure build in order, and what it looked like when it was real.Entra IDAzure AI FoundryAzure AI SearchMicrosoft FabricAzure FunctionsRead the playbook → 02Retire, rehost, replatform, or rebuild, decided on evidenceApplication modernizationAssessment, the 6R decision, migration sequencing, and the cutover that is really a change of ownership.Azure MigrateService MapAzure Landing ZonesAKSContainer AppsRead the playbook → 03A lakehouse people trust, because someone owns each layerData & AI platformMicrosoft Fabric, medallion layering, data contracts, semantic models, and the governance that makes AI safe to ground on it.Microsoft FabricOneLakeData FactoryLakehouse & WarehouseSemantic modelsRead the playbook → 04Controls that land before the workloads doSecurity, identity & governanceIdentity as the perimeter, policy as code, and detection you can afford: the questions, the Azure build in order, and what it looked like in a regulated programme.Microsoft Entra IDConditional AccessPIMAzure PolicyManagement groupsRead the playbook → 05A landing zone that can carry a thousand tenantsCloud foundations & multi-tenant SaaSThe platform underneath everything else: landing zones, tenant isolation, tiering, resilience and cost, with the questions, the Azure build in order, and what it looked like at 1,000+ tenant databases.Azure Landing ZonesManagement groupsAzure PolicyBicep / TerraformHub and spokeRead the playbook → 06Architecture advice ages badly when you stop buildingFull-stack product engineeringHow I take a product from a blank repository to something people depend on: data model, API, auth, front end, pipeline, observability and cost, with the questions, the build in order, and three products I ship myself.PythonFastAPITypeScriptReact / Next.jsPostgreSQLRead the playbook →

What I'm for

Three situations where I earn my keep.

Not a service menu. These are the rooms I get called into, and what changes once I'm in them.

An outline software operator offers a proposal to a human reviewer beside an evidence tray and a closed gate.Outline operator: software metaphor · ⏸ Proposal awaiting review
Read the diagram

The AI project that has to become real

A pilot impressed someone and now it needs to survive contact with production, compliance, and a budget. I bring the boundaries, the grounding, the evaluation harness, and the honest read on what is and isn't ready.

Architects inspect miniature infrastructure models, untangling cobalt routes across a shared planning table.
Read the diagram

The estate nobody can reason about

Multi-tenant sprawl, migration debt, identity that grew organically, cost that can't be explained. I map it, name the constraints out loud, and produce a sequence that keeps the business running while it changes.

Architects compare three alternative system models and a blank recommendation record at a cobalt-accented table.
Read the diagram

The decision that's been deferred twice

Everyone knows it needs making; nobody wants to own it. I narrow the option space to two or three defensible paths, write down why, and put my name on the recommendation.

Speaking at a high level is earned in the deep-dive conversations. The executives who let me set scope are the ones I sat with long enough to understand what keeps them up at night, and told the honest number to, early.

Selected work

Engagements, and what actually changed.

Client names withheld. The problems, the decisions, and the outcomes are exactly as they happened. Most of what I know about scope I learned in these rooms: it gets set in the conversation with the people who own the outcome, once they trust you enough to say what they are actually worried about, and it holds only if the expectations are written down that day.

Numbers, in context

These four numbers come from one assessment-led role at Microsoft, not a career total. I show them because someone other than me measured them. The work below is the rest of the story.

$7.6M
Pipeline generated from architecture-led assessments
$5.1M
Incremental committed revenue closed against them
$4.5M
Cost avoidance surfaced in one business-value assessment
$532K
Direct Azure consumed revenue attributed to delivered designs

Agentic AI

A complete agentic system, zero to delivered

Context
A client needed an agentic AI system built on Anthropic's Claude platform. Not a proof of concept, a delivered system.
What I did
Owned every milestone from inception through completed delivery: solution architecture and agent boundary design, multi-agent orchestration, tool and function integration against real systems of record, an evaluation harness with a written failure-mode catalogue, and production hardening: guardrails, fallback paths, observability, cost controls.
Outcome
Delivered and hardened. Comparative evaluation across Claude, ChatGPT, Gemini and DeepSeek informed the model and orchestration choices rather than assumption.

Multi-tenant SaaS

1,000+ tenant databases, stabilised

Context
An ISV running a SaaS estate on 1,000+ Azure SQL tenant databases with unreproducible performance complaints and unpredictable cost.
What I did
Classified workloads, defined explicit Business Critical graduation criteria, worked the noisy-neighbour and CPU risk directly, and laid a staged path toward Fabric and AI readiness on a foundation that could carry it.
Outcome
Tier decisions became rule-based instead of complaint-driven, and the modernisation path stopped being blocked by platform instability.

Business value

$4.5M in cost avoidance across ~3,000 employees

Context
An organisation of roughly 3,000 employees and 10 vendors, with overlapping tooling and untested assumptions about its own resilience.
What I did
Led a business-value assessment mapping applications, data, infrastructure, identity, security, cost and dependencies onto a single view, documenting 32 gaps and connecting each to a cloud or services decision.
Outcome
$4.5M in identified cost avoidance. Almost none of it from renegotiation, nearly all of it from finding what the organisation was doing twice.

Regulated

Data, security and governance for a financial services programme

Context
A multi-million-dollar initiative across banking and capital markets stakeholders, with regulatory obligations shaping every architectural option.
What I did
Contributed the data, security, governance and Microsoft Fabric / Sentinel strategy: access boundaries, policy enforcement, monitoring, and the sequencing that let controls land before workloads did.
Outcome
A governed foundation the programme could build data and AI capability on without relitigating compliance at every step.

Enablement

The onboarding standard for new cloud architects

Context
New Cloud Solution Architects were ramping inconsistently, each rediscovering the same judgment calls.
What I did
Authored the onboarding guide and enablement experience covering account preparation, customer discovery, technical qualification, architecture readiness, milestone discipline, escalation paths, documentation standards, technical selling, and delivery handoff.
Outcome
Adopted as the standard enablement path for the role. The clearest evidence that what I do scales past me.

What I got wrong first

Most of the method came from going down the wrong road and noticing.

Every rule on this site has a day attached to it: the day I did the opposite and paid for it. These are the ones I'd rather you learn from my version of.

The dashboard that got applause

I built the visible part first.

Early on I shipped dashboards that were fast, clean and useful-looking, with a backend still trying to catch up to what the front end had already promised. Months later the same team was spending its week keeping things upright: brittle data contracts, unclear ownership, lineage nobody could explain. You cannot retrofit a foundation under a system people already depend on.

Now: data contracts and ownership first, slightly over-built, before anything with a chart on it. It feels slow for a month and is the only version that stays fast.

A PostgreSQL escalation

I nearly resized before I understood.

An Azure Database for PostgreSQL Flexible Server under real pressure, a customer whose whole modernisation programme depended on it, and a room full of confident theories. The instinct is to add capacity and move on. We stopped and established where the load actually came from, which queries, and what the resilience posture really was versus what everyone assumed. Resizing first would have meant the same problem at a higher bill, and the credibility spent before the harder conversation.

Now: root cause before remediation, every time, even when the room wants the fast answer.

"Send everything to Sentinel"

I mistook visibility for coverage.

I have seen the invoice that sentence produces: every verbose log from every subscription flowing in, priced per gigabyte, and a SOC drowning in data it never wrote a single detection for. Seeing everything felt safe. It was expensive noise.

Now: detection first, ingestion second. Decide what you need to catch, trace backwards to the sources that feed it, and let the log bill be a consequence of that choice.

The pilot that never ended

I let a pilot start without a definition of done.

Six months in it still had users, a Teams channel and a renewed budget line, and no decision, because nobody had written down what would trigger a production build or a shutdown. It lived in the space between, indefinitely.

Now: exit criteria go in the first document, before the architecture. A clear no is a win; the only loss is the drift into permanence.

The honest number

I rounded an estimate to what the room wanted to hear.

The honest answer was somewhere between four and nine months depending on three things nobody knew yet. What got written down was six, because it fit the slide and the fiscal year. Month seven arrived, and the person who said six was explaining.

Now: a range, the assumptions that put you at each end, and what it costs to resolve the biggest unknown early. Less satisfying in the meeting. Far better in month seven.

My own AWS platform

I set the cost alarm where it would only catch disasters.

Running a consumer platform alone, I learned that cost is the fastest signal you have. Errors need a log to be read; latency needs a user to complain; cost just accumulates and is measured for free. The alarm I eventually set low enough to be occasionally annoying has paid for itself three times: a retry loop over a weekend, a storage class with retrieval charges I had not read carefully, a test environment I forgot existed.

Now: budgets per environment, thresholds at "surprising" not "catastrophic", daily granularity, and a human who receives it.

More of these, twice a week, in Writing. The rules they became are the eight gates.

Writing

Notes from the work.

What I'm learning, as I learn it. Published here first, then on LinkedIn.

October 15, 2026business value

The cheapest migration is the one you skip

In one assessment, a third of the application estate had no owner. You don't migrate that. You retire it.

Read →

October 13, 2026cloud

A landing zone is a political document

The subscriptions and policies are the easy part. A landing zone is really an agreement about who owns what.

Read →

October 8, 2026healthcare

Where I put the human

I architected an EMR holding 250+ patient records, and it changed where I put the human.

Read →

October 6, 2026security

The agent inherits the user's permissions

The most important design decision in an enterprise AI system isn't the model.

Read →

October 1, 2026communication

Change the altitude, not the substance

An ad hoc note I was inspired to write. A conversation with people who think about building, and the one habit that lets you talk to a CTO and an engineer in the same hour without lying to either.

Read →

October 1, 2026engineering

The dashboard that got applause

I've built dashboards that got applause and then quietly became the most expensive thing in the system.

Read →

All writing (11) →

Built, not just advised

I still ship the thing myself.

Architecture advice ages badly when you stop building. These are mine, end to end: architecture, data model, services, security, infrastructure, release.

Full stack, at this level, is not a list of frameworks. It means owning every layer a system can fail in, from the schema to the invoice, and knowing which one is about to. It is why my recommendations to a team of forty are things I have run alone at two in the morning. And it is what AI has made more valuable, not less: when a model can write most of the code, the person who knows how the layers fail is the person who decides what gets shipped.

FAJR Global EMR

Production · Healthcare

A HIPAA-aligned electronic medical record built in Python for a non-profit, now carrying 250+ active patient records. Canonical patient record across demographics, cases, labs, imaging, documents and clinical updates, with multilingual document intake and OCR, identity reconciliation, immutable audit and provenance, and a human at every point where a judgment enters a record.

HILUM Systems

In development · Platform

A multi-tenant EMR and practice platform that stands up a clinical practice in minutes: patient portal, admin console, scheduling, notifications. Identity, patient context, authorisation, audit and workflow built as shared platform services so specialty applications extend the platform instead of becoming silos.

DivineMarvels

Live · Consumer platform

A knowledge platform I designed, built and operate on AWS with MongoDB and S3. Word-by-word recitation and audio, a personalised dashboard, and AI features governed by explicit provenance rules: recitation follow-along with per-word highlighting, and audio-based verse detection that jumps the reader to the matching passage.

Depth

Where I go deep.

Listed by what I've actually shipped or remediated, not by what I've read about.

Agentic & Generative AI
Anthropic Claude agent systems · multi-agent orchestration · tool and function integration · Azure AI Foundry · RAG and knowledge assistants · evaluation harnesses and benchmarks · responsible-AI guardrails · Azure OpenAI patterns · Copilot scenarios
Data & Analytics
Microsoft Fabric (lakehouse, medallion layering, semantic models) · Azure SQL at multi-tenant scale · Azure Database for PostgreSQL Flexible Server · operational-to-analytical flows · Python · SQL · working familiarity with Databricks and Snowflake
Cloud & Modernization
Azure Landing Zones · AKS and Kubernetes · App Service · serverless · Azure Arc · Azure VMware Solution · multi-tenant SaaS and tenant consolidation · Azure Migrate · disaster recovery and resilience · FinOps · AWS migration experience
Security, Identity & Governance
Microsoft Entra ID · AD Connect · SSO / SAML / SCIM · MFA and Conditional Access · Identity Protection · RBAC · PIM / PAM · Azure Policy · Defender for Cloud · Microsoft Sentinel · Azure Monitor and Log Analytics · HIPAA-aligned controls
Credentials
Microsoft Certified: Azure Solutions Architect Expert · Azure Administrator Associate · MS Computer Science · BS Management Information Systems, ASU W. P. Carey · English and Arabic

Predictable beats clever. Boring is a feature. The system that wins is the one someone can explain, stop, and change on a Tuesday.

Khalid Shams

Next

If the wrong decision would be expensive, that's my kind of problem.

I offer fixed-scope architecture reviews and separately scoped implementation work. I'm also open to principal-scope architecture roles, remote or hybrid across the U.S., with travel to customers. Start with the decision you need to make.