Skip to main content

Architecture and cloud

Outcome

Primary outcome: You can design an enterprise-grade AI solution that survives security review, integration reality, and production operations—not only a pilot container diagram.

Secondary outcomes:

  • Produce Stage 3 core deliverables: capability map, target-state views, HLD with ADRs, API/test/CI strategy, landing-zone fit, integration map with failure modes.
  • Separate platform engineering from product engineering decisions—who owns the runway vs who owns the aircraft.
  • Explain non-functionals (latency, availability, residency, DR, cost) in language executives and enterprise architects accept.

Stage 3 does not require full production cutover. It requires you to know what would fail in architecture review before build accelerates.

Who Stage 3 is for

ProfileTypical gapStage 3 fix
Strong Stage 2, weak EAGood eval plan; no target-state or ADRsTopic 08
Developer, weak cloudWorks locally; no landing zone or IAM modelTopic 16
Architect, weak integrationHappy-path API calls; no idempotency or SoRTopic 24
ML engineer, weak deliveryModel metrics strong; no CI for prompts/RAGTopic 15
Consultant jumping to Stage 4Security checklist before HLD existsComplete 08, 15, 16, 24 first

Entry criteria

Start Stage 3 when all of the following are true:

  • Stage 2 exit criteria met—or documented sponsor risk acceptance on data/eval gaps (logged, rare).
  • Prioritised use case has readiness score ≥3.0 on critical sources—or explicit remediation plan with dates before customer-facing scope.
  • Evaluation plan with thresholds exists (topic 21)—architecture must not substitute for eval gates.
  • You can name systems of record for data the AI reads or writes.

Do not start Stage 3 when:

  • Discovery produced only a chatbot wireframe with no integration inventory.
  • Cloud account is a single shared sandbox with no identity separation.
  • "We'll integrate later" is the plan for ERP write-back on financial actions.

Minimum entry artefact: Stage 2 pack (data inventory, model matrix, eval plan) plus one-page integration candidate list.

Exit criteria

Declare Stage 3 complete only when all exit checks pass:

Artefacts (minimum set)

ArtefactSource topicPass test
Capability map + target-state views08Business/application/data/integration/security/technology aligned; gaps named
ADR set (≥5 decisions)08Identity, residency, logging, model hosting, integration pattern documented
HLD with non-functionals08Latency, availability, RTO/RPO, tenancy, cost envelope explicit
API design + test strategy15Versioning, auth, prompt/RAG regression in CI
CI/CD pipeline outline15Environments, secrets, rollback, eval gate on merge
Landing-zone fit note16Account/subscription model, network, IAM, GPU capacity
Env topology + DR sketch16Prod/non-prod isolation; regional residency
Integration map + contracts24SoR, sync/async, idempotency, DLQ/replay per write path
Failure-mode notes24Timeout duplicate, partial failure, legacy throttle documented

Knowledge checks

  • Answer ≥10/12 randomly chosen questions from topics 08, 15, 16, and 24 without notes.
  • Explain one negative case (platform-as-product confusion, integration without idempotency, EA theatre) with client-relevant example.
  • Draw C4 context + container for practice use case in 20 minutes with ADR references.

Behavioural checks

  • You have blocked at least one design choice on non-functional or integration grounds—not only model preference.
  • Peer reviewer confirms artefacts are filed in pattern library with sector tag.

Exit is not "I drew a diagram in Lucidchart." Exit is review-ready architecture pack.

Capability map

Stage 3 spans four numbered topics (08, 15, 16, 24). Topic 08 sets enterprise framing; 15–16 deliver build and host; 24 connects to systems of record.

Topic 08 — Enterprise Architecture

Capability: Place AI in TOGAF-aligned views—business, application, data, integration, security, technology—via capability maps, target-state transitions, non-functionals, and ADRs; distinguish platform vs product ownership.

You know it when: You defend target-state container diagram in EA review with traceability to capabilities and NFRs—not vendor logo placement.

Core deliverables: Capability map, target-state views, ADR set, HLD with non-functionals.

Deep link: Enterprise Architecture

Topic 15 — Software Engineering

Capability: Ship reliable AI services—REST/GraphQL APIs, auth, clean architecture, CI/CD, containers, and AI-specific testing (prompt regression, RAG golden sets, load, security).

You know it when: Prompt change triggers CI eval failure before merge—and rollback path is documented.

Core deliverables: API design sketch, test strategy, CI pipeline outline.

Deep link: Software Engineering

Topic 16 — Cloud and Platform Engineering

Capability: Deploy on hyperscaler landing zones with identity, networking, environment separation, GPU capacity planning, IaC, observability, DR, and multi-cloud tradeoffs without resume-driven architecture.

You know it when: You explain why EU banking workload uses private endpoints, CMK, and fixed region—and what breaks if someone enables public egress.

Core deliverables: Landing-zone fit note, env topology, DR sketch.

Deep link: Cloud and Platform Engineering

Topic 24 — Integration and Enterprise Systems

Capability: Integrate AI with ERP, CRM, core banking, ITSM, IdP, DMS via versioned APIs and events; choose sync vs async; implement idempotency, retries, DLQ, and legacy coexistence.

You know it when: Timeout on ticket creation does not produce duplicate ServiceNow incidents—and replay runbook exists.

Core deliverables: Integration map, API contract list, failure-mode notes.

Deep link: Integration and Enterprise Systems

Topics in this stage (quick index)

  1. Enterprise Architecture
  2. Software Engineering
  3. Cloud and Platform Engineering
  4. Integration and Enterprise Systems

Sequence A — Standard (4 weeks, ~8–10 hours/week)

WeekFocusOutputs due
1Topic 08 + Architecture Guide skimCapability map + target-state C4 + 5 ADRs
2Topic 15API sketch + test strategy + CI outline with eval gate
3Topic 16Landing-zone fit + network/IAM diagram + DR sketch
4Topic 24Integration map + idempotency design + failure modes

Sequence B — Live engagement crash (2 weeks)

Use when staffed mid-build with weak architecture artefacts:

  1. Days 1–2: Topic 08 HLD and NFR workshop—block build until ADRs exist.
  2. Days 3–4: Topic 24 integration map and SoR matrix—before any write API.
  3. Week 2: Topics 15 + 16 CI path and landing-zone controls.
  4. Parallel: Stage 4 security/privacy review after Stage 3 pack draft—not in parallel without HLD.

Rule: No production traffic until integration failure modes and platform controls are written—not verbal.

Sequence C — Integration-heavy vs platform-heavy paths

Integration-heavy (servicing, ERP write-back): Week 1 topic 24 + 08 integration view; week 2 topic 15 API/idempotency; week 3 topic 16 network to on-prem ERP.

Platform-heavy (internal copilot, read-only RAG): Week 1 topics 08 + 16; week 2 topic 15 CI/eval; week 3 topic 24 read integrations only.

Integration with Guide and 8D

Stage 3 capabilityGuide / reference
Solution architecture patternsArchitecture Guide
Delivery and releaseDelivery Guide
Data and retrieval boundariesData & Knowledge
Methodology spine8D FrameworkDesign, Develop, Deploy
Trust gatesStage 4 topics 17–19 after architecture pack

Deep-link rule: Learning Map teaches judgement; Guide walks delivery steps. Link and produce artefacts—do not duplicate full Guide chapters in notes.

Common failure modes

Failure modeHow it shows upFix
Stage 3 before Stage 2VPC and GPU quotes before data inventoryBlock architecture review until readiness + eval exist
EA theatrePretty diagrams; no ADRs or NFRsTopic 08 ADR template; attach numbers to latency/availability
Platform vs product blurApp team owns landing zone hacksTopic 08 RACI; platform provides runway, product owns services
Demo CI onlyUnit tests; no prompt/RAG regressionTopic 15 golden-set gate on merge
Shared prod secrets in devSame API key across envsTopic 16 env separation + secret rotation
Public egress by defaultLLM calls from open subnetTopic 16 private endpoints + egress allow-list
Happy-path integrationDuplicate tickets on timeoutTopic 24 idempotency keys + DLQ
Sync call to ERP30s LLM + 45s ERP = UX deathTopic 24 async + correlation ID
GPU capacity surpriseFine-tune queue blocks inferenceTopic 16 capacity plan; separate pools
Multi-cloud resumeThree clouds, triple ops taxTopic 16 explicit tradeoff ADR
Integration without SoRAI updates CRM; ERP still truthTopic 24 system-of-record matrix
NFR hand-waving"Highly available" with no RTOTopic 08 NFR table with measurable targets

Stage 3 anti-pattern: the integration duplicate

A servicing assistant creates ServiceNow incidents when users report billing errors. Pilot handles 400 requests/day. Under load, ERP timeout rate hits 12%; retry logic creates duplicate tickets1,840 duplicates in six weeks; operations spend £95K cleaning data; trust in AI programme collapses.

Stage 3 antidote: Idempotency keys, async pattern with status polling, DLQ + replay runbook (topic 24)—designed before write integration goes live.

Stage 3 anti-pattern: landing zone bypass

Team deploys RAG stack in personal cloud subscription to "move fast." Production review finds no CMK, no private link, shared admin account, US region for EU data. Full redeploy to enterprise landing zone: 14 weeks, £220K rework.

Stage 3 antidote: Landing-zone fit note and env topology (topic 16) week one—even for pilot, in approved non-prod subscription.

Stage 3 anti-pattern: prompt ship without CI

Engineers edit system prompt in production Friday afternoon. Monday: citation format breaks for regulatory quotes; 23% regression on golden set; no rollback package. Manual revert takes 9 hours; compliance logs incident.

Stage 3 antidote: Topic 15 CI with prompt version pin and eval threshold block on merge.

Manager review rubric (Stage 3 gate)

DimensionRedAmberGreen
EA viewsSingle diagramTwo viewsCapability map + target state + ADRs
Non-functionalsAdjectives onlyPartial numbersLatency, availability, RTO/RPO, residency
Software deliveryNo test strategyUnit tests onlyAPI contract + AI regression in CI
Cloud/platformSandbox accountLanding zone namedIAM, network, DR, GPU plan documented
IntegrationRead-only assumedWrite without idempotencySoR matrix + sync/async + failure modes
Platform vs productUnclear ownershipRACI draftSigned platform/product split

Green on ≥5/6 dimensions → recommend Stage 4 trust-and-control review for that workstream.

Competency proof

When claiming Stage 3 complete:

  1. Submit architecture pack (artefact table above) to peer, EA, or manager.
  2. 45-minute challenge session: NFR trade-offs, integration failure walk-through, cloud control checklist.
  3. Optional: Competency test prompts for Stage 3.
  4. File anonymised artefacts in team pattern library.

What comes next

Stage 4 asks: How do we secure, govern, and comply? Do not advance until Stage 3 exit criteria are met—or document explicit risk acceptance on integration write paths and platform gaps (logged with sponsor).

Stage 3 completion checklist

  • Stage 2 exit criteria met or risk acceptance logged
  • Capability map and target-state views reviewed with EA or equivalent
  • ≥5 ADRs cover identity, residency, logging, hosting, integration
  • Non-functionals have numbers—not only "secure and scalable"
  • CI includes prompt/RAG regression before merge
  • Landing zone, IAM, and network paths documented for pilot
  • Integration map marks SoR, auth, sync/async, idempotency per system
  • Failure modes and DLQ/replay documented for write paths
  • Platform vs product ownership explicit
  • Artefacts filed in pattern library; peer review completed

Discussion

Comments

Share feedback or questions about this page. No account required.

Loading comments…