BXUP Track progress & test yourself — free
Cloud & Solutions Architecture · Playbook · Core · ~4 min read
CLOUD & SOLUTIONS ARCHITECTURE · PLAYBOOK · CORE

Reference-Architecture Retrieval & Adaptation

All three hyperscalers now publish AI reference architectures faster than any architect can memorize them. This playbook loads the vendor architecture-center corpus into a retrieval tool, shortlists the references that actually fit your constraints, and adapts one — with every inherited design decision cited back to its source page.

Tier: Core · Hands-on time: ~25 minutes

Retrieval beats memory at 2026 publication pace. AWS shipped Well-Architected lenses for generative and agentic AI, Azure publishes baseline chat and landing-zone reference architectures, and Google maintains a family of RAG reference architectures spanning managed to fully custom. An architect who "remembers" the right pattern is recalling last year's guidance; one who retrieves it cites this quarter's. The skill this playbook trains is adaptation with provenance: knowing which parts of a reference are load-bearing guidance, which are vendor defaults, and which simply do not survive contact with your constraints.

When to use

  • Starting a design in a workload class the hyperscalers have canonical guidance for (RAG, agentic systems, landing zones, chat baselines).
  • An ARB or client asks "is this aligned with vendor best practice?" and you want a citable answer, not a vibe.
  • You suspect your draft design reinvents something a reference architecture already settles.

Skip AI when you already know the exact reference document — read the primary source directly; retrieval adds a lossy middleman to a known destination.

Prerequisites

  • A document-grounded Q&A toolNotebookLM-class, or a Claude Project loaded with sources. The defining feature: answers grounded in uploaded documents with citations, not open-web recall.
  • The corpus, deliberately chosenthe relevant architecture-center pages, lens PDFs, and baseline architecture docs for your candidate clouds, downloaded fresh. Curate for the workload class; twenty relevant documents beat two hundred generic ones.
  • Your constraint setpb-01/pb-03 outputs: residency, compliance, scale, existing platform commitments.
  • A design doc or ADR skeleton to receive the adaptation (pb-14 pairs naturally).

The workflow

  1. Build the notebook for this decision, not forever. Load the corpus and title it for the engagement question — "Meridian: agent architecture references, 2026-Q3". Freshness is the point: note the retrieval date on each source. Vendor guidance revises quietly, and a notebook built last spring answers with last spring's canon.

  2. Retrieve against constraints, not keywords.

    From the loaded documents only: I am designing a customer-support
    copilot with an order-status agent for a US retailer. Constraints:
    client is committed to one hyperscaler; agent must call an on-prem
    order API through private connectivity; retrieval corpus contains
    PII under state privacy laws; client ops team is small (managed
    services preferred).
    
    1. List every reference architecture in the corpus relevant to this
       shape. For each: source document + section, what it covers, and
       which of my constraints it addresses or violates.
    2. Recommend the 2 best-fit references and say specifically why the
       others fit worse.
    3. Answer only from the documents. If the corpus does not cover
       something, say NOT IN CORPUS — do not fill gaps from general
       knowledge.
    
  3. Read the shortlisted primary sources. Not negotiable, and not long — you are reading two documents, not twenty, which is exactly the leverage retrieval bought you. The tool found the right pages; only reading tells you the caveats, the "this baseline is not production-ready without X" warnings, and the architecture's actual reasoning.

  4. Adapt with a delta table. Ask the tool to structure the adaptation: "For reference architecture [chosen], produce a table: component in the reference, its role, keep/replace/drop for my constraints, and justification. Flag every row where my constraint forces a departure from the reference." The delta table is the artifact: it shows reviewers you started from canon and departed deliberately, with reasons — the strongest position an architect can take into an ARB.

  5. Separate guidance from defaults. Walk the keep rows and ask of each: is this a considered recommendation (the reference argues for it) or a demonstration default (it merely appears in the sample)? References embed illustrative choices — instance families, example regions, convenience services — that carry no authority. Inheriting a default as if it were guidance is this playbook's characteristic failure.

  6. Cite forward into the design. Every element your design inherits gets a citation to the reference (document, section, retrieval date) in the HLD or ADR; every departure gets its delta-table justification. Six months later, when the vendor revises the reference, the citations tell you exactly which parts of your design to re-examine.

Verify before you trust it

  • Citations resolve to real sections. Open three cited passages in the actual documents. Retrieval tools occasionally attribute a claim to the wrong source in the corpus — a misattributed citation in an ARB pack costs you the room's trust.
  • NOT IN CORPUS answers are honest. Probe with a question you know the corpus cannot answer. A tool that improvises from general knowledge instead of refusing has disqualified its other answers from being document-grounded.
  • Service claims still get pb-05 treatment. The reference architecture proves the pattern is sanctioned, not that a service limit or regional capability holds for your scale today. Quantitative claims inherited from references enter the claims register like any others — vendor docs age, and PDFs age fastest.
  • Check the reference's own date and status. Architecture centers deprecate quietly; confirm on the live vendor page that your chosen reference is current, and note deprecation-relevant signals (superseded-by links, "legacy" banners) before you build on it.

Restricted-environment variant

The corpus is public vendor documentation — the sensitive side is your constraint set and design context in the prompts. Under a restrictive pb-03 ruling, redact the queries (workload shape without client identity: "US retailer" not the client name), or run retrieval inside the approved boundary: a Claude Project on enterprise tenancy, a client-subscription endpoint, or local RAG (Ollama + the downloaded PDFs) for fully closed environments. The reading and delta-table steps are AI-optional; the primary sources are free to read anywhere.

Pro Tip

The delta table — "started from the vendor reference, departed here, because of this constraint" — is the most persuasive design document in the ARB room. Retrieval buys you the reference; your departures are where the architecture actually lives.

This is the free reading view. Open BXUP to track your progress, run the hands-on labs, and prove it with original, exam-pattern assessments.
© Anvi Innovate · BXUP — Be Exponentially Upskilled · BXUP is an independent learning platform, not affiliated with or endorsed by AWS, Microsoft, Google, NVIDIA, IBM, Salesforce, Databricks, Oracle or Anthropic. All trademarks belong to their respective owners. · bxup.in