File 01AI architectureDeclassified

The path to becoming an AI architect

A practical route from software engineer to the person who decides where AI belongs in a system, and where it does not.

By Vipin SinghReading 8 minRoute 7 phasesCheckpoints 17

00 // BriefingWhat the job actually is

"AI architect" is one of the most used and least defined titles in technology right now. Strip away the hype and the job is clear: an AI architect designs systems in which models are one component among many, and is accountable for how the whole system behaves in production, including its quality, cost, speed, safety and the people who depend on it.

That makes it a different job from a machine learning researcher, who advances models, or a data scientist, who builds and evaluates them. An AI architect decides where a model belongs, what surrounds it and what happens when it is wrong.

This guide is for software engineers, solution architects and technical leads who want to make that move. It is a route, not a reading list: seven phases, each with what to learn, what to build and a checkpoint that tells you when you are ready for the next.

  1. Foundations
  2. ML literacy
  3. Hands-on LLMs
  4. Patterns
  5. Production
  6. Leadership
  7. Keep learning
The rule that runs through every phase

Use AI where ambiguity exists. Use deterministic software where correctness, state and compliance matter.

Phase 01Foundations you cannot skip

Most AI systems fail the way distributed systems fail: timeouts, partial failures, bad data and unclear ownership. The model is rarely the first thing that breaks. That is why the strongest AI architects are, first of all, strong software architects.

What to learn

  • Distributed systems: service boundaries, APIs, queues and events, consistency and idempotency.
  • Data: data modelling, pipelines, data quality and lineage, so you know where every piece of data comes from.
  • Cloud: compute, storage, networking, identity and cost on at least one major platform.
  • Security and observability: authentication and authorisation, secrets, logs, metrics and tracing.

What to build

Take a system you know and draw its architecture end to end: every dependency, every data store and every way it can fail. If you cannot draw it, you cannot safely put a model inside it.

Checkpoint

Phase 02Enough machine learning to make good calls

You do not need to train frontier models. You do need to understand what models can do, how they are evaluated and how they fail, well enough to challenge a claim and choose an approach.

What to learn

  • Core concepts: supervised and unsupervised learning; training, validation and test sets; overfitting and data leakage.
  • Metrics: precision and recall, and why accuracy alone misleads when one outcome is rare.
  • Embeddings: turning text, images and records into vectors that can be compared and searched.
  • How large language models work, at a working level: tokens, context windows, attention as an intuition, sampling and temperature.
  • Their limits: confident wrong answers, non-determinism, sensitivity to wording and knowledge that stops at a training cut-off.
Field note

A model that is 95% accurate can still be unusable. If the 5% it gets wrong are your most expensive cases, the number that matters is the cost of those errors, not the average.

Checkpoint

Phase 03Build with LLMs, hands on

Reading about models is not enough. Architects earn credibility by having built what they design, so this phase is about shipping small, real prototypes and measuring them.

Skills to practise

  • Prompting for structure: clear instructions, examples and outputs validated against a schema instead of free text.
  • Tool calling: letting a model request an action that your own code then checks and performs.
  • Retrieval-augmented generation (RAG): chunking documents, embeddings, vector and keyword search, re-ranking, and answers that cite their sources.
  • Evaluation: a set of real test cases with expected outcomes, run every time you change a prompt, a model or the data.
  • Cost and latency: tokens per request, caching, and sending easy requests to smaller, cheaper models.

Three projects worth building

  1. Questions over your own documents. A RAG assistant that answers from a document set and always shows its sources. Measure how often the answer is actually supported by the cited text.
  2. Extraction with confidence. Pull fields out of messy documents such as invoices or forms, attach a confidence to each field, and send low-confidence fields to a person instead of guessing.
  3. A small agent with a hard stop. An assistant that can use two or three tools, with one action that always needs a person's approval. Log every step it takes.
Checkpoint

Phase 04Architecture patterns for AI systems

This is the heart of the role. The question shifts from "can a model do this?" to "where should the model sit, what surrounds it, and who is accountable for the outcome?"

Patterns to know well

  • AI proposes, rules decide, people approve. The model handles the ambiguous part, such as reading a document, while deterministic workflow handles state, approvals and the final decision.
  • Confidence-based routing. Confident results flow straight through and uncertain ones go to a review queue. The threshold is a business decision, tuned against real data.
  • Human in the loop. Design the review step as part of the product, with its own interface, workload and metrics, not as an afterthought.
  • Guardrails. Validate inputs and outputs, screen for personal data and check policies before anything reaches a user or another system.
  • Retrieval that respects permissions. A retrieval system must only return what the person asking is allowed to see.
  • Agents with boundaries. Agents can reason and act, but permissions, approvals and auditability stay explicit in the workflow, not in the prompt. A single agent with good tools usually beats an elaborate multi-agent design.
  • A model gateway. One layer between your applications and model providers for routing, fallbacks, cost tracking and swapping models without rewriting applications.
Warning

Treat model output as untrusted input. Never let generated text directly trigger a privileged action, query or payment without validation and, where it matters, a person's approval. Prompt injection is real, and it arrives through documents, emails and web pages as well as chat boxes.

Checkpoint

Phase 05Production: operations, security and governance

A prototype proves an idea. Production proves that an organisation can rely on it. Most of the work, and most of the risk, lives here.

What production needs

  • Observability: a trace of every model call, with the prompt version, model version, tokens, latency and outcome.
  • Evaluation in the delivery pipeline: the test set runs automatically, and a change that makes results worse does not ship.
  • Versioning: prompts, retrieval settings and model choices versioned like code, so any answer can be reproduced and explained.
  • Security: protection against prompt injection and data leakage, secrets kept out of prompts and access controls on every data source.
  • Governance and audit: who approved what, which model produced which output and how a decision can be replayed later.
  • Cost control: budgets, alerts and cost reporting per feature, before the invoice surprises anyone.
  • Responsible AI: checks for bias, clear disclosure when people are dealing with AI, and a way to reach a person.

Two references worth knowing: the OWASP Top 10 for LLM applications for security risks, and the NIST AI Risk Management Framework for governance.

Checkpoint

Phase 06Trade-offs, decisions and leadership

Architects are paid for judgement. In AI that means making decisions under uncertainty and explaining them to people who have no interest in tokens.

Decisions you will make again and again

  • Buy, build or adapt: a hosted model API, an open-weight model you run yourself, or fine-tuning, weighed on quality, cost, latency, data residency and licensing.
  • Which model for which job: the largest model is rarely the right default.
  • Where the line sits between AI, configuration, code and people at each step of a process.
  • What "good enough" means: the accuracy, review effort and cost of errors the business will accept.

How to lead them

  • Write short architecture decision records for AI choices, with the options, evaluation results, costs and risks.
  • Set expectations early: AI features are probabilistic, so the plan must say what happens when they are wrong.
  • Design for change: models and prices change every few months, so keep providers behind clean interfaces.
  • Measure business outcomes such as time saved, error rates and throughput, not just model scores.
Checkpoint

Phase 07Keep learning without drowning

The field moves every week. You cannot follow everything, and you do not need to. A steady routine beats bursts of hype.

  • Follow the release notes of the model providers and tools you actually use.
  • Keep a personal lab repository and reproduce one small experiment a month.
  • Read selectively: summaries first, then the few papers that change how you would build.
  • Test claims against your own evaluation set before trusting a benchmark.
  • Teach or write about what you learn; explaining a pattern is the fastest way to find its gaps.

08 // Route planA twelve-month route

Adjust it to where you start. An experienced architect can move faster through the first two phases; someone new to architecture should spend longer on them.

MonthsFocusWhat you finish with
1–2Foundations and ML literacyAn end-to-end diagram of a system you know, and a plain-language explanation of how LLMs work
3–4Hands-on LLMsProject 1: questions over your own documents, with sources and an evaluation set
5–6Extraction and evaluationProject 2: extraction with confidence scores and a review queue
7–8Patterns and agentsProject 3: a small agent with tools and a human approval step
9–10ProductionObservability, cost tracking and evaluation in the pipeline for one project
11–12LeadershipA real use case at work or for a client, with a decision record and measured results

Resources worth your time

  • Designing Data-Intensive Applications by Martin Kleppmann: the foundations of reliable data systems.
  • Designing Machine Learning Systems and AI Engineering by Chip Huyen: how machine learning and foundation-model systems are built and run in practice.
  • Machine Learning Specialization by Andrew Ng: a clear grounding in core machine learning.
  • Practical Deep Learning for Coders from fast.ai: hands-on deep learning for programmers.
  • Neural Networks: Zero to Hero by Andrej Karpathy: build neural networks, and a small language model, from scratch.
  • The official documentation of the model providers and cloud platforms you use, which is usually the most current source.
  • Optionally, an AI or machine learning certification from your main cloud provider, if you want a structured syllabus.

End of briefing

Start with phase 01 this week.

The route is long, but every phase leaves you with something you can show. Draw one system you know, end to end, and mark every place a model could fail inside it. Then pick your first project.

Next files