Agentic Engineering: Build vs Buy Knowledge Layer Rubric

Disclosure: This article may contain affiliate links. We may earn a commission at no extra cost to you.

8 min read

You can ship agentic AI into production with predictable unit economics, audit-ready governance, and the ability to swap models/vendors without rewriting pipelines.

TL;DR

  • Adopt a Decoupled Planes architecture (Control/Data/Model/Experience) so models can change without moving data or reworking governance.
  • Implement Hybrid Retrieval (metadata gate → vectors → rerank → full logging) to improve precision while enforcing entitlements and auditability.
  • Treat features and embeddings as first-class products (versioned, SLA-backed, offline/online parity) to prevent silent regressions and expensive re-embedding surprises.
  • Make agent spending predictable: set hard budgets on each workflow, count every tool and model call against that budget, and trigger review when cost per 1k RAG queries jumps more than 20% in a week — fan-out turns small prompts into runaway bills if it’s unmetered.
  • Validate portability early with a vendor export test within 30 days so “switching” doesn’t become a rebuild + re-audit event.

Core Model: Decoupled Planes for Vendor and Model Churn

Treat architecture as your insurance policy against two certainties: vendor churn and model churn. If your app logic knows which LLM you use, where embeddings live, or how policies are enforced, you’ve already accepted a permanent migration tax. Few leaders are willing to say this out loud: most “AI platform” failures are self-inflicted coupling problems, not model quality problems.

The four planes (and what each owns)

  • Control Plane (governance): policy evaluation, identity/entitlements, lineage, audit logs, retention. Make it enforceable, not “Excel governance.”
  • Data Plane (data products): tables, documents, streams, feature stores, vector indexes as storage artifacts. Keep data where it belongs (residency, domain ownership).
  • Model Plane (model lifecycle): training, fine-tuning, inference endpoints, prompt/version management, evaluation harnesses. Swap models without rewriting retrieval or apps.
  • Experience Plane (consumption): APIs, apps, copilots, agents, workflow orchestration. Keep UX stable while models/providers rotate.

Decision rule: models must not care where data lives. If they do, you’ve collapsed planes and guaranteed rework during the next provider shift.

Abstraction layers that actually reduce reversal cost

  • Model Gateway: one interface for multiple providers (routing, fallback, eval gating). Prevent “SDK sprawl” in app code.
  • Retrieval Adapter: metadata gate → vector search → rerank → logging. Keep retrieval explainable and auditable.
  • Policy Enforcement Point (PEP): evaluate access on ≥99% of queries with logs (advisory default; calibrate to your audit requirements).
  • Portability Harness: export/rehydrate scripts for prompts, eval sets, embeddings, metadata, and ACL mappings.

Concrete checkpoint: run a vendor exit export test within 30 days of signing (advisory default; shorten for regulated data). If you can’t export embeddings + metadata + access controls, you don’t have an architecture—you have a hostage situation.

Takeaway: approve any AI platform design only if you can swap a model/provider by changing the Model Plane and gateway config, not the Data or Experience planes. AI doesn’t fail in production—it fails in planning.

Decoupled Planes architecture: Experience, Control, Data, and Model planes stacked as a single tower with a left-side request-flow arrow showing inter-plane transitions (policy check, authorized read, context). Vendor Abstraction sits beside Data and Model planes to enable swaps without touching governance.
Figure 1: Decoupled Planes isolates governance, data, and model churn so swapping vendors/models doesn’t force data moves or re-audits.

Patterns vs Anti-Patterns: What Scales, What Breaks

Pattern Anti-Pattern Why It Matters
Hybrid retrieval (tables + vectors + re-rank + logging). Gate with structured metadata (entitlements, region, doc type), then vector search, then re-rank. Log each step. Vector-only retrieval with no metadata gates and thin logs. Vector-only systems over-retrieve, leak restricted content, and fail audits because you can’t prove why a chunk was returned. Treat retrieval as a controlled workflow, not a search box. Require ≥99% of queries evaluated against access policy with logs (advisory floor; calibrate to your audit regime).
First-class embeddings. Version embeddings, track drift, and separate embedding lifecycle from app releases. Unversioned embeddings (“we’ll just re-embed later”). Re-embedding becomes an unplanned infrastructure event. Costs spike, relevance shifts, and nobody can explain behavior changes. Put embeddings on the same change-control path as models and features. Trigger cost review if cost per 1k RAG queries rises >20% WoW (advisory default; tune to seasonality).
First-class features. Define features centrally, own them by domain, enforce offline/online parity, and publish SLAs. “Features are just columns.” Column-level thinking creates silent definition drift across teams. Production incidents show up as “the model got worse” with no root cause. Version feature definitions and require parity checks before promotion.
Decoupled planes (control/data/model/experience). Keep governance enforceable even when models move. Excel governance + ad hoc integrations. Spreadsheets don’t enforce policy, don’t generate lineage, and don’t survive audits. This is where AI doesn’t fail in production—it fails in planning. Set a go-live gate: ≥95% dataset classification coverage (advisory default; raise for regulated domains).
Hybrid governance operating model (enterprise core + AI edge controls). Centralize standards; enforce context-aware controls in the AI platform. All-enterprise governance first or AI-only governance. One stalls delivery; the other creates unmanaged exposure. Name owners across security, data, and platform teams. If you can’t staff ≥1.5 dedicated ops/SRE FTE for the platform (advisory floor), don’t DIY the control plane.
Abstraction layers for portability. Swap models/vector stores without rewriting apps. Validate exit early. Hard-coupled stack (single vendor ties model + retrieval + governance). Lock-in becomes a permanent tax: re-validation, re-audits, and rebuilds. Run an export/rehydrate test within 30 days of signing (advisory default; shorten for high-risk data) to prove you can leave before you need to.

Hybrid retrieval flow shown as a sequence diagram with all four Decoupled Planes overlaid as colored bands: Experience (User, Agent), Control (Control Policy, Audit Log), Data (Metadata Store, Vector Search, Reranker), and Model (Inference). Steps include entitlement check, metadata gate, vector retrieval, re-ranking, inference with retrieved context, audit logging, and answer with citations.
Figure 2: Hybrid retrieval across the four Decoupled Planes — metadata gate first, then vectors, then rerank, then inference, with audit logging and citations on the way back.

Implementation Playbook: 7 Steps with Verification Gates

Preconditions (non-negotiable gates)

Four preconditions as a numbered vertical stack: define outcome plus baseline, map the data reality, choose a governance model, and treat governance as a prerequisite — each tile carries its verification criteria.
Figure 4: Preconditions — four gates, stacked. None optional. Each tile carries its own verification criteria.

Verification thresholds (≥95% classification, ≥99% policy logging) are advisory defaults — calibrate to your regulatory exposure and audit requirements.

Five build-vs-buy gates rendered as a three-column decision table — gate name, threshold rule, and color-coded decision chip — covering Risk Score, TCO, Ops Reality, Change Velocity, and Knowledge Graph.
Figure 5: One rubric, five rows — let the threshold pick the path so the build-vs-buy debate ends in five minutes, not five weeks.

All thresholds are advisory defaults — calibrate to your delivery maturity, finance model, on-call coverage, integration complexity, and query mix.

Seven rollout steps grouped under three color-banded phases — Foundation (steps 1–2), Build (steps 3–5), Operate (steps 6–7) — each step rendered as a wide row with a numbered badge, title, and verification criteria.
Figure 6: Seven steps across three phases. Foundation earns the right to Build; Build earns the right to Operate. Each step has its own verification gate.

Hybrid retrieval (step 4) flows metadata gate → vectors → re-rank → logging. Step 6’s >20% WoW cost alert and step 7’s 30-day export test are advisory defaults — tune to your seasonality and lock-in risk.

Rollback guidance (plan it before you need it)

  • Model rollback: Revert model plane via abstraction layer; keep data plane unchanged; re-run regression suite on top workflows.
  • Retrieval rollback: Revert re-ranker or vector index config; keep metadata gates and audit logs intact.
  • Vendor rollback: Execute the export/rehydrate runbook; prove you can restore embeddings, metadata, and ACL mappings—not just raw files.

Rollback decision flowchart: incident detected feeds into a diamond asking which layer is failing, branching into Model, Retrieval, and Vendor columns. Each column has REVERT, PRESERVE, and VERIFY boxes that converge into a single back-to-healthy production end node.
Figure 7: One trigger, three branches. Each rollback isolates impact to its own scope, preserves the others, and converges back on healthy production.

Metrics & Instrumentation: What to Measure Before You Scale

Treat these thresholds as go/no-go gates, not “nice-to-have observability.” AI doesn’t fail in production—it fails in planning, and instrumentation is where most teams try to save money and then pay it back with interest.

Three large stat cards in a horizontal row showing readiness gate targets — 95% classification coverage, 99% policy-logged queries, and below 15% change failure rate. Each card has a colored direction header and the threshold as a big number.
Figure 9: The three readiness gates that block go-live. Real telemetry, not slideware.

SLOs and leading indicators (instrument the failure modes)

  • Classification drift: alert when newly created/ingested datasets remain unclassified past your ingestion SLA (set per domain). Root cause is usually “spreadsheet governance” and unclear stewardship.
  • Policy logging gaps: alert on any drop below the 99% floor; treat as Sev-2 in regulated environments. Missing logs = failed audit, even if the system “works.”
  • Agentic fan-out: track tool/model calls per user query and $/1k queries. Alert on >20% week-over-week increase in cost per 1k RAG queries (advisory default; tune to seasonality and launch cycles).
  • Retrieval integrity: log metadata gates → vector hits → reranker output. Alert on entitlement mismatches (retrieved doc not permitted) at any non-zero rate; this is a control-plane defect, not a model defect.

Cost guardrails (make unit economics enforceable)

  • Set per-workflow budgets (tokens, tool calls, wall time). Fail closed or degrade gracefully (smaller context, fewer tools) when budgets are exceeded.
  • Forecast storage and embedding recompute; alert when monthly forecast variance exceeds 10% (advisory default; tune to procurement tolerance).

Governance readiness thresholds (operating model, not paperwork)

  • Assign named owners for: classification taxonomy, policy authoring, platform enforcement, and audit response. No owner = no control.
  • Run a weekly “evidence review”: sample queries, verify policy logs, verify retrieval traces, verify change records.

Decision criterion: if you cannot demonstrate ≥95% classification, ≥99% policy-logged queries, and <15% change failure rate with real telemetry (not slideware), delay go-live and narrow scope until you can.

Pitfalls & Edge Cases: Signals to Watch, Mitigations to Run

Five pitfall cards stacked vertically — Agentic Fan-Out, Pilot Purgatory, Shadow AI Sprawl, Custom RAG Commoditization, Lock-In Regret — each with a dark numbered header and three icon-led sections (warning, magnifier, shield) for Pitfall, Detection, and Mitigation.
Figure 8: Five pitfalls — what they look like, how to detect them, how to mitigate. Spot the symptom, run the mitigation.

Thresholds shown are advisory defaults — calibrate the >20% WoW cost alert to seasonality, the ≥95%/≥99% logging floors to your compliance regime, the >1.3× run-rate rule to your TCO model, and the 30-day export test to procurement constraints.

Asset: Build-vs-Buy Decision Matrix

Use this matrix to force a decision before you burn a quarter on “pilot purgatory.” Score what you can’t wish away: risk, steady-state economics, staffing reality, change velocity, and whether a Knowledge Graph (KG) is actually justified (multi-hop/entity reasoning vs keyword/semantic retrieval).

Printable scoring worksheet with five dimension rows (Risk Score, TCO, FTE, Change Velocity, KG Justification) and three colored band cells per row (Build green, Hybrid amber, Buy red), plus an empty score column on the right with a 0-8 tick scale. Footer shows total score box plus three decision band cards. Bottom panel shows three hard gates with empty checkboxes.
Figure 10: Score each row 0–8. Sum to a total in 0–40. If you fail any hard gate, the total doesn’t matter.

How to score (copy/paste rubric)

  • Score each dimension 0–8 (0 = favorable to build; 8 = favors buy/partner).
  • Total score = 0–40
  • 0–15: Build viable (you can own it end-to-end) (advisory default; calibrate to your risk tolerance)
  • 16–23: Hybrid (buy commodity, build differentiators) (advisory default)
  • ≥24: Buy/partner favored (advisory default)
  • Hard gates (don’t negotiate):
  • Dataset classification coverage ≥95% before go-live (operational floor we use; calibrate to regulatory exposure)
  • Policy enforcement logging on ≥99% of queries (operational floor we use; calibrate to audit requirements)

Decision matrix (0–8 per row)

Dimension 0–2 (Build-leaning) 3–5 (Hybrid) 6–8 (Buy-leaning)
Risk score (security/compliance/lock-in) Low regulatory scope; clear data residency; exit plan tested Mixed sensitivity; partial residency constraints Regulated + multi-region + vendor lock-in risk; “Excel governance” present
TCO (steady-state run-rate) DIY run-rate ≤ managed option DIY near parity DIY run-rate >1.3× managed option (advisory default; model your unit economics)
FTE (platform ops/SRE) ≥1.5 dedicated FTE sustained 1.0–1.5 FTE with strong automation <1.5 FTE sustained = DIY red flag (advisory default; depends on uptime/audit needs)
Change velocity (sources + policies) ≤10 sources/month; ≤2 policy changes/month Above thresholds with automation backlog funded >10 sources/month or >2 policy changes/month without automation → stalls (advisory default)
KG justification (multi-hop need) <20% of priority queries need multi-hop/entity reasoning Borderline; prototype with graph-lite ≥20% multi-hop/entity reasoning → KG justified (advisory default; validate with query sampling)

Governance readiness add-on (pass/fail)

  • Enforce a decoupled control plane (policy/lineage/audit) before scaling agents.
  • Validate vendor exit: run an export + sample rehydrate test within 30 days of signing (operational floor we use; calibrate to contract risk).

Takeaway: If you score ≥24 or fail the governance gates, stop “building a platform.” Buy/partner for the commodity layers, and build only what creates domain advantage under enforceable controls.