Skip to content
FrankX.AI
AI ArchitectureAug 27, 202621 min read4,051 words

The AI Architect Guide 2026

TL;DR

An AI architect owns the decisions that connect a business outcome to a system: authority, orchestration, context, models, tools, evidence, and policy. Start with one recurring workflow, write its outcome and authority contracts, choose the smallest control loop that works, and instrument cost, quality, latency, and side effects before expanding the tool surface. The durable asset is the operating evidence, not the provider configuration.

Frank Riemer
FrankX
AI Architect & Independent Creator
Ex-Oracle AI Architect · Starlight & ACOS Systems
A field guide to the decisions, system planes, evidence gates, and operating artifacts required to turn AI capability into a reliable workflow.
Reading Goal

Leave with a reference architecture, decision sequence, and 30-day operating plan for one AI workflow.

AI Architect Recommendation

Treat every model response as a proposal until deterministic policy, evidence, and human authority turn it into an accepted result or effect.

AI CoE pillar: Architecture and governance

TL;DR: An AI architect owns the decisions that connect a business outcome to a system: authority, orchestration, context, models, tools, evidence, and policy. Start with one recurring workflow, write its outcome and authority contracts, choose the smallest control loop that works, and instrument cost, quality, latency, and side effects before expanding the tool surface. The durable asset is the operating evidence, not the provider configuration.

This guide is for the founder, product lead, or technical operator whose AI prototype has started touching real work. The demo already answers. The next question is whether the surrounding system can survive provider changes, bad inputs, retries, partial failures, and a teammate asking, “Why did it do that?”

My proposition is simple: the AI architect owns the seams where probabilistic capability meets business authority. Model selection matters. The lasting work is defining who may act, where state lives, what evidence counts, and how the system stops.

Anything pinned to this month's model news expires in weeks. This page holds the architecture that should still be useful after the August 2026 model names have moved on.

What does an AI architect own in 2026?

An AI architect converts an outcome into a governed operating system. The role sits across product, data, software, security, and operations because an AI workflow crosses all five.

Ownership areaThe decisionThe artifactThe release question
OutcomeWhat result is worth producing?Outcome contractCan we distinguish a useful result from a fluent one?
AuthorityWhat may the system decide or do?Authority mapWhich effects require a named human?
OrchestrationWho chooses the next step?Control-flow recordIs each branch, retry, and stop condition explicit?
Context and stateWhat must persist, for how long, and why?State modelCan a run resume without reconstructing truth from chat text?
ModelsWhich capability tier handles each task?Routing policyCan we change a provider without rewriting the workflow?
ToolsWhich systems may be read or changed?Tool contractAre identity, scope, idempotency, and failure behavior defined?
EvidenceWhat proves quality, safety, cost, and latency?Evaluation packDoes the release gate use real workflow cases?
OperationsWho responds when the system drifts or fails?Runbook and owner mapCan an operator inspect, pause, repair, and roll back?

This is why the title “prompt engineer” is too narrow for the job. A prompt is one implementation detail inside a much larger control surface. The architect is responsible for the system that remains when the prompt changes.

Where should the architecture process begin?

Begin with one recurring workflow and write an outcome contract before drawing the stack.

A useful outcome contract fits on one page:

Workflow:        What recurring job are we improving?
Recipient:       Who receives the result?
Trigger:         What starts a run?
Accepted result: What observable condition means "done"?
Authority:       What may the system read, propose, approve, or execute?
Human gate:      Which decision stays with a named person?
Failure budget:  What can be wrong, late, unavailable, or expensive?
Evidence:        What record lets an operator verify the run?
Owner:           Who accepts, pauses, repairs, and retires the workflow?

This contract prevents the most expensive form of architecture drift: optimizing a model score while the workflow still lacks a clear recipient or accepted result.

Consider invoice exception triage. “Use AI to process invoices” is not an outcome. “Classify incoming invoice exceptions, assemble the supporting evidence, and route each case to the authorized reviewer without initiating payment” is an outcome with a boundary. The second sentence gives you a system to design.

Use three initial baselines:

  1. Quality: how well do people complete the workflow now, measured on representative cases?
  2. Time: where does elapsed time accumulate—waiting, searching, deciding, or executing?
  3. Risk: which mistakes create reversible rework, and which create an external effect?

The baseline is the comparison set for every later architecture claim. Without it, “better” is a mood.

What are the seven planes of a production AI system?

I use seven planes because each one has a different owner, failure mode, and replacement cycle.

PlaneOwnsTypical componentsFailure to design for
1. ExperienceIntent, disclosure, review, correctionUI, API, inbox, approval queueThe recipient cannot see or correct the system’s interpretation
2. OrchestrationSequence, branching, retries, stopsCode workflow, state machine, agent runtimeA loop continues after evidence or authority has run out
3. Context and stateWorking context, durable records, provenanceRetrieval, session state, event log, memory storeChat history becomes the only source of truth
4. Model fabricCapability, routing, fallback, structured outputGateway, model tiers, cache, validationProvider logic leaks into every workflow step
5. Action and integrationReads, writes, credentials, side effectsAPIs, MCP servers, queues, workersUntrusted text can reach an over-scoped tool
6. EvidenceTraces, evals, cost, latency, incidentsEvaluation sets, telemetry, receipts, dashboardsA fluent answer passes with no proof of trajectory or effect
7. Policy and trustIdentity, authorization, privacy, retention, human authorityPolicy engine, approval rules, audit controlsThe model quietly becomes the policy engine

The planes are responsibility boundaries, not a shopping list. A small team can implement several planes in one codebase. Keep the contracts separate even when the deployment is compact.

The difficult choices live between planes. A document crosses from context into orchestration. A model proposal crosses into action. A run crosses from a request into durable execution. Those seams are the subject of four AI architecture decisions that are hard to reverse.

Which architecture decisions deserve a written record?

Write a short architecture decision record when a choice changes authority, state, portability, or evidence. Nine decisions deserve that treatment in almost every serious workflow.

DecisionDefault starting pointEscalate when
Workflow boundaryOne trigger, one accepted resultThe process has independent recipients or risk classes
Control shapeDeterministic workflowThe next useful step cannot be enumerated reliably
Model boundaryOne gateway, task-based routingA provider-specific capability produces measured uplift
Output contractTyped, validated resultThe recipient genuinely needs open-ended prose
State ownerApplication event/state storeThe task is request-scoped and disposable
Tool scopeRead-only, narrow credentialsA measured case requires a write or external effect
Human authorityApproval before consequential effectsThe effect is low-risk, reversible, and policy-approved
Evaluation unitOutcome plus trajectoryA step has no inspectable path and only the final state matters
Failure modeStop, preserve evidence, ask for repairA bounded retry is idempotent and cheaper than escalation

An architecture decision record can be six lines: context, decision, rejected alternatives, consequence, evidence needed to revisit, and owner. Its purpose is to preserve the reason after the tool names have changed.

The irreversibility test

Ask four questions before committing:

  • Does this choice spread provider-specific code across the product?
  • Does it move authority from code or a person into model judgment?
  • Does it make state implicit in a connection, conversation, or framework?
  • Does it change the evidence required to prove a run was acceptable?

One “yes” earns a decision record. Two “yes” answers earn a review with security and operations.

How should you choose between a workflow and an agent?

Choose the smallest control shape that can complete the job.

ShapeWho chooses the next step?Use whenPrimary evaluation
Fixed workflowCodeSteps and branches are knownStep correctness and final outcome
Routed workflowCode plus a bounded classifierInputs follow a small set of pathsRoute accuracy and per-path outcome
Single-agent loopModel inside explicit limitsThe path must adapt during the runTrajectory, tool use, stops, outcome
Multi-agent graphMultiple bounded executorsWork separates into independent specialtiesHandoffs, joins, conflicts, total outcome

The decision is architectural because the evaluation harness changes with the control shape. A fixed workflow can be tested step by step. An agent loop needs trajectory evidence: which tools it chose, what it observed, how often it retried, why it stopped, and whether it respected authority throughout the run.

Google’s Agent Development Kit evaluation guidance makes the same distinction between evaluating the final response and evaluating the trajectory. OpenAI’s Agents SDK tracing records model generations, tool calls, handoffs, guardrails, and custom events. The architectural conclusion is broader than either framework: if the system chooses a path, the path becomes part of the product.

The modern agentic systems architecture guide goes deeper on state machines, bounded loops, and trajectory gates.

Where should memory and state live?

Separate five things that teams often call “memory”:

State typeExampleLifetimeSource of truth?
Request contextCurrent instruction and inputsOne callNo
Working stateCurrent step, evidence, pending approvalOne runYes, for the run
Conversation historyPrior messagesOne sessionUsually no
Domain recordInvoice, ticket, contract, customer stateBusiness-definedYes
Learned memoryApproved preference or reusable patternUntil reviewed or expiredOnly within its declared scope

Long context is useful. It is still not a database, an event log, or an authorization record. Anthropic’s context-window guidance describes server-side compaction as a strategy for long-running conversations and agentic workflows. Compaction keeps a conversation operable; it does not create durable business truth.

For any run that can pause, retry, or cross a human approval, persist at least:

  • a stable run identifier;
  • the workflow and policy version;
  • current state and allowed transitions;
  • inputs with provenance and retention rules;
  • tool intents and idempotency keys;
  • approvals, rejections, and actor identity;
  • outputs, validation results, and committed effects;
  • the reason the run stopped.

That record lets a new process resume without asking a model to infer what happened from a transcript.

How should tools and side effects be governed?

Treat the model as an untrusted proposer at the action boundary. It may recommend a tool call. Deterministic code and policy decide whether that proposal is valid, authorized, and safe to execute.

A production tool contract needs more than a JSON schema:

Identity        Which principal is acting?
Purpose         Which workflow and step may call the tool?
Input schema    Which values are accepted and normalized?
Data boundary   Which records or fields may be read?
Effect boundary Which resources may be created, changed, or deleted?
Idempotency     What happens when the same intent arrives twice?
Timeout/retry   Which failures may be retried, and how often?
Approval        Which effects require a named human?
Receipt         What evidence proves the attempted and committed effect?
Compensation    How is a reversible effect repaired?

The 2026 OWASP Top 10 for Agentic Applications is a useful threat-model input because it treats goal hijacking, tool misuse, identity, memory, inter-agent communication, and cascading failures as system risks. The practical response is least privilege, typed tools, explicit authority, isolated untrusted content, and receipts for consequential actions.

MCP can standardize the interface to tools and context. It does not grant trust. The 28 July 2026 MCP specification makes the protocol stateless; the application must own any cross-request workflow state explicitly. That is a cleaner boundary, provided the application actually takes ownership.

What evidence should exist before release?

A release decision needs four evidence lanes.

LaneCore questionMinimum useful measures
OutcomeDid the recipient get an acceptable result?Acceptance rate, correction rate, unresolved cases
TrajectoryDid the system take an acceptable path?Route/tool accuracy, unnecessary steps, stop compliance
OperationsCan the service meet its operating envelope?End-to-end latency, error rate, retry rate, availability
EconomicsIs the verified result worth its total cost?Cost per accepted outcome, human review time, rework

Add a fifth lane for consequential workflows: authority and safety. Measure unauthorized tool attempts, blocked effects, approval bypasses, policy violations, and incidents. A zero count only means something when the events are instrumented.

OpenTelemetry’s Generative AI semantic conventions provide a shared vocabulary for traces, metrics, and attributes across implementations. Use that vocabulary where it fits, then add workflow-specific fields: outcome ID, policy version, evidence set, approval actor, committed effect, and evaluation result.

The smallest credible evaluation pack contains:

  1. representative normal cases;
  2. ambiguous inputs that should trigger clarification;
  3. adversarial or untrusted content;
  4. tool errors, timeouts, and partial results;
  5. repeated requests that test idempotency;
  6. cases that must stop or escalate;
  7. known regressions from prior releases.

Run the pack against the exact model, prompt, tool, retrieval, policy, and workflow versions you plan to release. A model benchmark cannot approve your workflow because it did not test your recipient, data, tools, or authority boundary.

For the instrumentation layer, use the multi-agent observability stack. For the economic denominator, use cost per verified outcome.

How should model routing work?

Route by task and evidence, not by brand loyalty.

Place one model boundary between product code and provider SDKs. Give that boundary responsibility for:

  • eligibility: privacy, region, modality, context, and tool constraints;
  • capability tier: the least expensive route that meets the quality gate;
  • structured-output validation;
  • timeouts, fallbacks, and degraded-mode disclosure;
  • caching and prompt/version identity;
  • cost and latency telemetry;
  • evaluation-based promotion or rollback.

Start with one primary route and one explicit failure path. A routing fabric with six unmeasured providers creates operational surface without evidence. Add a route only when a defined evaluation slice shows why it exists.

The model boundary should return more than content. Return the provider and model version, input/output contract version, usage, latency, finish state, and validation result. That record makes a later incident or comparison possible.

What should you build, buy, or rent?

Use ownership and differentiation as the filter.

LayerBuild whenBuy or rent whenKeep portable
ExperienceThe workflow interaction is the productA standard inbox or chat is enoughIntent and result contracts
OrchestrationControl flow is differentiated or regulatedA managed runtime meets durability needsState model and transition semantics
RetrievalDomain ranking or provenance is distinctiveStandard search meets the evaluation gateDocuments, metadata, citations, eval set
ModelsRarely; only with clear data/cost/control evidenceProvider capability clears the task gateGateway contract, prompts, test cases
ToolsThe integration encodes unique operationsA supported connector is sufficientTool schemas, scopes, receipts
ObservabilityWorkflow evidence is domain-specificCommodity telemetry is sufficientTrace IDs, event schema, raw export
PolicyAuthority is specific to your organizationA policy product enforces known controlsRules, identities, decisions, audit trail

The goal is not maximum portability. It is known swap cost. A provider-specific feature can be the correct choice when the uplift is measured and the dependency is recorded.

What are the core operating artifacts?

An AI architecture becomes operable when the team can inspect the following artifacts without asking the original builder to reconstruct them from memory.

  1. Outcome contract: recipient, trigger, accepted result, risk, evidence, owner.
  2. Authority map: read, propose, approve, execute, repair, and retire permissions.
  3. System map: the seven planes, data movement, trust boundaries, and external dependencies.
  4. Decision records: expensive choices and the evidence required to revisit them.
  5. State model: durable records, transitions, retention, and resume behavior.
  6. Tool registry: schemas, scopes, credentials, effects, retries, and receipts.
  7. Evaluation pack: cases, graders, thresholds, known limitations, and results.
  8. Evidence schema: trace and outcome fields that connect a run to a release.
  9. Runbook: pause, retry, escalate, repair, roll back, and communicate.
  10. Change ledger: model, prompt, policy, retrieval, tool, and workflow versions.

Together, these artifacts are the real architecture repository. Diagrams show the system. The contracts and evidence let the team operate it.

What should the first 30 days look like?

Days 1–5: bound one workflow

  • Interview the recipient and the current operator.
  • Write the outcome contract and baseline cases.
  • Mark every read, proposal, approval, and external effect.
  • Choose one accepted result and one explicit non-goal.

Exit evidence: the recipient can reject the contract because it is specific enough to disagree with.

Days 6–12: build the thinnest end-to-end path

  • Use a deterministic workflow where possible.
  • Put provider calls behind one boundary.
  • Validate structured outputs.
  • Keep tools read-only unless a write is necessary for the tested outcome.
  • Persist the run state and evidence identifiers.

Exit evidence: one representative case can be replayed from trigger to inspected result.

Days 13–20: attack the boundaries

  • Add ambiguous, adversarial, timeout, retry, and stop cases.
  • Test idempotency and approval behavior.
  • Review tool scopes with security or the system owner.
  • Record the cost and latency of accepted and rejected runs.

Exit evidence: failures stop in a defined state and preserve enough information for repair.

Days 21–30: run a bounded operating trial

  • Put a named person behind the review queue.
  • Compare results with the baseline.
  • Log corrections and update the evaluation pack.
  • Set release, pause, and rollback thresholds.
  • Write the first change ledger entry.

Exit evidence: the owner can explain what the system may do, how well it did, what it cost, and how to stop it.

Which skills matter most for an AI architect?

The role rewards translation across disciplines more than mastery of one framework.

SkillWhat good looks likePractice artifact
Outcome designConverts ambition into a testable operating resultOutcome contract
Distributed systemsDesigns retries, state, queues, idempotency, and recoveryFailure-state diagram
Context engineeringSeparates instructions, evidence, state, and untrusted contentContext contract
Model evaluationBuilds task-specific cases and explains uncertaintyEvaluation report
Security and identityApplies least privilege and names authorityThreat model and authority map
Data architectureDefines provenance, retention, quality, and accessData flow and record schema
Product judgmentChooses the smallest valuable workflowScope decision record
OperationsMakes incidents, rollback, and ownership explicitRunbook
EconomicsMeasures total cost against accepted outcomesCost-per-outcome ledger
CommunicationMakes trade-offs legible to technical and business ownersArchitecture review memo

Build a portfolio around receipts rather than screenshots. For each workflow, show the outcome contract, architecture, eval set, failure cases, authority boundary, and a short decision memo. That demonstrates the actual job.

What is the release checklist?

Before a workflow touches production work, answer these questions with evidence:

  • Is there one named recipient and one observable accepted result?
  • Does every external effect have explicit authority and an owner?
  • Are untrusted inputs isolated from system instructions and credentials?
  • Can the workflow stop, resume, retry, and avoid duplicate effects?
  • Is provider logic behind one model boundary?
  • Are structured outputs validated before downstream use?
  • Does the state store record workflow, policy, model, prompt, and tool versions?
  • Does the evaluation pack include normal, ambiguous, adversarial, failure, and stop cases?
  • Are quality, latency, cost, and correction measured per accepted outcome?
  • Can an operator inspect a run, pause the system, repair state, and roll back?
  • Are retention, privacy, identity, and access rules explicit?
  • Does a named owner accept the remaining limitations?

If an answer is “we think so,” the next task is to produce the missing receipt.

What changed in August 2026, and what did not?

The architecture above is stable. August moved several implementation assumptions around model routing, context management, agent runtimes, interoperability, and MCP state ownership. None of it moved a plane boundary.

Keep that distinction as a working habit. When a release lands, write down four things before you touch the system:

  • what changed;
  • which architecture plane it touches;
  • what consequence follows;
  • what to change now, and what to watch without redesigning anything.

Most releases produce a long “watch” column and an empty “change now” column. That is the correct result, and it is far easier to see once the columns exist.

FAQ

What is an AI architect?

An AI architect designs the system that connects AI capability to a business outcome. The role owns architecture boundaries, orchestration, context and state, model routing, tool contracts, evidence, policy, and operations. It works across product, engineering, data, security, and governance.

Does an AI architect need to be a software engineer?

The role needs enough software and distributed-systems depth to reason about state, APIs, identity, retries, failure, deployment, and evidence. Some AI architects write production code; others lead designs with engineering teams. The non-negotiable skill is making technical consequences explicit and testable.

What is the difference between an AI engineer and an AI architect?

An AI engineer usually owns implementation inside a defined system. An AI architect owns the cross-system decisions: outcome, authority, boundaries, control shape, state, portability, evidence, and operating model. On a small team, one person may perform both roles.

Should an AI architect start with an agent framework?

No. Start with the outcome and authority contracts, then choose the smallest control shape. A fixed or routed workflow is often easier to test and operate. Adopt an agent runtime when the path must adapt and your evaluation pack can judge the resulting trajectory.

Which cloud or model provider is best for AI architecture?

There is no universal winner. Evaluate the exact workflow against privacy, region, modality, context, tool use, quality, latency, cost, and operating constraints. Put provider calls behind one boundary so a measured advantage does not become accidental lock-in across the codebase.

How do you measure whether an AI architecture works?

Measure accepted outcomes, corrections, trajectory quality, latency, failures, safety events, human review time, and total cost per accepted outcome. Use representative workflow cases and record the exact model, prompt, retrieval, tool, policy, and workflow versions tested.

What should be in an AI architect portfolio?

Show operating evidence: an outcome contract, system map, authority model, decision records, tool contracts, evaluation set, failure cases, cost analysis, and runbook. A polished chat screenshot shows interface quality. The portfolio should also prove that the system can be inspected and governed.

Sources and method

This guide separates durable architecture guidance from dated product claims. The security, evaluation, observability, context, and protocol references point to primary documentation from OWASP, Google ADK, OpenAI, Anthropic, OpenTelemetry, and MCP, each checked on 30 August 2026. Vendor benchmarks are not used as proof of workflow quality.

Stay in the intelligence loop

Weekly field notes on AI systems, production patterns, and builder strategy.

Occasional FrankX field notes. Unsubscribe anytime. Privacy details.