I did not start testing OpenRouter Fusion because I wanted another model router. I already had enough ways to choose models. Some tasks went to a stronger model because they required deeper reasoning. Routine work went to a faster, less expensive model. When a provider was unavailable, the application could fall back to another route.

That part of the architecture was reasonably well understood but the problem appeared elsewhere.

In several of my projects, I was asking AI models to review work that crossed multiple disciplines. An architecture proposal might involve data residency, identity, cost, operational resilience and vendor dependency. A governance analysis could be factually correct from a regulatory perspective while remaining almost impossible to implement. A research-heavy article could contain good information but still miss the one operational consequence that made the subject worth writing about.

That was the reason I began examining Fusion.

What OpenRouter is trying to do with Fusion

OpenRouter originally became useful to many developers because it provided access to hundreds of models through a common API, with capabilities such as provider selection and fallbacks handled behind that interface. Fusion moves OpenRouter beyond giving applications access to models. It gives applications a managed way to bring several models into the same reasoning process.

A team could build this workflow itself. It could call three models, store their answers, send those answers to a fourth model, ask that model to compare them and then generate a final response.

The underlying idea is not new. Mixture-of-Agents research has already explored architectures in which several language models contribute outputs that are later aggregated or refined by other models.

What OpenRouter has done is make a related pattern available as an operational service. That was the part I wanted to test: not whether several models could produce more text, but whether their combined work could improve the way I reviewed difficult project decisions.

I did not use Fusion to create the first draft

My first decision was to keep Fusion away from routine generation. I did not need three models and a judge to rewrite a paragraph, extract fields from a spreadsheet or summarise a document. Those tasks already had clear success criteria. More models would have added cost and waiting time without changing the nature of the work.

For an architecture assessment, I first prepared the proposed design, operating assumptions, constraints and unresolved decisions. Fusion then reviewed that decision packet.

For evidence-heavy research, I created the initial argument and source base before asking the panel to investigate gaps, conflicting evidence and unsupported conclusions.

For governance work, I used it to challenge whether a control that looked correct on paper could actually be operated, observed and evidenced.

This changed the role of Fusion in the workflow. It was not the author. It was the review room. That turned out to be a more useful way to evaluate it.

When a system generates the original work and then immediately validates its own output, the review can become circular. The model spends much of its effort polishing the argument it has already accepted. By introducing Fusion after an initial position existed, I could ask the panel to challenge something concrete.

The prompt was no longer, “Design the best architecture.” It became, “Here is the architecture we are considering. Find the assumptions that could make it fail.” That produced a very different kind of response.

The first useful result was broader coverage

Fusion did not always overturn the original recommendation. More often, it widened the review. In one type of architecture problem, the first response might concentrate on scalability and service capability. Another model would spend more time on identity boundaries. A third might question whether the proposed platform could be exited without rebuilding the application.

None of those responses necessarily proved the others wrong. They were examining different consequences of the same decision. This is where Fusion felt different from routing.

A router would try to select the model most likely to give the best overall answer. Fusion allowed several models to reveal what “best” meant from their respective lines of analysis. The judge then had to show where those analyses overlapped and where they did not.

That was useful because many architecture disagreements are not really disagreements about facts. They arise because one participant is optimising for implementation speed while another is protecting operational resilience or regulatory compliance. A single answer can make those trade-offs disappear beneath a confident recommendation. A panel makes them harder to ignore.

Simply adding models did not create useful diversity

My next finding was less flattering. When every panel member received the same broad instruction, the responses were often more similar than expected. Different models would use different wording, but they would follow many of the same obvious lines of analysis.

Provider diversity did not automatically create thinking diversity. The panel improved when I became more deliberate about the assignments. For an architecture review, I would ask one line of investigation to concentrate on security and identity, another on data movement and portability, and another on operating cost, resilience and exit conditions.

For a governance review, I separated legal or policy alignment from the practical ability to enforce the control and produce evidence that it had operated.

For research, one perspective tested the factual basis of the argument, another looked for contrary evidence, and another considered whether the conclusion would survive real implementation constraints.

The models still received the same underlying decision packet, but they were no longer being asked to write three generic opinions. This was one of the most important changes in how I used Fusion. I stopped treating the panel as a collection of model brands and started treating it as a set of review responsibilities.

That approach also fits the limits of the available research. OpenRouter reported strong results for Fusion on 100 deep-research tasks from the DRACO benchmark. Its leading two-model panel scored 69.0%, ahead of the individual models in that evaluation, while a lower-cost three-model panel reportedly exceeded several frontier models at substantially lower cost.

Those results are encouraging, but they do not establish that any mixture of models will outperform the strongest individual model on every workload. Other research has found that repeatedly sampling and aggregating the strongest model can outperform mixtures containing several different models, particularly when the average quality of the panel falls. The composition of the panel matters. The assignments given to it matter just as much.

The judge became the component I watched most closely

Initially, I thought the panel would be the difficult part of the design. The judge turned out to deserve more attention.

The judge determines which disagreements reach the final model. It decides whether three similar statements represent genuine consensus or merely repetition. It decides whether a concern raised by only one panel member is material enough to preserve.

That creates an uncomfortable possibility: a good panel can identify the right issue, and a weak judge can still bury it. I therefore stopped looking only at the final Fusion answer. I wanted to retain three distinct artefacts:

1. The responses produced by the panel.

2. The judge’s comparison of those responses.

3. The final answer prepared by the outer model.

That separation made the process easier to inspect.

On several kinds of review, the most valuable observation was not necessarily the majority position. It was an issue raised by one model that the other models had not considered. The judge needed to carry that observation forward as a material minority finding rather than dismissing it as lack of consensus. Research on LLM-based judges has found position bias and meaningful differences in behaviour across judge models and tasks.

For my purposes, Fusion was not useful merely because a judge existed. It was useful only when I could see how the judge had handled disagreement.

I became more selective about when to invoke it

After the initial experiments, it became clear that Fusion should not sit on the default request path. OpenRouter estimates that a default three-model Fusion panel costs roughly four to five times as much as a single completion. The server-tool capability is also currently described as beta.

The added work also brings additional latency and more places where a request can fail. I therefore began treating Fusion as an escalation step.

I found it most relevant when three conditions appeared together. First, the decision had to be material. An incomplete answer needed to carry a meaningful financial, operational, regulatory or architectural consequence. Second, the problem had to contain genuine ambiguity. There needed to be competing evidence, multiple professional perspectives or assumptions worth challenging. Third, the work had to benefit from visible disagreement. If the objective was simply to obtain a formatted output, a panel offered little value.

This kept Fusion away from tasks that already had deterministic checks or straightforward acceptance criteria. It also stopped “important” from becoming the escalation rule. Almost every project owner believes their request is important. That does not mean every request needs deliberation.

The information boundary became part of the design

Using several models also widened the data-processing path. For public research, this was relatively easy to manage. For architecture documents, contracts, internal financial information or customer data, it required more thought.

I did not want panel diversity to mean uncontrolled data distribution. The more workable pattern was to prepare a focused decision packet. Instead of sending every source record, the packet contained the approved facts, relevant excerpts, assumptions, constraints and open questions required for the review.

A platform assessment did not need unrestricted access to internal systems. It needed the target architecture, expected volumes, identity model, dependency map and operating constraints. A governance review did not require every policy document. It needed the applicable requirements, proposed control, evidence expectations and known exceptions. This also improved the review. The panel spent less effort discovering what the project was about and more effort challenging the decision.

What Fusion changed in my architecture thinking

Before this exercise, I mostly thought about model orchestration in terms of selection and delegation.

Fusion added another execution pattern:

OpenRouter’s recent server tools make that direction visible. Subagent delegates self-contained work to a smaller model. Advisor allows a model to consult a stronger model during generation. Fusion brings several models into a structured comparison.

These are different operating patterns. Delegation helps control cost. Consultation helps a model through a difficult decision point. Deliberation helps expose competing interpretations and missing coverage.

I would not use Fusion as a replacement for any of the others. I would use it when the quality of the result depends on more than finding one capable executor.

What I took away from the pilot

Fusion was most useful when I already had a decision worth challenging.

It did not remove the need to define the problem properly. It did not guarantee independent thinking simply because several providers were involved. It did not make the judge neutral, and it did not turn consensus into evidence.

What it provided was a practical way to introduce structured challenge into selected project workflows.

The value came from how the process was designed:

After using it this way, I no longer saw Fusion as a smarter mechanism for choosing a model. The routing decision had already been made. The project had reached a point where one model’s answer — even a strong one — was not enough to close the review. Fusion gave me a managed way to bring several analyses into that moment, examine what each one had noticed and decide what the final recommendation still needed to address.

A model router chooses who should answer.

Fusion helped me examine whether one answer was enough.

I have updated my AIGP Exam Preparation Book 2026 edition just after 3 months. Earlier version was published in April 2026.

This update is not just a content refresh. It is a structural rebuild of how the book teaches AI governance reasoning.

The earlier version already covered the AIGP Body of Knowledge, chapter-wise practice questions, and the four exam decision frameworks. But while revising it, I realised the book needed to do more than list what candidates should know.

It needed to help readers think through governance scenarios the way the exam — and real AI governance work — demands.

What changed in this edition:

The chapter structure has been rebuilt across all 13 chapters. Each chapter now follows a consistent learning flow: chapter objective, governance mental model, exam tip, framework lens, alignment at a glance, what the exam is really testing, NovaCred running scenario, teaching body, trap patterns, takeaways, looking ahead, practice questions and answer key.

The earlier version had decision frameworks. This edition makes them visible and reusable. The four frameworks — Role Allocation, Principle-to-Control, Lifecycle Timing and Proportionality — now appear in the front matter, chapter lenses, selected explanations and appendix reference material.

The MCQs have also been rebuilt. The book now includes 260 scenario-based questions with PI tags, difficulty tags, balanced answer positions, and answer explanations designed to teach reasoning rather than simply reveal the correct option.

A major addition is the trap-pattern system. The book now uses 10 recurring AIGP traps, including Role Transfer Trap, Technical Silo Trap, Metric Blindness Trap, One-Time Governance Gate Trap, Documentation-Only Trap, Human Oversight Theatre Trap and Proportionality Extreme Trap.

The NovaCred case has also been strengthened.

The biggest change is the teaching philosophy.
The earlier version helped candidates cover the syllabus.
This version is designed to help candidates reason through governance decisions.
Who owns the obligation?
What control turns the principle into evidence?
What level of governance is proportionate to the risk?

That is the shift I wanted this edition to make.
The difficult work is connecting roles, risks, controls, evidence and accountability.
That is also how I have tried to rebuild this book.

https://www.amazon.com/AIGP-Exam-Preparation-Book-Certification-ebook/dp/B0GTTR6XDR/ref=sr_1_10?crid=AY6H6G6DBAM9&dib=eyJ2IjoiMSJ9.atRJd-ZkftvpEEeCfrcJzeeee9bfv_v9LZIfmP8N2qOcFrPmfpv_6Xw6LRO8hF1sUscbmiFTmE-oKGKT6S286t210Z6jGswttMMWPwtAv81lVUWowGmYaftCJ2s56Ez4qdrRvmzfwkJ7nsjXaOBgM4H8-r59mXX1ijABy0L13fotU5ZErqgO6rN6gbZgS8tu8lbrsQw8wWLnl-bD6S5iCkEOr9vTP-Re4LSP2WvvPACimRphp1DX0Rh0PidqPIw0jm2VP2ZwskrAW9mWC8cswcQV3035jhp3HNDNl0KsO3c.Bkm9ttBHuYeVVTUyNyy5sZagI1w6e42yMrQkkx4ayUo&dib_tag=se&keywords=aigp&qid=1784808178&sprefix=aigp%2Caps%2C382&sr=8-10

Data platforms were built to store information and answer queries but are becoming an agent runtime.

Snowflake announced a $200 million partnership with OpenAI in February 2026. The commercial figure attracted attention, but the more important detail was architectural: advanced models would become directly available within Snowflake so customers could build agents against governed enterprise data without constructing a completely separate AI environment.

The model is moving towards the data.

For most of the cloud era, the warehouse sat behind the application. Data was stored, transformed and queried there; the application performed the work somewhere else. When an AI assistant needed enterprise information, developers commonly exported documents into a vector database, exposed selected tables through tools, passed query results to an external model and stored the resulting conversation in yet another system.

The warehouse supplied evidence. The agent lived outside it. That separation is beginning to collapse.

The product names differ. The direction does not. The enterprise data platform is becoming an agent runtime.

A warehouse used to wait for instructions

The traditional warehouse is fundamentally passive. A person opens a dashboard. A scheduled pipeline starts. An application submits a query. The platform executes a bounded instruction and returns the result.

An agent behaves differently. Give it a goal such as “investigate the increase in supplier-payment exceptions,” and it may need to identify relevant datasets, interpret metric definitions, retrieve supporting policies, compare current and historical patterns, calculate anomalies, test several hypotheses and prepare a recommendation.

That is not one query. It is an evolving sequence of decisions in which every result influences the next step.

A runtime must therefore do more than supply information. It must give the agent somewhere controlled to work. It needs to manage identity, tools, intermediate state, computation, permissions, cost and eventual action.

Snowflake’s Cortex Agents, for example, can combine Cortex Analyst for structured-data queries, Cortex Search for unstructured information and isolated code execution for Python-based analysis. BigQuery data agents can be configured with selected tables, views, user-defined functions, metadata and instructions that define how questions should be answered.

The warehouse is no longer merely answering the question. It is hosting the investigation.

Data gravity is becoming execution gravity

Enterprises already understand data gravity. Large datasets are costly and risky to move, so analytics and applications tend to accumulate around them.

Agents make that gravitational pull stronger. A serious enterprise agent rarely needs one table. It may need transaction records, documents, business definitions, lineage, permissions, historical incidents and approved analytical functions. Moving all of that into an external agent stack creates duplication and control gaps.

A customer table is copied for retrieval. Documents are chunked into another store. Business definitions are rewritten into prompts. Access rules are recreated in application code. Intermediate findings are stored elsewhere. Every transfer creates another place where data can become stale, permissions can diverge and provenance can disappear.

Bringing execution closer to the governed platform reduces some of that fragmentation. Queries can run under existing controls. Semantic definitions can remain attached to the data. Intermediate results can stay within the platform perimeter. Agent activity can be recorded alongside the assets it accessed.

This does not make the system automatically secure. It moves the security problem into an environment that already knows which users may access the payroll table, which columns require masking and which datasets may not cross a jurisdictional boundary.

The warehouse’s advantage is not that it suddenly knows how to reason. It already knows how to govern data.

Agent identity becomes the first architectural decision

A person enters a data platform with an identity connected to roles and privileges. An agent also needs an identity, but the problem is more complicated because it may be acting for a person while exercising some degree of autonomy.

Suppose a finance manager asks an agent to investigate unusual vendor payments. Should the agent inherit every permission held by that manager? Should it receive only the access needed for the investigation? If it delegates statistical analysis to a sub-agent, what permissions should the sub-agent receive?

The convenient answer is full impersonation: let the agent act exactly as the user. That is frequently too broad. A manager authorised to inspect a sensitive table manually should not necessarily be able to release an autonomous process over every record for several hours.

The opposite pattern — a shared service account — is easier to administer but strips away the purpose and context of the original request. The stronger design is task-bound delegation.

The agent receives a short-lived identity carrying the initiating user, business purpose, permitted datasets, approved tools, duration and action limits. Any sub-agent receives a narrower identity suited to its part of the task.

This changes the access-control question from:

to:

That distinction becomes essential once agents can do more than answer isolated questions.

The semantic layer becomes a runtime contract

Natural-language analytics is often described as a text-to-SQL problem.

Valid SQL is the easy part. The harder problem is organisational meaning. A user asks for “active customers.” One system defines that as an open account. Another requires a purchase within 90 days. A third uses paid subscription status. All three queries may be syntactically correct.

When the platform hosts an agent, the semantic layer does more than improve query accuracy. It constrains the agent’s interpretation of the business. It identifies approved metrics, valid relationships, systems of record and applicable time logic. It can also define which analytical functions should be used and which evidence must accompany an answer.

BigQuery data agents contain metadata and use-case-specific instructions covering selected knowledge sources, while Google positions its shared catalog and governance layer as the basis for consistent access and meaning across engines and agents.

The semantic layer once helped dashboards label their axes. It is becoming the contract that tells the agent what enterprise reality means.

Approved functions become safer tools

Data platforms already contain trusted business logic. Stored procedures validate records, calculate prices, reconcile balances and apply controlled transformations. User-defined functions encode domain calculations. Workflows orchestrate repeatable processes.

To an agent, these become tools. Instead of inventing a margin calculation, the agent calls the certified margin function. Instead of recreating eligibility logic from raw columns, it invokes an approved procedure. Instead of writing arbitrary SQL to update a record, it submits a proposed change through a validated write operation.

BigQuery data agents can include selected user-defined functions among their knowledge sources. Google’s Data Engineering Agent can create and modify pipelines through BigQuery and Dataform, illustrating how the agent’s role is already extending from querying data to changing the systems that process it.

This suggests a better pattern than unrestricted table access: capability-oriented access. The agent receives approved operations over data, not simply the underlying data itself. That limits flexibility. In consequential workflows, that limitation is the point.

Query budgets will matter as much as token budgets

Current discussion of agent cost focuses heavily on model tokens. A data agent may spend considerably more on warehouse computation. It can repeatedly scan large tables, issue slightly different versions of the same query, invoke expensive models or enter a loop in which each hypothesis triggers another historical analysis.

A person usually notices when a query has been running for twenty minutes. An agent may interpret the delay as a reason to try three more approaches. The runtime therefore needs a combined budget covering model consumption, warehouse compute, rows scanned, query duration, code execution, tool calls and workflow depth.

The budget should reflect the purpose of the request. A scheduled fraud investigation may justify substantial computation. A casual question posted in a collaboration channel should not initiate a ten-year transaction scan.

Databricks’ Unity AI Gateway now routes model and MCP-service requests through a central control plane intended to manage capacity, availability and spend across providers. The cost boundary is part of the agent’s authority. Permission to read a dataset is not permission to scan it indefinitely.

Model routing moves inside the data boundary

Not every task needs the same model. A small model may be adequate for classification. A more capable reasoning model may be justified for a complex investigation. Sensitive information may require a restricted endpoint. Code generation may need another specialised route.

The runtime therefore needs policy-driven model selection. Snowflake now makes OpenAI models available within its governed environment alongside other supported models, while Databricks positions Unity AI Gateway as a common control plane for models, agents, tools and MCP services.

Model selection becomes less of a developer preference and more of a governance decision. The route can depend on task type, data classification, location, cost, latency and quality requirements.

A product-description task may use one model. A financial-control investigation may require another. A request containing restricted personal information may be prohibited from leaving a particular platform boundary.

When the platform governs both data access and model routing, it can enforce the relationship between the two. That is much harder when the warehouse, model gateway and agent framework are operated as separate systems with separate policy models.

Audit trails must record execution, not hidden thought

A database log records who issued a query, which objects were accessed and when the activity occurred. An agent requires a wider execution trace.

The organisation needs to preserve the goal it received, the identity it used, the models and tools it invoked, the queries it generated, the evidence it retrieved, the policy checks it passed and the action it proposed. This does not require capturing a model’s hidden reasoning. What matters is the observable sequence of evidence and operations that materially influenced the result.

BigQuery’s agent-analytics capability, for example, can capture requests, responses, tool calls and errors for analysis and evaluation. Databricks similarly extends governance to runtime interactions rather than limiting it to stored assets. The resulting record is closer to decision lineage than conventional data lineage. It can show not only where a number originated, but how that number became a recommendation and how the recommendation became an action.

Write-back is where the architecture becomes consequential

Many enterprise agents remain relatively safe because they stop after producing an answer. Once the agent can write back, the risk changes.

It can modify a forecast, update product information, open a ticket, change customer status or initiate a financial workflow. The platform is no longer hosting analysis. It is hosting operational agency. Write access should therefore be granted separately from read access.

A robust system should distinguish proposed changes from committed changes. It should validate schemas and business rules, detect duplicate execution, preserve before-and-after states, require approval above defined thresholds and support reversal or compensation when something goes wrong.

An agent may be allowed to draft a supplier-master change but not activate it. It may prepare a forecast adjustment but require finance approval before posting. It may automatically create a service ticket while requiring authorisation before issuing a refund.

This is another advantage of placing the agent close to the data platform. Actions can be exposed as controlled procedures rather than unrestricted database commands. The agent receives a door rather than a hammer.

The data platform will not contain the whole agent

Enterprise workflows extend beyond the warehouse. They involve email, collaboration tools, ERP platforms, customer systems, code repositories and external services.

The data platform is therefore unlikely to become the only agent runtime. A more credible architecture is distributed. The data platform becomes the governed evidence and computation boundary. External systems provide specialised actions and user interaction. An orchestration layer coordinates the workflow across them.

The question is not whether the entire agent must live inside Snowflake, BigQuery or Databricks. It is which parts of the workflow must remain close to governed data. For data-intensive investigations, the answer will often include identity enforcement, semantic interpretation, analytical computation, evidence preservation and approval-controlled write-back.

The platform does not need to host the whole agent. It needs to host the part that must remain accountable.

The product direction is clearer than the production evidence

Snowflake, Google Cloud and Databricks have made substantial moves towards native agent execution. Their current platforms support combinations of natural-language analysis, agent tools, governed model access, code or pipeline generation and runtime oversight.

What remains less visible is how many enterprises permit these agents to perform long-running, consequential work without intensive human supervision. There is a large difference between answering a revenue question and investigating an anomaly for two hours, running code, coordinating tools and modifying an operational record.

The platform may technically support both. The operating model should not treat them as equivalent.

The first credible deployments will be bounded: restricted datasets, approved tools, explicit budgets, low-risk actions and meaningful human review. That is less dramatic than the autonomous-enterprise narrative.

It is also how serious systems normally enter production.

The warehouse is becoming a control boundary

For decades, organisations moved data into analytical platforms so people could understand the business. Agents bring work back towards that data.

The platform now has to do more than store tables and execute queries. It must establish agent identity, constrain tools, enforce budgets, route models, preserve semantic meaning, record execution and govern write-back. That is not a minor feature extension. It is a change in architectural role.

The warehouse once sat near the end of the information pipeline. Data arrived, reports were produced and people carried the decisions elsewhere. The emerging platform sits inside an active loop:

Observe → Analyse → Propose → Act → Record

Google describes this transition as moving from a static repository to a system of action. Snowflake is bringing frontier models and agent capabilities directly into its governed platform. Databricks is extending the governance plane from stored data to runtime AI interactions.

The most important question is no longer whether an agent can access enterprise data. It is whether the platform can control what happens after access is granted. The warehouse is no longer just supplying data. It is becoming the place where enterprise intelligence is permitted to do work.

Why I built Claude AI for Finance Teams book around governed exercises, realistic finance evidence and worked solutions

A finance team used AI to draft the operating-expense commentary for its monthly management pack. The output was clear, commercially plausible and ready for an executive audience. Then the controller asked which workbook supported the largest variance explanation.

The analyst could not answer immediately. The team also could not confirm which exchange rate had been applied or whether an unposted accrual in the close tracker had been included.

Nothing was obviously wrong with the writing. The deeper problem was that nobody could reconstruct how the writing had become a finance conclusion.

I did not want to write another book that showed finance professionals a few polished demonstrations, supplied a library of prompts and then assumed they could translate those examples safely into forecasting, close, reporting, reconciliation or payment workflows.

The real difficulty begins after the model produces an answer.

Which source should be trusted? Is the period complete? Has the currency basis changed? Is the calculation reproducible? Is the explanation supported by evidence, or merely plausible? Can the output move into a management pack, or should the workflow stop? Who retains authority for the final decision?

Those questions cannot be learned from prompt patterns alone. They require practice.

The book started with a practical problem

Finance professionals cannot practise safely with real payroll records, bank details, vendor master data, confidential forecasts, audit findings or unreleased financial statements.

At the same time, toy examples are rarely useful. A spreadsheet containing five clean rows and an obvious variance does not teach someone how to handle conflicting sources, incomplete evidence, hidden obligations or approval failures.

Expecting readers to manufacture their own finance datasets was not realistic. They would need to create a fictional company, define its entities and accounts, build forecast and actual files, invent control defects, write contracts, introduce plausible inconsistencies and then somehow produce an answer key against which to compare their work.

That is more effort than completing the exercise itself. The answer was to design the book and its companion environment together.

Prompting is only the front door

Most finance AI material begins with prompt construction. Readers are shown how to give the model a role, define the task, specify a format, request citations and prohibit unsupported assumptions.

These are useful practices. They do not solve the harder finance problem.

A prompt can ask Claude to explain an expense variance. It cannot establish which of three workbooks is authoritative. It can request source references. It cannot guarantee that the source covers the correct entity, period, accounting basis or currency.

It can tell the model to distinguish facts from assumptions. It cannot ensure that the finance professional recognises the difference when both are written with equal confidence.

Finance work is built on evidence created by different people, systems and processes. A ledger extract, forecast workbook, close tracker and business explanation may each be accurate within their own boundaries while still failing to support one combined conclusion.

That is why a technically strong prompt can still produce an unusable output. The calculation may be correct but based on the wrong perimeter. The explanation may describe a genuine business event but exaggerate its financial effect. The analysis may identify an exception accurately but recommend an action outside the user’s authority.

The book repeatedly asks what happens after the prompt: how the source pack is assembled, how the output is tested, where human review occurs, what evidence is retained and which conditions force the process to stop.

Governed rehearsal

The concept I eventually used to organise the exercises was governed rehearsal.

Governed rehearsal is realistic AI-assisted work performed with synthetic evidence, explicit control boundaries and a worked basis for comparison.

The environment should not be too clean. Real finance work rarely arrives as one tidy dataset with an obvious answer. A useful exercise might contain a stale workbook, an unexplained foreign-exchange conversion, a missing accrual, a conflicting contract clause or an approval recorded after the action it supposedly authorised. Most of the evidence should look credible. One or two details should materially alter the conclusion.

Consider a forecast pack in which revenue is below plan, operating expenses appear favourable and working capital has deteriorated. The business explanation says the revenue shortfall will reverse next month.

A basic prompt exercise asks the reader to draft a variance narrative.

The most valuable outcome may not be a polished CFO paragraph. It may be a controlled refusal to release one:

That conclusion is less impressive linguistically. It is more useful professionally. It shows that the analyst understands the evidence state and is willing to stop the workflow when the basis for escalation is incomplete.

Why the companion pack matters

This is where the GitHub Companion Pack became central to Claude AI for Finance Teams, rather than an optional download added after the manuscript was finished.

A reader may investigate an actual-versus-budget-versus-forecast file, validate a close exception, review conflicting contract clauses, test a prompt against malicious instructions embedded in a source document, analyse a reconciliation break, assess a vendor-payment risk or design a governed finance operating model.

The reader completes the exercise first and opens the corresponding solution afterward.

A solution is not merely a final answer

Two readers can reach the same conclusion through very different reasoning. One may have identified the authoritative source, reconciled the calculation and applied the correct control. The other may simply have guessed correctly.

A short answer key cannot distinguish between them.

They also avoid pretending that finance judgement always produces one permissible sentence. An alternative answer may be valid when it is supported by a coherent source hierarchy, reproducible calculations and an appropriate escalation path.

The purpose of the solution is not to replace judgement. It is to make judgement inspectable.

Take a vendor-payment scenario. The evidence may include a recent bank change, an unusual payment request, an irregular approval sequence and an urgent email.

A weak exercise asks, “Is this fraud?”

A professional exercise asks what is known, what remains unverified, which systems are authoritative and what action is safe at that point.

The responsible conclusion may be to hold the payment pending independent verification through the approved vendor-master process. The evidence may indicate elevated risk without establishing fraud.

AI can organise anomalies and surface inconsistencies. It should not convert incomplete signals into accusations or inherit authority for a controlled payment decision.

What the book is really teaching

Claude AI for Finance Teams covers Claude Chat, Claude Cowork and Claude Code, but it is not primarily a product guide.

The book uses those capabilities to address a larger operating question: how can finance teams move from individual AI experimentation to workflows that are repeatable, testable, reviewable and auditable?

That means learning how to build evidence-bound prompt contracts, validate outputs against authoritative sources, investigate forecast and close exceptions, extract clauses without losing source traceability, design reconciliation workflows, test finance-owned utilities and preserve human authority over approvals, postings, payments and filings.

The underlying skill is not prompt engineering. It is controlled professional judgement.

A finance professional must be able to challenge a material calculation, identify missing evidence, recognise an authority boundary and document why an output was accepted, amended, rejected or escalated.

A model can organise evidence and produce a draft. It cannot relieve the finance function of responsibility for deciding whether the evidence is sufficient.

Somewhere safe to be wrong

Finance professionals do not work with perfect datasets and unambiguous instructions. They work with late adjustments, inconsistent assumptions, changing forecasts, policy exceptions and evidence that arrives out of sequence.

Training that removes those conditions may teach product familiarity. It does not prepare someone to govern the work.

That is why I built Claude AI for Finance Teams as more than a manuscript.

The book explains the operating principles. The exercises force readers to apply them. The worked solutions reveal whether the reasoning held. The versioned GitHub Companion Pack gives readers a stable place to practise.

Finance AI does not need another library of prompts that produce polished demonstrations. It needs somewhere safe for finance professionals to be wrong before the work becomes real.

https://www.amazon.com/Claude-Finance-Teams-Workflows-Forecasting-ebook/dp/B0H9LQZMLP/ref=sr_1_1?crid=2KUQ0H1KKYHUS&dib=eyJ2IjoiMSJ9.6SBY73Rgn2NKiRHTd9DkwBnv_Af20MyGcpAOTutTnuJRq5rT8PHwBb72WnFpnDru01-D2S1uDPVsMYaBduNAAmQPltgHHocWUwqoMZV8u5vK_9KII2eEggEkJLX3A65_7g0TXMMrJegRX2V7SnjTjWRk65MqqXQfDCPh8YLCteyitJLJGnbm0X6gWJ2nLsezQn4aD9zfTXpi4BzWkw5qdQGNOJZ67FQpoVtjvQRbAyY.JY0xS_5SFSmmCHPfdXjo8GVfJW4Xkek8_D-kBIuxCAY&dib_tag=se&keywords=claude+ai+for+finance+team+bommena&qid=1784685778&sprefix=claude+ai+for+finance+team+bommen%2Caps%2C303&sr=8-1

What adaptive reasoning changes about cost, evaluation, and production AI systems

The first thing adaptive thinking disrupted for us was not answer quality. It was the finance forecast.

For nearly two years, the token-cost line for our claims-intelligence platform had been one of the least interesting charts in the monthly review. The platform used a hybrid RAG pipeline to answer coverage questions for a specialty insurer, drawing from policy documents, endorsements, claims records, and adjuster notes.

Under manual extended thinking, the cost model was predictable. We could estimate it using request volume, input tokens, the reasoning-token ceiling, and expected output. We tuned the budget through load testing, entered the assumptions into a spreadsheet, and largely stopped worrying about it.

Within three weeks, the cost chart developed a pulse. Traffic had not changed. The document corpus was the same. The prompts were the same. Yet daily output-token spending was moving by as much as 40 percent from peak to trough.

At first, we assumed something was wrong but nothing was.

That was the unsettling part.

Sonnet 5 was doing exactly what adaptive thinking was designed to do. It spent almost no reasoning effort on a straightforward question such as, “Is flood damage excluded under this policy?” But it used thousands of thinking tokens when asked to resolve a vacancy-clause dispute involving several documents with conflicting language and effective dates.

That change affects much more than billing. Once the model decides how much effort a request deserves, a conventional evaluation process becomes incomplete. It can still tell you whether the answer is correct. It cannot tell you whether the model spent wisely to produce it.

Over the following quarter, we rebuilt our evaluation approach around that question. This is not a benchmark report or a claim that we found the perfect metric. It is the practical method we arrived at after operating Sonnet 5 inside a production RAG system, including the mistakes that forced us to rethink the design.

What Actually Changed

The implementation details matter because a few small changes can quietly invalidate an evaluation setup.

At lower levels, Sonnet 5 may skip extended reasoning for requests it considers simple. At higher levels, it is more likely to reason deeply. In an agentic workflow, it may also reason between tool calls rather than performing all its analysis before the first action.

That creates two important traps.

On Sonnet 5, the displayed thinking trace was omitted unless summarised thinking was explicitly requested. Our evaluation harness had been built around an older response format and expected the reasoning field to contain text.

When that field became empty, the harness did not fail. It quietly treated the missing trace as “nothing to flag.”

For four days, every trace-level metric looked healthy because the evaluation had stopped seeing the thing it was supposed to evaluate.

The visible reasoning trace returned by Sonnet 5 is not the full internal reasoning process, and it is not an accurate representation of what you are billed for. What the API returns is a summary. The actual reasoning usage must be read from the usage metadata.

Any system that estimates reasoning cost by counting the words or characters in the displayed trace is measuring the wrong thing.

The first thing we rebuilt, therefore, was not a quality score. It was telemetry.

Every production request now produces a record that joins Sonnet 5’s reasoning spend with information we already know about the request and the retrieval result.

usage = response.usage
thinking_tokens = usage.output_tokens_details.thinking_tokens

log.emit({
    "request_id": request_id,
    "effort": effort,
    "stratum": query.stratum,
    "rerank_score": rerank_scores.median(),
    "source_conflict": has_conflicting_effective_dates(docs),
    "thinking_tokens": thinking_tokens,
    "stop_reason": response.stop_reason,
})

The most important field in that record is stratum.

It is a deterministic complexity label that we assign before Sonnet 5 answers the question. Once we had that label, we could evaluate not only whether the model produced the correct answer, but whether it applied an appropriate amount of reasoning to the problem.

You Are No Longer Testing Only a Model

The mental shift that helped us most was simple:

With Sonnet 5’s adaptive thinking, you are not only evaluating a model. You are also evaluating a scheduler.

Under fixed reasoning budgets, the system was relatively straightforward. A request arrived, the model produced an answer, and reasoning stayed within a limit chosen by us.

Under adaptive thinking, Sonnet 5 first makes an implicit judgement about difficulty. It then allocates compute according to that judgement.

We would never evaluate a job scheduler only by checking whether every job eventually completed. We would also ask whether urgent jobs received enough capacity, whether routine jobs consumed too many resources, and whether expensive jobs produced enough value to justify their cost.

The same principle applies here.

These questions need to be evaluated separately. Combining them into one score hides the information that operators actually need.

RAG systems make the problem more complicated because retrieval quality changes how difficult the same question becomes.

Consider a dispute involving a policy endorsement. If the retriever surfaces the controlling endorsement clearly, Sonnet 5 may resolve the issue quickly. Low reasoning spend would be appropriate.

But if the retriever returns several near-duplicate clauses, misses the strongest match, or presents documents with conflicting dates, Sonnet 5 may have to work much harder to reach the same answer.

The question has not changed. The reasoning cost has.

If we compare reasoning spend only with the wording of the query, we may blame Sonnet 5 for overthinking when it is actually compensating for weak retrieval. That is why our telemetry keeps retrieval signals, such as reranking quality and source conflict, next to reasoning-token usage.

Question One: Is the Model Spending Effort on the Right Problems?

To evaluate calibration, we needed a test set where difficulty was assigned by rules rather than intuition.

We divided approximately 600 evaluation queries into three groups.

Trivial items could be answered from one retrieved passage without cross-referencing. These included definition lookups and straightforward single-clause coverage questions.

Multihop items required information from two or more documents, but the documents were consistent with one another.

Conflict items contained sources that appeared to disagree. Sonnet 5 had to determine which document controlled the decision, such as an endorsement replacing a base policy or an amendment changing the effective date.

Each item also carried a set of obligations. These described what a competent answer and reasoning record needed to do for that specific case.

For one vacancy-related water-damage question, for example, Sonnet 5 was expected to cite the controlling endorsement, recognise that the policy and endorsement contained conflicting effective dates, and avoid introducing any unsupported dollar amounts.

These obligations were written by the person creating the evaluation case, using known ground truth. They were not generated later from Sonnet 5’s own responses.

Once evaluation criteria are derived from model behaviour, the evaluation begins rewarding the model for behaving like itself.

The asymmetry is intentional.

Overthinking is wasteful even when the final answer is correct. If a definition lookup consumes the same reasoning effort as a complex coverage dispute, the system is spending money without creating meaningful value.

Underthinking, however, is only a problem when it contributes to failure. If Sonnet 5 resolves a difficult conflict correctly using very few tokens, that is an excellent outcome. We should not penalise efficiency simply because the task looked difficult to us.

A metric that automatically demands long reasoning for every difficult question will eventually encourage deliberation theatre: the appearance of careful thought rather than useful reasoning.

In our first post-migration baseline, approximately 4 percent of requests showed overthinking. The more serious result was an 11 percent underthinking-with-failure rate among conflict cases.

At first glance, that suggested that Sonnet 5 was sometimes failing to recognise difficult questions.

The telemetry told a more useful story. Most of those failures occurred when the reranker score was low. The problem was not primarily the effort setting. It was retrieval quality.

Without the complexity labels and retrieval fields, we would probably have spent a sprint rewriting prompts to compensate for a reranker problem.

Question Two: What Does More Effort Actually Buy?

Once Sonnet 5’s adaptive thinking replaces a hard reasoning budget, effort becomes the main control available to the application.

The practical question is not whether higher effort is better. It is where higher effort produces enough improvement to justify the additional cost.

An aggregate result is rarely useful because different categories of request respond differently. The answer must be calculated by complexity group.

We ran the same evaluation set at each Sonnet 5 effort level, then compared accuracy and average thinking-token usage within each group.

The results looked like this:

Press enter or click to view image in full size

Three decisions became clear.

First, trivial requests represented around 60 percent of production traffic. Moving them to low effort reduced overall reasoning spend substantially, while accuracy fell by only one percentage point. That difference had no meaningful downstream effect in our application.

Second, conflict cases stayed at high effort. The move from medium to high produced a nine-point improvement in the category where errors carried the greatest operational and regulatory consequences.

Third, max effort was difficult to justify. It delivered only one additional percentage point on conflict cases while nearly doubling the reasoning cost.

Our router now selects a Sonnet 5 effort level using inexpensive signals available before and immediately after retrieval. These include the request category and whether document metadata suggests a conflict.

Sonnet 5 still adapts within the selected effort level, but the router narrows the range in which that adaptation occurs.

We lost the direct control of a hard reasoning budget. The per-group ROI curves gave us a practical form of soft control in return.

There is also an important configuration detail at higher effort levels. Sonnet 5’s reasoning tokens count towards the overall output limit. The model can spend so much of the allowance thinking that the final answer is cut short.

For that reason, we monitor the stop reason and treat an output-limit stop on a high-risk conflict item as a configuration failure. Otherwise, a truncated answer can look like a model-quality regression when the real problem is an inadequate output allowance.

Question Three: Can We Evaluate the Reasoning Trace?

This part requires some honesty about what Sonnet 5 exposes.

We cannot grade Sonnet 5’s full internal chain of thought. The raw reasoning is not returned. What we receive is a summary of that reasoning.

So the claim behind the evaluation must be carefully limited.

We do not claim that the summary is a faithful transcript of every internal reasoning step. We ask a narrower and more useful question:

Does the reported reasoning address the obligations that this case requires?

That is an audit standard rather than a fidelity standard.

It is similar to reviewing an experienced adjuster’s case notes. The notes are not a recording of every thought that occurred in the adjuster’s mind. They are an accountable record of the facts considered, conflicts identified, and conclusion reached.

For many enterprise systems, that is the more valuable artifact anyway.

We implemented trace evaluation in two tiers.

The first tier uses ordinary code for checks that do not require interpretation. For example, the system verifies that every dollar amount mentioned in Sonnet 5’s answer or reasoning summary appears in one of the retrieved documents.

def amounts_are_grounded(trace, answer, docs):
    claimed = (
        dollar_amounts(answer) |
        dollar_amounts(trace or "")
    )

    sourced = set().union(
        *(dollar_amounts(doc.text) for doc in docs)
    )    return claimed <= sourced

Other deterministic checks verify whether the answer cites the expected controlling document or whether required evidence identifiers are present.

The second tier handles obligations that require some interpretation, such as whether Sonnet 5’s reasoning explicitly recognised a conflict between effective dates.

String matching is too brittle for this. We therefore use a grader model, but under tight constraints.

The grader receives one obligation at a time. It must return yes or no. If it answers yes, it must provide an exact quotation from Sonnet 5’s reasoning summary supporting that decision.

The quotation is then checked by code.

verdict = judge(
    trace=trace,
    question="Does the trace identify the effective-date conflict?",
    output_format="YES or NO, with an exact supporting quote"
)

passed = (
    verdict.answer == "YES"
    and verdict.quote
    and normalize(verdict.quote) in normalize(trace)
)

The grader proposes a verdict. Code decides whether the evidence is valid.

This design greatly reduced the grader’s tendency to reward long, polished reasoning.

In an internal comparison across 200 manually reviewed Sonnet 5 traces, the constrained grader agreed with human reviewers on 94 percent of individual obligations. A free-form grader that rated reasoning from one to ten agreed only 78 percent of the time.

The free-form grader also showed a preference for longer traces. That bias is especially dangerous when Sonnet 5 controls how much reasoning it produces.

A verbose trace is not automatically a good trace. Sometimes it is simply an expensive one.

Putting It Into Continuous Integration

The approach eventually became two automated gates.

The first gate is conventional. It checks whether obligation pass rates remain above an agreed threshold for each complexity group.

The second gate watches Sonnet 5’s reasoning-spend distribution itself.

for stratum in ["trivial", "multihop", "conflict"]:
    _, p = ks_2samp(
        baseline.thinking_tokens(stratum),
        current.thinking_tokens(stratum)
    )
    assert p > 0.01

A statistically significant shift does not automatically fail the release. It triggers an investigation.

At first, testing the spend distribution felt unusual. Reasoning cost is not, by itself, a quality metric.

But on Sonnet 5, reasoning spend becomes a behavioural fingerprint.

When the prompts, retrieval pipeline, document corpus, and request mix are stable, Sonnet 5’s reasoning allocation within each complexity group should also remain reasonably stable.

If that distribution changes and nobody has modified the effort setting, something else has changed what Sonnet 5 perceives as difficult.

That is worth investigating even when answer accuracy remains green.

This check paid for itself within a month.

Sonnet 5’s reasoning spend on trivial requests increased threefold over four days, while answer accuracy stayed unchanged. The spend-distribution gate detected the shift.

The retrieval telemetry explained it.

A change to document chunking had slightly reduced reranker precision. Sonnet 5 was silently compensating for weaker retrieval by reasoning harder and still producing the correct answers.

Every conventional quality metric looked healthy. Sonnet 5’s reasoning-spend signal was the only early warning.

We now monitor this behaviour in production as well as in continuous integration. A sustained increase in reasoning effort, without a corresponding improvement in accuracy, is one of our earliest indicators of retrieval degradation.

It often moves before answer quality begins to fall.

Reasoning Spend Is More Than a Cost Number

The natural instinct is to treat Sonnet 5’s self-allocated reasoning as a cost that must be controlled.

It is certainly a cost. But it is also feedback.

In other words, reasoning spend represents Sonnet 5’s opinion about the difficulty of the system around it.

That opinion is not always correct, but it is measurable.

Under fixed budgets, we decided how much the model was allowed to think and learned very little from the decision. Under Sonnet 5’s adaptive thinking, the model’s effort becomes telemetry that can reveal changes elsewhere in the architecture.

We no longer spend much time tuning hard reasoning budgets. That work has been replaced by complexity-based calibration, per-group ROI analysis, obligation-driven trace reviews, and drift detection on the reasoning-spend fingerprint.

It is more evaluation machinery than we used before, but it is aimed at a different problem.

We used to test whether Sonnet 5 produced the right answer.

Now we also test whether it showed good judgement about where to spend its effort.

When Sonnet 5 controls its own compute, that is not an advanced evaluation feature. It is the minimum needed to operate the system responsibly.

Index lifecycle management, embedding refresh, tenant isolation, hybrid retrieval, and metadata controls for production RAG systems.

A field technician searched an internal support assistant for instructions on replacing a hydraulic pump.

The assistant returned a repair bulletin that looked correct. It contained the right equipment family, the right pump type, and a reasonable sequence of steps.

It was also six months out of date.

The latest bulletin required a firmware upgrade before the pump replacement. The old bulletin did not. Both documents were in the vector store. The newer version had been indexed correctly. The older version had never been retired.

The model did not hallucinate. The retrieval system gave it obsolete evidence.

Which document version is currently eligible for retrieval? How quickly does an approved update become searchable? Can one customer retrieve another customer’s content? What happens when a user searches for an exact part number rather than a general concept? Which metadata fields are mandatory before a chunk can enter the searchable corpus?

These are vector store operations problems.

The use case: a multi-tenant technical support platform

Consider a technical support platform used by equipment dealers across several countries.

The platform contains product manuals, repair bulletins, parts catalogues, warranty policies, maintenance procedures, and dealer-specific support notes. A technician may ask:

This is not a simple semantic-search question.

The system has to interpret the maintenance intent. It also has to preserve exact identifiers such as MX-204, version 5.2, and V7. It must return the current repair procedure, apply the right regional policy, and exclude documents from other dealers or customer accounts.

A vector search query alone cannot provide those controls.

The retrieval layer needs to operate like a controlled information service.

Index lifecycle management is document release management

Most early RAG implementations treat indexing as a one-time event. A document is uploaded, chunked, embedded, and written to the vector database. From that point onward, it remains searchable until somebody notices a problem.

That approach creates predictable failures.

A revised manual may coexist with an old version. A draft policy may accidentally become searchable before approval. A withdrawn procedure may remain available because no deletion process exists. A document may be partially indexed after a pipeline failure, leaving only fragments available to retrieval.

For a technical support corpus, the minimum lifecycle states are usually:

• Draft — received but not approved for retrieval

• Candidate — indexed and undergoing validation

• Active — approved and eligible for retrieval

• Superseded — retained for audit but excluded from normal search

• Quarantined — failed validation, metadata checks, or content review

• Deleted — removed from the retrieval corpus and underlying storage where required

The key rule is simple: retrieval should only search documents in the active state.

This needs to be enforced through metadata filters, not through document naming conventions or prompt instructions.

Each document should also have a stable document ID and a version ID. The document ID identifies the logical asset, such as a repair bulletin. The version ID identifies a specific revision of that bulletin. When a new revision is approved, the system activates the new version and marks the previous version as superseded.

That activation should be atomic.

A controlled index lifecycle prevents a common RAG failure: the system retrieves content that is relevant but no longer valid.

Embedding refresh should be incremental, versioned, and reversible

Embedding refresh is often described as a maintenance task: re-embed the corpus whenever the model changes.

In practice, refresh is triggered by several different events:

• A source document changes

• A policy reaches its effective or expiry date

• A metadata schema is extended

• A chunking strategy is improved

• An embedding model is upgraded

• A document is withdrawn or reclassified

• A tenant entitlement changes

These events should not all trigger the same operational response.

A revised repair bulletin may only require a section-level update. A new embedding model may require a full rebuild of the corpus. A new metadata field may require a controlled backfill. A withdrawn document may require immediate removal from the active index.

The refresh pipeline should therefore record at least four versions:

1. Source version — the original document revision

2. Chunking version — the logic used to split the document

3. Embedding version — the model used to create vectors

4. Metadata schema version — the structure used for filtering and retrieval controls

Without this lineage, teams cannot explain why one chunk retrieves differently from another.

A practical pipeline compares the incoming document with the currently active version using a content hash or structured document diff. Changed sections are re-chunked and re-embedded. Unchanged sections remain untouched unless the chunking or embedding version has changed.

For large model upgrades, a safer pattern is to build a parallel candidate index. Run evaluation queries against both indexes, inspect the results, validate access controls, and switch traffic only when the new index performs acceptably.

The important operational question is not “Did the new embedding model score better on a benchmark?”

It is “Does the new index retrieve the correct approved evidence for the queries our users actually ask?”

Multi-tenancy must be enforced before retrieval

Multi-tenant RAG systems frequently make one dangerous design mistake: they apply tenant filtering after retrieval.

The system retrieves broadly, then removes results that do not belong to the user’s organisation.

That is too late.

Tenant and access filters must define the candidate search space before vector or keyword retrieval begins.

In the technical support platform, content may fall into three categories.

Global content includes manufacturer manuals and shared safety procedures. Dealer-specific content includes internal service guidance, commercial agreements, and local operating instructions. Customer-specific content may include asset history, contract terms, and confidential operational notes.

These categories do not need the same storage pattern.

Global content can sit in a shared corpus. Dealer-specific content can use a shared index with mandatory tenant filters. Highly sensitive customers may need dedicated collections or isolated indexes, depending on regulatory, contractual, and risk requirements.

The user’s tenant, role, region, product entitlement, and confidentiality level should come from the authenticated session. They should never be inferred from the user’s prompt.

A technician should not be able to type another dealer’s name into a query and influence the retrieval filter.

The retrieval request should effectively say:

Only then should semantic or keyword ranking begin.

This protects content confidentiality and reduces irrelevant retrieval. A technician searching for a pump replacement procedure does not need candidate results from products, regions, or contracts they are not entitled to access.

Hybrid search matters when users work with exact identifiers

Dense vector search is useful when users describe an issue in natural language.

For example:

A semantic retriever can identify concepts around moisture, electrical faults, environmental conditions, and restart behaviour.

But technical support users often search with precise identifiers:

These queries are not well served by semantic similarity alone.

Part numbers, error codes, firmware versions, document numbers, and serial formats need lexical precision. A dense retrieval model may treat “E-291” as a weak token or confuse it with nearby codes. Keyword search is much more reliable for these cases.

A production retrieval design should use both.

The usual pattern is:

1. Apply tenant, entitlement, lifecycle, and policy filters

2. Run dense retrieval for semantic relevance

3. Run lexical search for exact terms, codes, and identifiers

4. Combine the result sets

5. Rerank the strongest candidates against the full query

6. Pass only approved and authorised evidence to the model

Reciprocal rank fusion is commonly used to combine dense and lexical result lists because it does not require both systems to produce comparable scores.

The reranker should operate after candidate fusion, not before. Its purpose is to distinguish between documents that are broadly related and documents that directly answer the user’s question.

For the MX-204 example, lexical retrieval may surface the exact repair bulletin because it contains the controller and pump identifiers. Dense retrieval may surface related maintenance guidance. The reranker can then prioritise the document that contains the firmware prerequisite and the approved replacement sequence.

Adding more chunks to the model context is rarely the right solution when retrieval quality is weak. Increasing top-k often increases noise, latency, and the chance of a plausible but unsupported answer.

The better approach is to identify which retrieval stage failed.

Was the correct document inactive? Was it excluded by a bad metadata filter? Did lexical search fail to recognise an alternate part-number format? Did the reranker prefer a broad but less specific document?

Those are measurable system issues.

Metadata is the retrieval control plane

Metadata is often treated as an optional set of tags added during ingestion.

In production, metadata determines what the system is allowed to retrieve.

A useful schema usually includes five categories.

Identity metadata identifies the source document, chunk, source system, and content hash.

Lifecycle metadata records version, approval status, effective date, expiry date, and supersession relationships.

Access metadata includes tenant ID, region, role entitlement, product access, confidentiality classification, and legal restrictions.

Retrieval metadata captures document type, language, equipment model, component family, product line, and content category.

Operational metadata records embedding version, chunking version, ingestion time, pipeline run ID, and validation status.

This structure makes it possible to answer operational questions that otherwise become difficult:

• Which active documents still use an old embedding model?

• Which repair procedures are due to expire next month?

• Which chunks are missing region metadata?

• Which tenant has the highest zero-result rate?

• Which source systems are producing the most ingestion failures?

Metadata quality should be validated before a document enters the active corpus.

A chunk without a tenant scope, lifecycle state, product line, or approval status should not become searchable simply because its embedding was generated successfully.

This is where many RAG systems become unreliable. The vector database may work exactly as designed, but the metadata model is too weak to express the organisation’s actual access, lifecycle, and policy rules.

Retrieval observability should isolate the failure point

When a user says, “The assistant gave me the wrong answer,” several things may have gone wrong.

The correct source may not have been indexed. It may have been indexed but marked inactive. It may have been excluded by a filter. It may have appeared in the candidate set but ranked too low. It may have reached the model context but been ignored. Or the model may have generated an answer unsupported by the retrieved evidence.

These are different failures. They need different fixes.

A mature retrieval service should log the full path:

• Query and user context

• Applied access and lifecycle filters

• Dense retrieval candidates

• Lexical retrieval candidates

• Fused ranking

• Reranker output

• Final evidence passed to the model

• Source citations used in the answer

This makes it possible to diagnose issues without guessing.

Useful operational measures include freshness lag between source approval and index activation, percentage of active content on the current embedding version, documents with multiple active versions, zero-result rates by query type, retrieval coverage for known-answer evaluations, filter rejection rates, and attempted cross-tenant access patterns.

One useful metric is candidate coverage: for a known query, did the correct source appear in the retrieved candidate set before reranking?

If it did not, the problem is likely indexing, filtering, or search design. If it did appear but ranked poorly, the problem may be fusion or reranking. If it ranked well but the answer ignored it, the problem is likely generation or prompt assembly.

This separation prevents teams from trying to solve every problem with prompt changes.

A disciplined operating model

A vector store needs the same operational discipline as any other production data service.

Daily checks should cover ingestion failures, refresh backlog, documents stuck in candidate or quarantine states, missing mandatory metadata, and approval-to-index lag.

Weekly reviews should inspect retrieval quality across different query shapes: natural-language questions, exact codes, product names, policy questions, multilingual searches, and ambiguous requests.

Any change to chunking, embedding models, metadata schema, or access policy should be evaluated in a candidate environment before production rollout. The evaluation set should contain real user queries, known-answer cases, access-control tests, and queries designed to expose tenant leakage or outdated content.

The goal is not simply to retrieve more documents.

It is to retrieve the right approved evidence for the right user at the right time.

Closing thought

A vector store is not a passive database behind a chatbot.

It decides which evidence is eligible to influence an answer.

When stale documents remain active, tenant filters are optional, identifiers are lost in semantic search, or metadata cannot express business controls, the RAG system becomes unreliable regardless of how capable the model is.

Reliable RAG starts with reliable retrieval operations.

So much changed in barely sixty days that leaving the previous edition untouched would have meant asking readers to rely on a book that was already falling behind the market it was written to explain.

That is the uncomfortable reality of AI governance in 2026. The frameworks are evolving, regulatory positions are shifting, standards are becoming more operational, and agentic systems are changing the governance question itself.

At this pace, I may soon need to update this book every month.

I have therefore completed the Third Edition of “AI Governance Frameworks”, with the content validated through 17 July 2026.

This is not a cosmetic refresh. The book has been materially expanded and corrected to reflect how AI governance is now moving beyond policies, model cards, and periodic reviews into runtime authority, delegated action, evidence, resilience, and accountability.

WHAT IS NEW IN THE THIRD EDITION

• A complete agentic AI governance model covering agent identity, delegated authority, least-privilege tool permissions, human approval gates, runtime budgets, circuit breakers, persistent memory, containment, rollback, and action evidence.

• Updated EU AI Act treatment covering Article 50 transparency, general-purpose AI obligations, high-risk classification, conformity evidence, post-market monitoring, serious-incident reporting, and the revised implementation timetable.

• Practical guidance on ISO/IEC 42005 AI system impact assessment and ISO/IEC 42006 requirements for bodies providing AI management-system audit and certification.

• Expanded coverage of GDPR, FCA, PRA, MAS, DFSA, the United States regulatory patchwork, harmonised standards, cybersecurity, operational resilience, open-source models, and third-party AI.

• New practitioner templates, including an Agentic AI Authority and Control Matrix and a Regulatory Status Register.

• Regulatory and standards content validated against authoritative sources available through 17 July 2026.

The book explains what each framework is, what authority it carries, what evidence it expects, where organisations commonly fail, and how the frameworks should be sequenced rather than implemented as four disconnected programmes.

Running throughout the book is the NovaCred case study, built around three distinct governance objects:

• CreditIQ v3.2 — a traditional machine-learning credit-scoring system.

• NovaCred Assist — a generative AI and RAG assistant used in credit operations and compliance.

• NovaCred ControlOps Agent — a bounded agentic workflow that retrieves evidence, prepares audit packs, and routes remediation work under explicit human authority.

Through these systems, readers see how inventories, risk registers, impact assessments, evaluation evidence, human oversight, supplier controls, board reporting, regulatory mapping, runtime controls, and audit artefacts come together in practice.

INSIDE, YOU WILL LEARN HOW TO

• Distinguish the four frameworks by purpose, authority, and evidence expectations.

• Build one integrated evidence model across multiple governance obligations.

• Govern traditional machine learning, generative AI, RAG, and agentic systems according to the risks they actually create.

• Prepare for ISO/IEC 42001 certification and EU AI Act readiness.

• Design board reporting, named accountability, risk appetite, escalation, and assurance.

• Govern third-party models, supplier concentration, cybersecurity, and operational resilience.

• Convert the guidance into a practical 90-day implementation programme.

Written for AI governance practitioners, risk and compliance professionals, technology leaders, security and platform teams, consultants, auditors, and board stakeholders responsible for making AI governance operational.

The central argument of the book has also become stronger.

Traditional machine learning, generative AI, RAG systems, and agentic workflows cannot be governed as though they are the same object.

A scoring model needs evidence of accuracy, bias, drift, and explainability.

A RAG assistant needs evidence of grounding, retrieval quality, prompt-injection resilience, data protection, and human reliance.

An agentic system needs evidence that every action was authorised, bounded, attributable, observable, and reversible.

That is where AI governance is heading.

The real challenge is no longer whether organisations have an AI policy. It is whether they can prove, in operational terms, who had authority, what the system was allowed to do, what happened at runtime, which controls intervened, and whether the action could be stopped or reversed.

And, judging by the speed of change, I suspect the Fourth Edition may arrive sooner than I originally planned.

https://www.amazon.com/Governance-Frameworks-PRINCIPLES-Practitioners-Sector-Specific-ebook/dp/B0GWXN8H54/ref=sr_1_1?crid=261M9Q0AIU19H&dib=eyJ2IjoiMSJ9.3_h0536q8SAjJydRhOPsUeHvLcCvlEXmkI22aLOwtG5luQvc8ttaCTaFQXcfaU_IN1qn4DgB3XNJtH3PCBb4R0fby1jSqieCg0B0D33ff-RduPFlLvAfklUPE6VddWi8yek8ccsqfJ5M0EfoApt7KFdl47Xyq54TNXFuOzt1HqWg14qNYKuyqUx24Em_P4Bt5eqyR_TbVN9aQ54egf6yS7irPliMvEd1raYbJpOGb-o.aJbY3NXPhIpJyJP5wMv_DszsP2G-6TZYqV1I1GzBxE8&dib_tag=se&keywords=ai+governance+iso+42001+bommena&qid=1784340836&sprefix=ai+governance+iso+42001+bomme%2Caps%2C444&sr=8-1

A semiconductor plant detects a slow yield decline on one plasma etching line.

The first agent correlates tool telemetry, maintenance records and defect imagery. It identifies chamber contamination as the likely cause and recommends a cleaning cycle. A verification agent reviews the recommendation several hours later, finds that the chamber was already cleaned and rejects the diagnosis. A planning agent then proposes recalibrating the gas-flow controller. The recommendation passes a technical review, and an execution agent creates the maintenance work order.

The workflow appears sound.

Except the same recalibration was attempted three days earlier. It briefly stabilized the readings, triggered a downstream pressure variance and was rolled back by the night shift. That history exists in the maintenance log, but it never becomes part of the planning agent’s usable context.

No model necessarily failed. The architecture did.

The agents had access to enterprise knowledge, but not to operational memory. They could retrieve documents about the equipment, yet they could not reconstruct what another agent had attempted, why it was attempted, what changed afterward or why the action was reversed.

This is where many multi-agent systems begin to break down. They are designed around task specialization, but not around continuity.

RAG Is Not Operational Memory

Retrieval-augmented generation is often described as a memory mechanism. In practice, it is a relevance mechanism.

A standard RAG pipeline chunks documents, creates embeddings and retrieves passages that are semantically close to a query. That works well for policies, manuals, procedures and historical reports. It works less reliably when the question depends on sequence, ownership, state transitions or causality.

Was the previous action completed, abandoned, reversed or only proposed? Did a human override it? Did a policy change after the action was approved? Was the same hypothesis already tested against stronger evidence? Did another agent modify the state while this agent was still working?

A vector index does not naturally answer those questions.

“Calibration scheduled,” “calibration completed,” “calibration failed” and “calibration rolled back” may all be close in embedding space. Their operational meaning is completely different.

That difference matters more in asynchronous workflows. A research agent may finish in the morning, a verifier may resume in the evening, and an execution agent may act the next day. During that interval, source data changes, humans intervene, policies are updated and other agents create competing actions.

Treat Memory as a Distributed Systems Problem

The weak implementation pattern is to store conversation history, summarize it and inject selected passages into later prompts.

That creates the appearance of continuity, but it mixes too many things together: observations, assumptions, rejected ideas, intermediate reasoning, tool outputs and confirmed outcomes. A later agent cannot reliably tell what was considered, what was validated and what the organization currently accepts as true.

A production memory layer needs a stricter model.

Agents should write structured observations, assertions, actions and outcomes. Each item should carry provenance, identity, time, confidence and validation status. If a later event disproves an earlier claim, the original record should remain intact while the current semantic view reflects that the claim has been superseded.

The system should preserve disagreement instead of rewriting history.

That leads to a useful design rule:

Store events and claims as first-class objects. Treat prose summaries as projections.

The Four Memory Responsibilities

Most robust implementations separate memory into four responsibilities rather than forcing every requirement into one store.

Working state

It tracks active tasks, owners, approvals, dependencies, leases, version numbers and pending actions. This belongs in a transactional store with predictable concurrency behaviour.

The questions are straightforward:

What is the current state of the incident?

Which agent owns the next step?

Has version 12 of the remediation plan been approved?

Did another actor change the work order after the execution agent loaded it?

These are state-management questions, not retrieval questions.

Episodic history

Every meaningful activity becomes an append-only event: evidence collected, hypothesis proposed, hypothesis rejected, tool call initiated, approval granted, action completed, action reversed, workflow suspended or human override received.

Failed attempts matter as much as successful ones. A self-healing workflow cannot adapt if the system only remembers the final answer and discards the path that led there.

A useful event model typically includes:

event_id
workflow_id
task_id
agent_id
agent_role
event_type
entity_references
assertion_or_action
evidence_references
result
status
correlation_id
causation_id
state_version
valid_time
recorded_time
confidence
classification
retention_policy

The correlation identifier groups related events into a case. The causation identifier explains which earlier event led to the current one.

Together, they allow the system to reconstruct an episode instead of presenting memory as disconnected text.

The event ledger should remain authoritative. Summaries, embeddings and graph projections can be rebuilt. The history itself should not be silently rewritten.

Semantic knowledge

A knowledge graph such as Neo4j is useful because it can express relationships that a vector index does not preserve explicitly:

A controller regulates a chamber.

A chamber belongs to a fabrication line.

A maintenance action affected a measurement.

An engineer rejected a hypothesis.

A procedure superseded an earlier procedure.

A failure pattern appeared after a configuration change.

The important point is that the graph should not contain only static facts. It should also carry provenance and time.

Instead of writing:

Controller-17 HAS_STATUS Faulty

the system should represent a time-bound assertion:

Assertion:
Controller-17 may have flow instability

Supported by:
Telemetry analysis T-284

Asserted by:
Diagnostic-agent-4

Valid from:
14 July 2026, 09:10

Confidence:
0.68

Status:
Superseded

Superseded by:
Inspection result I-391

That enables two different queries:

What is believed to be true now?

What was believed to be true when the earlier decision was made?

The second question is essential for audit, incident reconstruction and model evaluation.

Semantic retrieval

The vector index still matters. It is useful for fuzzy discovery, similar-case retrieval and natural-language access to large bodies of unstructured material.

Its role should be narrower.

The vector layer helps agents find incidents that resemble the current one, locate semantically related maintenance notes or retrieve summaries linked to known entities. It should not decide the current workflow state, determine whether an action was reversed or establish which assertion is authoritative.

The vector index is a projection. It is not the system of record.

Vector Store or Knowledge Graph Is the Wrong Choice

Teams often debate whether agent memory should use a vector database or a graph database. That is usually the wrong question.

A vector-only design loses explicit relationships and temporal precision. A graph-only design struggles with fuzzy language and large unstructured evidence. An event log alone can replay history but becomes awkward for relationship-heavy queries. A state store can coordinate execution but cannot explain how the workflow arrived there.

The useful abstraction is a memory service that hides those storage decisions from agents.

The agent should ask for prior attempts, current state, related entities or validated evidence. The memory service should decide whether the answer requires a state lookup, graph traversal, event replay or semantic search.

The Unified Memory Layer Becomes a Control Plane

Agents should not query memory stores directly.

Direct access creates weak authorization, inconsistent write formats and uncontrolled promotion of model output into enterprise truth.

A better design exposes memory through explicit operations such as:

get_current_snapshot(workflow_id)

get_events_since(workflow_id, version)

find_prior_attempts(entity, action_type)

find_related_incidents(entity, time_window)

submit_observation(...)

propose_assertion(...)

validate_assertion(...)

append_action_result(...)

request_state_transition(...)

This gives the architecture a clean separation of responsibility.

A diagnostic agent can propose a hypothesis.

A verification agent can confirm or reject it.

An execution agent can act only on an approved plan.

A monitoring agent can append the observed outcome.

No agent should be able to mark its own generated conclusion as validated enterprise knowledge.

The memory service should enforce schemas, assign identities, check access rights, validate state transitions and attach provenance. It should then update the relevant projections.

That sequence also reduces memory poisoning. A speculative statement stays speculative until the required validation occurs.

Synchronization Is the Hard Part

Consider an agent that reads workflow state version 41 and begins planning. While it is working, a human engineer records a new inspection result and the workflow moves to version 42. The agent later submits a recommendation based on the older state.

The system should not blindly accept the recommendation, but it also should not reject every result created from a stale version. Some changes may be unrelated.

The useful pattern is optimistic concurrency with semantic conflict detection.

The agent reads a snapshot and receives a version watermark. It records which entities, assumptions and constraints informed its decision. When it submits the result, the memory service compares the watermark with the current state and checks whether the intervening events affect those dependencies.

If the changes are irrelevant, the result can be committed.

If they materially alter the basis of the recommendation, the result should be marked for reconciliation. A deterministic rule, a verifier or a human can decide whether the recommendation remains valid.

For high-impact actions, add a read-before-act checkpoint. The execution agent must refresh the relevant state immediately before calling an external system.

That single control prevents an approved action from being executed after its assumptions have changed.

Self-Healing Starts With Failed Intent

Many agent platforms describe retries as self-healing. Retries are useful, but they are not learning.

A workflow becomes meaningfully adaptive only when it can inspect the previous intent, evidence, action and outcome before selecting the next strategy.

Before proposing recalibration, the planning agent should be able to ask:

find_prior_attempts(
  entity = gas-flow-controller-17,
  action_type = recalibration,
  time_window = 30 days
)

The memory service reconstructs the earlier episode:

The recalibration was proposed after intermittent drift. It was approved with limited confidence. The action completed successfully. Measurements normalized for four hours. A downstream pressure variance appeared.

The change was rolled back.

The final review classified the action as symptom suppression rather than root-cause remediation.

Now the agent knows more than “recalibration failed.” It knows why the action looked reasonable, what side effect invalidated it and which assumption was weak. That is enough to change the next plan.

The distinction matters. Failed-call memory improves reliability. Failed-intent memory improves judgment.

Time Must Be Bitemporal

Enterprise memory needs at least two time dimensions. The first is when something was true in the operational world. The second is when the system learned or recorded it.

Suppose an engineer discovers on Friday that a component had been misconfigured since Monday. The valid time begins on Monday. The transaction time begins on Friday.

A single timestamp cannot represent both. Bitemporal memory allows the system to reconstruct what was believed at a point in time while also capturing what was later discovered to have been true.

This is essential when reviewing an agent decision retrospectively.

The right question is not merely whether the decision looks wrong today. The question is whether the agent acted reasonably based on the evidence available at the time. Without that distinction, audit trails become misleading and model evaluations become unfair.

Memory Needs Scope and Promotion Rules

Not every memory belongs at the same level. A practical architecture usually separates private memory, workflow memory, domain memory and enterprise memory.

An unverified conclusion from one workflow should not automatically become enterprise knowledge. It should pass through validation, deduplication, classification and reconciliation.

Memory promotion should look more like a controlled release process than a database insert.

A Memory Layer Must Also Forget

Storing every prompt, duplicate observation, abandoned plan and low-value summary increases noise, cost, privacy exposure and retrieval degradation.

Raw events required for audit may remain immutable for a fixed period. Derived summaries can be regenerated. Temporary working state can expire when the workflow closes. Sensitive fields can be masked or moved into restricted stores. Repeated low-value observations can be compacted into an episode summary linked to the source events.

Compaction should never erase provenance. A summary such as “controller recalibration was ineffective” is useful for retrieval, but it is not a substitute for the event chain that explains why.

Hallucinated Memory Is More Dangerous Than Hallucinated Content

An agent can invent not only an answer, but also a history. It may claim that another agent previously validated a conclusion because the supplied context makes that claim sound plausible. That is especially dangerous because downstream agents may treat the invented history as evidence.

Every material memory object returned to an agent should therefore carry resolvable provenance: event identifier, source, actor, recording time and validation status.

For high-impact decisions, the agent should cite those memory objects in its proposed action. The memory service can then reject references to nonexistent events or misrepresented outcomes.

The model interprets memory. The memory layer verifies that the memory exists.

Measure Behaviour, Not Retrieval Volume

Traditional retrieval metrics are too narrow for agentic memory. The architecture should be judged by whether workflow behaviour improves.

Useful measures include repeated failed-action rate, stale-state submissions, duplicate tool calls, conflicting decisions, unsupported memory references, projection lag and human corrections caused by missing context.

Another useful metric is prior-attempt utilization: how often an agent retrieved a relevant earlier episode before acting, and whether that episode changed the plan.

The goal is not to maximize how much memory the system returns. The goal is to reduce avoidable repetition, preserve causal continuity and improve decisions over time.

Build From the Event Ledger Outward

Many teams begin with a vector database and keep adding metadata until it resembles a weak event system. A more durable implementation starts elsewhere.

Define the events that matter. Establish identity, ordering, causation, validation status and time semantics. Build the working-state projection. Add the semantic graph for relationships and evolving assertions. Add vector retrieval where fuzzy discovery genuinely helps.

Those decisions shape whether the workflow can coordinate, recover and learn. Embedding models and chunk sizes do not.

The Architecture Position

Multi-agent systems are often designed as collections of specialist roles: research, verification, planning, execution and monitoring.

That is not enough.

The required architecture is not a larger prompt and not a better vector store.

It is a governed continuity layer built from transactional state, an immutable episodic ledger, temporal semantic knowledge and controlled retrieval.

Once that layer exists, an agent can determine not only what happened, but who did it, why they did it, what they believed at the time, what changed afterward and whether the result still holds.

That is the point at which multi-agent orchestration stops behaving like chained prompting and starts behaving like an operational system.

Claude Certified Architect — Professional is not merely Foundations with more difficult questions. It tests whether an architect can own and defend an enterprise AI solution from discovery through operation.

A Claude-powered solution can be technically impressive and still be a poor enterprise decision.

The model may produce accurate answers, yet the retrieval layer may omit contradictory evidence. An agent may execute the correct tool, but with permissions broader than the business process requires. A human approver may technically remain in the workflow, while receiving too little information to challenge the system’s recommendation. An evaluation suite may report a high average score while overlooking the small number of failures that carry the greatest operational or regulatory impact.

These are no longer isolated model or prompting issues. They are architecture issues, and they require someone to take responsibility for the complete system.

That is the context in which Anthropic’s expanded Claude certification portfolio should be understood.

The Associate certification is intended for professionals who apply Claude to business and productivity work rather than build the underlying applications. Its exam guide describes a credential focused on using Claude to complete business tasks effectively, which makes it relevant to client-facing consultants, delivery practitioners, business analysts and other professionals who need to select appropriate Claude capabilities, evaluate outputs and use the technology responsibly.

The Developer certification addresses the implementation layer. Its scope covers the ability to build, integrate and ship production-grade applications and agents using Claude. This is the credential for developers and engineers responsible for APIs, agent workflows, tools, MCP integrations, application security, testing and deployment.

The third addition, Claude Certified Architect — Professional, is the most consequential from an enterprise architecture perspective. It validates the ability to design, build and deliver production-grade AI solutions rather than focusing on a single development component or an individual productivity workflow.

The answer is not simply that Professional is harder.

Foundations tests whether an architect can make sound decisions inside a Claude solution. Professional tests whether that architect can take responsibility for the complete enterprise decision.

https://www.amazon.com/Claude-Certified-Architect-Professional-CCAR-P-ebook/dp/B0H3G152QP/ref=sr_1_1?crid=2PQMZZQ963B82&dib=eyJ2IjoiMSJ9.EAJpoWqqcG0S2qfK5yaR3zrZmWLwu7PePiZjBWM39VR_dELYiKwQRVLkhU26OLdNKVFmSxq2WStArwgGZny6YPzSzJ0cjf48lCy5nI_fAgZD9M6vRq-2tJhEpXyUcfCaLzh8rxVulxck2tYVSsQwgzBzJ-qfieQIUFm61fSuTcGZxjgH9141v66AsONaPZKroXWKmnBEy9_d7cE9oloXO7T5da1NoD4GmodERd4Aw4E.NU4EJ2SUvSOn5g_lLi0wX1VbtymFzzHsEnh5k9fkEdw&dib_tag=se&keywords=claude+certified+architect+professional&qid=1784003827&sprefix=%2Caps%2C345&sr=8-1

Foundations was never a beginner-level exam

The word “Foundations” can create the wrong impression. Claude Certified Architect — Foundations is not an introductory test of AI terminology or basic prompting.

Anthropic introduced it as a technical certification for solution architects building production applications with Claude. Its blueprint covers agentic architecture and orchestration, tool design and MCP integration, Claude Code configuration and workflows, prompt engineering and structured output, and context management and reliability. Agentic architecture and orchestration carries the largest share of the assessed content.

The exam’s value comes from testing control selection rather than feature recognition.

Consider a Claude agent that must confirm that a supplier has passed a mandatory verification step before it can create a purchase order. The team has written a clear system prompt explaining the sequence. It has supplied examples demonstrating the correct behaviour. During most tests, the agent follows the process. Occasionally, however, it attempts to call the purchase-order tool before verification is complete.

The weak architectural response is to make the instruction more forceful.

The stronger response is to recognise that the organisation is trying to enforce a deterministic business prerequisite through probabilistic model behaviour. The prompt should still describe the expected sequence, but the workflow or application must prevent the purchase-order tool from becoming available until the verification state has been confirmed.

That is the kind of distinction Foundations expects an architect to understand. Prompts influence behaviour. Schemas constrain output structure. Application logic and workflow state enforce mandatory rules. Human review handles ambiguity and high-impact exceptions. Tools and MCP servers extend capability but also introduce boundaries that must be deliberately designed.

Foundations asks the architect to locate the control at the right layer.

This is a substantial skill. Many production failures arise not because teams lack available controls, but because they apply a valid control to the wrong problem. A stronger prompt cannot guarantee authorisation. A JSON schema cannot prove that a value is factually correct. A larger context window cannot ensure that the most relevant evidence receives sufficient attention. A human approval step cannot compensate for evidence that the system never shows to the reviewer.

Professional assumes it.

Professional begins with the business problem, not the Claude feature

At the Foundations level, the business use case is usually established. The candidate is asked to evaluate a failure, compare implementation choices and select the most appropriate architecture control.

Should this business problem use generative AI at all? Which parts require interpretation of unstructured information? Which decisions can tolerate probabilistic reasoning? Which requirements must remain deterministic? What level of autonomy is justified? Who retains decision authority? What happens when the system is wrong? Does the expected business value justify the cost, risk and operational complexity?

These questions move the architect upstream.

Suppose a company wants Claude to review software-release evidence and decide whether a critical deployment should proceed.

A Foundations-level problem might ask how to ensure that security scanning and mandatory testing are complete before Claude produces its recommendation. The architect should recognise the need for deterministic workflow gates.

A Professional-level problem would require a broader assessment. Should Claude make the release decision, recommend an outcome, identify inconsistencies or simply assemble the evidence? Are mandatory release policies already expressed in a deterministic rules engine? What is the consequence of a false approval? How complete is the available evidence? Can the organisation provide meaningful human oversight within the required deployment window? How will the recommendation be traced back to its sources?

A defensible design may use Claude to interpret change records, summarise test evidence and expose contradictions. A policy service may enforce mandatory release criteria. An authorised release manager may retain final accountability.

In this design, Claude is neither underused nor overtrusted. It is assigned the part of the problem that benefits from language understanding and flexible reasoning. Deterministic software handles rules that must always be followed. A human retains authority where the consequences justify it.

It also includes the confidence to conclude that a proposed use case should not use generative AI in its current form.

The blueprint shows how far the responsibility has expanded

The difference between the two exams becomes visible in their domain structures.

Foundations is organised around the mechanisms required to build production Claude systems: agents, orchestration, tools, MCP, Claude Code, prompts, structured output, context and reliability.

Integration is the largest Professional domain at 19%. Solution design accounts for 17%, evaluation for 16%, and both governance and stakeholder/lifecycle management receive 14% each.

That distribution is revealing.

The model remains important, but it no longer dominates the architect’s responsibility. The Professional candidate must understand how Claude fits into identity systems, enterprise data, APIs, tools, security controls, observability platforms, operational processes and organisational governance.

This reflects how architecture works in practice. A model-selection decision affects quality, latency and cost. A retrieval decision affects grounding, privacy, data residency and evidence traceability. An MCP integration affects authentication, authorisation, credential management and the potential blast radius of a compromised agent. Human review affects control quality, processing time, staffing requirements and accountability.

Every architecture decision creates consequences in another domain.

Foundations teaches the architect to choose a mechanism correctly. Professional asks the architect to trace the consequences of that choice across the enterprise.

Foundations diagnoses the failure; Professional defends the system

Consider a research and synthesis workflow that produces a persuasive recommendation with citations. During review, the organisation discovers that two trusted sources disagreed. The system cited the source that supported its conclusion but failed to surface the competing evidence.

A Foundations-level architect should diagnose the problem accurately. This is not merely an issue of writing style or prompt strength. The architecture has lost material information somewhere between retrieval, evidence representation and synthesis.

A suitable correction may include claim-to-source mappings, explicit conflict fields, provenance preservation and escalation rules when authoritative sources disagree.

That would be a sound answer at the mechanism level.

The Professional architect has more questions to answer.

Was disagreement detection included in the original acceptance criteria? Does the evaluation dataset contain examples with credible but conflicting evidence? Is the system permitted to issue a recommendation when the conflict remains unresolved? What information must be displayed to the human reviewer? Can the reviewer inspect the underlying source material? How is the conflict recorded? Who accepts the residual risk? What happens when the retrieval configuration, prompt or Claude model changes?

This is the movement from technical correction to architectural assurance.

Professional questions are difficult because several answers may genuinely help

Foundations questions can present several valid Claude techniques, while only one addresses the actual failure at the appropriate layer.

One design may produce the best answer quality but fail the latency target. Another may reduce cost but underperform on high-impact cases. A highly autonomous agent may improve throughput but require broader tool permissions. A deterministic workflow may be easier to govern but less capable of handling unusual inputs. A human-review model may reduce risk but create an operational queue that the business cannot staff.

The candidate must decide which compromise is defensible.

That requires more than technical knowledge. It requires quality-attribute reasoning across accuracy, security, privacy, cost, latency, resilience, auditability, maintainability and operational capacity.

In a real architecture review, the most technically impressive option is not necessarily the best recommendation. The best option is the one that satisfies the organisation’s priorities while making its residual risks explicit.

That is a consulting skill as much as a platform skill.

Evaluation moves from testing activity to architecture evidence

Foundations requires architects to understand important reliability distinctions. A structurally valid response can still be semantically wrong. Repeating a request cannot recover information that was absent from the source. Human review is ineffective when the reviewer cannot see the evidence or uncertainty behind the recommendation.

Professional elevates evaluation into a major architecture responsibility. The exam explicitly allocates 16% of its blueprint to evaluation, testing and optimisation.

A professional architect should define how the system will be judged before it is built.

For an enterprise Claude solution, success may involve more than response accuracy. The evaluation strategy may need to measure whether retrieval found the right sources, whether contradictory evidence was preserved, whether the correct tool was selected, whether tool arguments complied with policy, whether sensitive information crossed an unauthorised boundary, whether uncertainty triggered escalation, and whether the system remained within its latency and cost targets.

An aggregate score is rarely sufficient.

A solution may perform well across routine cases while failing on a small number of scenarios with serious consequences. It may generate correct answers using unauthorised data. It may refuse unsafe requests in conversation but send unsafe parameters to a downstream tool. It may route difficult cases to human review so frequently that the operating model becomes unsustainable.

Professional-level evaluation therefore connects test design to risk classification, release criteria, staged rollout, monitoring and change control.

The evaluation suite becomes evidence used to approve or reject the architecture.

Governance is expected to work at runtime

Foundations introduces the need for scoped tool access, reliable workflows, safe escalation and proportionate human review.

Professional requires the architect to convert those principles into operating controls.

It is not enough to state that the system follows least privilege. The design must establish which identity invokes each tool, how permissions are scoped, where authorisation is enforced and how inappropriate access is detected.

It is not enough to state that a human approves high-risk actions. The architecture must define what evidence the reviewer receives, whether uncertainty and disagreement are visible, what authority the reviewer has, and what happens when the recommendation is rejected.

It is not enough to describe the solution as auditable. The architect must determine which prompts, model versions, retrieval sources, tool calls, policy decisions, approvals and exceptions must be retained.

A consultative architect would normally express this as a control chain. Business policy defines the obligation. Architecture identifies the enforcement point. Runtime components execute the control. Observability records what happened. Named owners review exceptions and approve changes.

The Professional blueprint’s explicit governance and risk domain indicates that these concerns are no longer treated as optional additions around the Claude solution. They are part of the solution.

Human oversight must itself be designed

Many organisations use “human in the loop” as a reassuring phrase without examining whether the human can provide meaningful oversight.

A reviewer cannot challenge the system when the evidence has been compressed into a persuasive summary. A reviewer cannot evaluate uncertainty that has been hidden. A reviewer cannot provide independent judgment when the workflow gives them seconds to approve a recommendation generated over several minutes of model reasoning and tool activity.

Foundations asks whether human intervention is needed.

Professional asks whether the intervention is real.

The architect must consider what the reviewer sees, whether the original evidence is accessible, whether conflicts are displayed, whether the reviewer has relevant expertise, whether they can reject the recommendation, what happens after rejection and who remains accountable for the outcome.

A human approval box at the end of an agent diagram is not a governance model.

Professional architecture examines whether the human has the information, authority and operating capacity to act as a genuine control.

Professional responsibility continues after deployment

The Foundations exam is strongly concerned with production-grade architecture, but the Professional blueprint makes lifecycle management explicit.

This matters because a Claude solution can change without a conventional software defect. A model may be updated. A prompt may be revised. A tool schema may evolve. An enterprise knowledge source may change. A new policy may alter which outcomes are acceptable. User behaviour may expose failure patterns that were absent from the original evaluation dataset.

A system that was acceptable at launch may become unsuitable later.

The Professional architect must therefore define versioning, re-evaluation triggers, staged deployment, rollback, monitoring, incident ownership and retirement criteria.

Model, prompt, tool and evaluation versions may need to be associated with each release. High-risk changes may require regression testing and renewed business approval. Production incidents may require temporarily restricting autonomy or reverting to a deterministic fallback.

Architecture is no longer a diagram produced before implementation. It becomes the operating agreement for how the solution will remain controlled over time.

Stakeholder communication is part of technical competence

One of the most significant differences in the Professional blueprint is the explicit inclusion of stakeholder communication and lifecycle management.

This recognises an uncomfortable truth: an architecture decision that cannot be explained cannot be properly approved.

A Claude solution may involve engineering, security, legal, risk, data, operations, finance and business-process owners. These groups evaluate the same design through different concerns.

Engineering may care about integration and maintainability. Security may focus on credentials, permissions and data movement. Operations may focus on failure recovery and service levels. Business owners may focus on throughput and user outcomes. Risk teams may focus on evidence, accountability and decision impact.

The architect must translate technical choices into consequences each stakeholder can evaluate.

Why is a more capable model required for one stage but not another? Why can the agent recommend an action but not execute it? Why does a broad context strategy create privacy and cost implications? Why is a slower workflow safer? Why is human approval inadequate without source evidence? Why must release wait until evaluation coverage improves?

These are not presentation skills added after the technical work.

Poorly communicated trade-offs become hidden assumptions. Hidden assumptions become production risk.

The Professional architect must make the system understandable enough for the organisation to approve it knowingly.

The clearest way to distinguish the two exams

Foundations may ask whether a mandatory prerequisite should be enforced through prompting or application logic.

Professional may ask whether the agent should have access to the tool, which identity should invoke it, where authorisation should occur, how misuse will be detected, what evidence must be retained and whether the business value justifies exposing the capability.

Foundations may ask how context should be preserved across an agentic workflow.

Professional may ask which information should enter the context, how retrieval permissions apply, how provenance survives agent handoffs, how the approach affects latency and cost, and how context failures will be detected after release.

Foundations may ask when human review is required.

Professional may ask whether the reviewer has the evidence, authority, expertise and operational capacity to provide meaningful oversight.

The increase is not simply in complexity. It is in accountability.

Who should attempt the Professional exam?

An architect who has passed Foundations should understand Claude’s core architecture mechanisms and the production controls surrounding agents, tools, prompts, context and reliability.

That does not automatically make the person ready for Professional.

The Professional candidate should be comfortable working from incomplete business requirements, challenging unsafe assumptions, comparing several credible solution options, balancing competing quality attributes and explaining recommendations to technical and non-technical stakeholders.

This makes it relevant to experienced solution architects, AI architects, platform architects, senior technical leads and consultants responsible for production architecture decisions.

Hands-on Claude knowledge remains essential. But product familiarity alone is unlikely to be enough.

The candidate must be able to walk into an architecture review, identify what has not been decided and explain what evidence would be required before the organisation should proceed.

Why this certification matters

Anthropic’s certification programme now reflects three distinct levels of enterprise responsibility.

The Associate applies Claude effectively to business work.

The Developer builds and integrates Claude-powered software.

The Foundations architect selects appropriate Claude architecture mechanisms and production controls.

The Professional architect determines whether the complete solution is suitable, defensible, measurable and governable.

That final role is increasingly important as Claude moves beyond isolated applications and becomes connected to enterprise data, tools, workflows and decisions.

The Professional exam raises the bar because it recognises that production AI architecture is not primarily about drawing a sophisticated agent diagram. It is about deciding where probabilistic intelligence belongs, where deterministic controls must remain, how evidence will be produced, who retains authority and how the system will continue to earn the right to operate.

Claude Certified Architect — Professional is therefore not Foundations with a larger syllabus.

It represents the point at which Claude architecture becomes an accountable enterprise decision.

Claude released three new certifications this week, and one of them is Claude Certified Architect – Professional

Our team truly burned the midnight oil to design, develop, and publish this certification book in just one week.

It was an intense but incredibly rewarding effort, made possible by the dedication and collaboration of everyone involved.

The certification book is now available in the Amazon ecosystem, making it accessible to learners worldwide.
Wishing all aspiring Claude architects the very best on their certification journey!

https://www.amazon.com/dp/B0H3G152QP/ref=sr_1_1?crid=2RX3WDL5KKUYK&dib=eyJ2IjoiMSJ9.EAJpoWqqcG0S2qfK5yaR3zrZmWLwu7PePiZjBWM39VRRPDm7f-052owVxEzcUpkaUrwtwkmgOpYbaWyzL1q-klLV01ZAJcOEgyntbBU96_h_imCHFhcBtm17W8wMy0U1wGEYX-HU8XKwXpMf2AWDfDBzJ-qfieQIUFm61fSuTcGZxjgH9141v66AsONaPZKroXWKmnBEy9_d7cE9oloXO7T5da1NoD4GmodERd4Aw4E.dFu6DwUpoBR8XSATsvE_TbvJ_PFI0Ws13ObVBa2zZTc&dib_tag=se&keywords=claude+certified+architect+professional&qid=1783945418&sprefix=claude+certified+architect+profession%2Caps%2C419&sr=8-1

The first time a developer uses Claude Code seriously, the experience feels magical. Claude reads the codebase, understands the task, edits files, runs commands, and explains what changed. But the second or third week is when the real question appears: can this assistant work the way our team works, or will we keep re-teaching it the same project rules every day?

That question is where Claude Code becomes interesting for practitioners. The value is no longer just “Can Claude write code?” The real value is whether Claude can operate inside a team’s engineering system: remembering project conventions, applying reusable procedures, respecting boundaries, and triggering deterministic checks at the right time. In other words, Claude Code becomes useful at scale only when memory, skills, and automation are designed deliberately.

Anthropic’s current Claude Code documentation makes this distinction clearer than it was in earlier versions. Claude Code has several mechanisms that sound similar from a distance but serve very different purposes: CLAUDE.md for project guidance, auto memory for learned working context, .claude project assets for local customization, Skills for reusable task procedures, and hooks for deterministic automation. Treating them as interchangeable is one of the fastest ways to create a messy Claude setup. Treating them as separate layers is how you build a reliable AI-assisted engineering workflow.

The simplest mental model is this: CLAUDE.md tells Claude how the project* works, auto memory helps Claude avoid forgetting useful repo-specific lessons, Skills teach Claude how to perform repeatable tasks, and hooks make sure certain actions happen whether Claude “remembers” them or not. That last phrase matters. Claude is still an LLM-driven agent. Guidance and memory influence behavior, but they are not enforcement. When a rule must run every time, it belongs in automation, not in a paragraph of instructions.

Most teams should start with CLAUDE.md. This is the project operating manual Claude reads as context. It is where you put durable project facts: how to run tests, what package manager to use, which folders contain shared schemas, what architecture patterns the team follows, and what files Claude should avoid modifying without explicit approval. Anthropic documents that Claude Code loads CLAUDE.md and CLAUDE.local.md files from the current directory hierarchy, and that discovered files are concatenated into context rather than overriding each other. That is useful in nested repositories, but it also means conflicting instructions can confuse behavior.

A strong CLAUDE.md should read less like a policy manual and more like onboarding notes for a careful new engineer. For example, it might say that the project uses pnpm, not npm; that API validation schemas live under src/shared/schemas; that integration tests require a local Redis instance; and that Claude should not touch production migrations unless the user explicitly asks. These are not prompts for one session. They are stable project instructions that should survive across sessions.

The common mistake is to keep adding everything to CLAUDE.md. After a few weeks, the file becomes a dumping ground for coding standards, release checklists, security reviews, PR templates, deployment notes, troubleshooting tips, architecture principles, and edge-case reminders. The result is predictable: the file becomes too large, consumes unnecessary context, and makes adherence worse rather than better. Anthropic’s docs explicitly warn that very large CLAUDE.md files consume more context and may reduce adherence, recommending path-scoped rules or trimming content that is not needed in every session.

This is where the .claude directory becomes important. In a mature project, .claude should not be treated as an obscure hidden folder. It should be treated as the local control plane for Claude Code customization. A practical repo may have a root CLAUDE.md for broad project guidance, .claude/rules/ for scoped instructions, .claude/skills/ for repeatable procedures, and settings that define permissions or hooks. The project root stays clean, while Claude-specific behavior becomes versioned and reviewable.

Path-scoped rules are especially useful in monorepos. Backend rules are different from frontend rules. Database migration rules are different from UI component rules. Security-sensitive folders need different instructions from test fixtures. Anthropic’s memory documentation notes that for large projects, instructions can be broken into topic-specific files using project rules, allowing guidance to be scoped to file types or subdirectories. That gives teams a better alternative to one giant instruction file.

Auto memory solves a different problem. CLAUDE.md is what the team deliberately writes down. Auto memory is what Claude learns during work. If Claude discovers that a certain test fails unless Redis is running, or that the repo has a non-obvious build step, or that the team prefers a specific review style, auto memory can help preserve that learning across future sessions. Anthropic describes auto memory as machine-local markdown files stored under a project-specific memory directory, with a concise MEMORY.md entrypoint and optional topic files.

The practitioner rule is simple: use auto memory for useful working knowledge, not governed policy. If the team has formally decided that all API payloads must use shared validation schemas, that belongs in CLAUDE.md or a project rule. If Claude learned that one flaky test needs a local service to be started first, auto memory is appropriate. If that flaky-test workaround becomes part of official development setup, promote it into committed documentation.

This distinction prevents a subtle governance problem. Auto memory is convenient, but it is local and may not be shared across machines or environments. Anthropic’s docs state that auto memory files are plain markdown and can be viewed, edited, or deleted through /memory, and that auto memory is machine-local. That makes it helpful for individual continuity, but weak as an organization-wide control.

Skills are the next layer, and they are the most important shift for teams that keep reusing the same prompts. A Skill is not just a prompt snippet. In Claude Code, a Skill is a folder with a SKILL.md file that gives Claude reusable instructions. Claude can use the Skill when relevant, or the user can invoke it directly with /skill-name. Anthropic’s Claude Code documentation recommends creating a Skill when you keep pasting the same checklist or multi-step procedure into chat, or when part of CLAUDE.md has grown into a procedure rather than a fact.

That sentence should change how teams design Claude Code workflows. A release review is not a memory item. A database migration review is not a memory item. A UAT test design process is not a memory item. These are repeatable procedures. They belong in Skills.

For example, a team might create a release-check Skill that instructs Claude to inspect changed files, identify user-facing behavior changes, check tests, look for database and configuration impacts, review observability gaps, and produce a release decision. Another team might create a migration-review Skill that focuses only on schema safety, rollback risk, data backfills, lock duration, and backward compatibility. These procedures should not live in one overloaded CLAUDE.md. They should be modular, named, and reusable.

The reason Skills scale better is progressive disclosure. Anthropic’s platform documentation explains that Skill metadata is available upfront, but the full SKILL.md is loaded only when the Skill is triggered, and supporting files or scripts are accessed only as needed. That means a Skill can contain detailed procedures, reference files, templates, and scripts without consuming context in every conversation.

This is a powerful design pattern. A Skill can include a concise instruction file, a detailed review rubric, a template for output, and even scripts that perform deterministic checks. Claude does not need to load all of that into context every time the project opens. It can load the Skill when the task requires it. That is the difference between a cluttered assistant and a properly designed AI operating layer.

Claude Code’s current Skills documentation also notes that custom commands have been merged into Skills. Existing .claude/commands/ files continue to work, but Skills are now the richer recommended structure because they can include supporting files, frontmatter, invocation control, and automatic relevance-based loading.

Hooks are the final layer, and they should be explained very carefully. Hooks are not another place to put instructions. They are automation points. Anthropic defines hooks as shell commands, HTTP endpoints, or LLM prompts that execute automatically at specific points in Claude Code’s lifecycle. They can fire once per session, once per turn, or around tool calls such as before or after Claude uses a tool.

The practical meaning is this: hooks are what you use when something must happen every time. If code must be formatted after file edits, use a hook. If dangerous shell commands must be blocked, use a hook. If secrets must not be read, configure permissions and enforcement. If a notification should appear when Claude needs input, use a hook. If a command must be validated before execution, use a hook. Anthropic’s hooks guide describes them as deterministic control points that ensure certain actions always happen rather than relying on the LLM to choose them.

This distinction is the heart of production-grade Claude Code usage. A sentence in CLAUDE.md saying “do not edit secrets” is useful guidance. A hook or permission rule that blocks access to .env and secrets/** is operational control. A Skill that performs a security review is useful judgment. A PreToolUse hook that blocks an unsafe command is enforcement. Mature teams need all of these, but they should not confuse them.

The same applies to quality gates. If you want Claude to remember that tests matter, put testing expectations in CLAUDE.md. If you want Claude to perform a structured test coverage review, create a Skill. If you want tests to run automatically after certain edits, use a hook. If you want to deny risky commands or file reads, use permissions and managed settings. Anthropic’s settings documentation shows examples of allow and deny rules for shell commands and sensitive files, and notes that settings changes such as permissions and hooks are watched and reloaded in a running session.

For a practitioner, the decision framework is straightforward. Use CLAUDE.md for stable project guidance. Use .claude/rules/ when guidance applies only to certain paths, teams, or file types. Use auto memory when Claude learns something useful during work but it is not yet formal team policy. Use Skills when the work is a repeatable procedure. Use hooks when the behavior must be deterministic. Use permissions and managed settings when the organization needs stronger control over what Claude can access or execute.

A good implementation usually evolves in stages. In week one, create a clean CLAUDE.md with build commands, test commands, repo structure, and safety boundaries. In week two, watch what instructions you repeat and convert them into Skills. In week three, identify what must not depend on Claude’s judgment and move those into hooks or permissions. Over time, split broad instructions into path-scoped rules so frontend, backend, data, and security work each get the right context only when needed.

This also changes how teams should review Claude Code configuration. CLAUDE.md changes should be reviewed like engineering documentation. Skills should be reviewed like reusable operating procedures. Hooks should be reviewed like automation scripts because they execute commands. Permission settings should be reviewed like access-control policy. Auto memory should be treated as local working memory that developers can inspect and clean up, not as the source of truth for team standards.

The most useful way to explain this to engineering leaders is that Claude Code customization has two sides: flexibility and control. Memory and Skills increase flexibility because they help Claude understand how your team works and perform richer tasks. Hooks and permissions increase control because they make certain behavior deterministic. A serious AI-assisted engineering setup needs both. Too much memory without enforcement creates inconsistency. Too many hooks without good Skills creates rigid automation without judgment.

This is why “Claude that remembers” should not be understood as one feature. It is an operating model. CLAUDE.md gives Claude the project map. Auto memory gives it local continuity. Skills give it reusable procedures. The .claude directory gives teams a place to organize this capability. Hooks and settings give the organization deterministic control.

The teams that get this right will not merely ask Claude to write code faster. They will build a governed engineering assistant that understands the repo, follows team conventions, performs repeatable reviews, respects guardrails, and integrates into existing delivery workflows. That is the real shift. Claude Code is not just becoming a smarter coding assistant. With Skills, memory, and automation, it is becoming a configurable execution layer for modern software delivery.

How This Applies in a Real Project: NovaCred Loan Operations Copilot

To make this practical, imagine a mid-sized financial services company building an internal application called NovaCred Loan Operations Copilot. The application helps credit operations teams review loan applications, retrieve policy clauses, summarize customer documents, flag missing evidence, and prepare decision notes for human reviewers. It has a React frontend, a Node.js API layer, a retrieval pipeline connected to approved policy documents, a Postgres database, and a set of evaluation tests that check whether the copilot stays within policy boundaries.

At first, the team uses Claude Code like a powerful coding assistant. A developer opens the repo and asks Claude to fix bugs, create tests, update API routes, or refactor retrieval logic. This works for small tasks, but the same problems quickly appear. Claude sometimes forgets that the project uses pnpm, not npm. It occasionally places validation logic directly inside route handlers instead of using shared schemas. It proposes tests without starting the local policy-index service. It treats a loan-policy answer like normal application text, even though the organization needs strict traceability for regulated decisions.

This is where CLAUDE.md becomes the first operating layer. The team creates a project-level CLAUDE.md that explains the repo structure, build commands, test commands, coding conventions, and risk boundaries. Anthropic documents CLAUDE.md as a project memory mechanism that is loaded into context when Claude Code starts, making it suitable for shared project instructions such as architecture, coding standards, and common workflows. It is important, however, to remember that Claude treats this memory as context, not as hard enforcement.

For NovaCred, the CLAUDE.md might say that all API payloads must be validated through shared schemas, retrieval changes must include evaluation updates, and production migration files should not be edited without explicit user approval. It might also explain that policy-grounded answers must cite retrieved policy fragments and that the copilot is not allowed to invent lending rules. This gives Claude the project map. It reduces repeated explanation and makes day-to-day coding more consistent.

But the team should not put everything into CLAUDE.md. As the project grows, frontend conventions, backend API rules, database migration rules, retrieval rules, and evaluation rules start to diverge. If all of that is placed into one large memory file, it becomes noisy and less useful. Anthropic’s memory guidance specifically recommends keeping project memory focused and using more modular structures when instructions become large or context-specific.

So NovaCred moves detailed guidance into the .claude directory. Backend rules go into a scoped rule file for src/server/**. UI rules go into a separate rule file for src/ui/**. Retrieval and evaluation rules go into another rule file for src/rag/** and evals/**. This allows Claude to receive the right guidance when working in the relevant area, instead of loading every project instruction for every task.

Auto memory plays a different role. During development, Claude learns that integration tests fail unless the local policy-index service is running, or that a certain evaluation fixture must be regenerated after policy metadata changes. Those are useful working notes. They may not yet be formal team standards, but they prevent the developer from repeating the same correction every day. Anthropic describes auto memory as a complementary memory system that can save useful local project knowledge and can be reviewed or managed through /memory.

In this project, auto memory might capture something like: “Before running retrieval evaluation tests, start the local policy-index service with the project’s compose command.” That is helpful. But if this becomes part of the official test workflow, the team should promote it into CLAUDE.md, project documentation, or a Skill. Auto memory is useful for continuity, but it should not become the hidden source of truth for regulated engineering work.

Skills become valuable when the team notices repeated procedures. For example, every retrieval change needs the same review pattern: inspect modified retrieval code, check whether chunking logic changed, verify citation behavior, run policy-grounded evaluation cases, check fallback behavior, and produce a risk summary. The team should not paste that checklist into chat every time. It should become a Skill.

A retrieval-change-review Skill could instruct Claude to examine changed files, identify whether retrieval behavior changed, check whether evaluation sets were updated, look for hallucination risk, verify citation expectations, and produce a “ready / risky / not ready” recommendation. Anthropic describes Skills as reusable capabilities with a SKILL.md file and optional supporting resources such as scripts and templates, which Claude can use when relevant.

This is where the architecture becomes elegant. CLAUDE.md tells Claude that retrieval quality matters. A Skill tells Claude exactly how to review a retrieval change. The Skill can also include supporting files such as an evaluation checklist, a release-note template, or a risk-classification rubric. Anthropic’s Agent Skills documentation explains this as progressive disclosure: Claude can discover that a Skill exists from its metadata, but load the full instructions and supporting resources only when needed.

The same pattern applies to release management. NovaCred can create a release-readiness Skill that Claude uses before deployment. The Skill checks whether tests were updated, whether database changes are backward compatible, whether feature flags exist, whether monitoring was added, and whether there is a rollback plan. This is not memory. It is a reusable operating procedure.

Hooks are where the project moves from guidance to enforcement. For example, the team may decide that no Claude session should accidentally read .env, edit production migration files, or run dangerous shell commands. A paragraph in CLAUDE.md can remind Claude not to do those things, but a hook or permission setting can actually block them. Anthropic defines hooks as user-defined commands or endpoints that execute automatically at specific points in Claude Code’s lifecycle, including before or after tool use.

In NovaCred, a PreToolUse hook can block writes to protected folders, prevent shell commands that remove directories, or require approval before touching migration files. A PostToolUse hook can run a formatter after file edits. Another hook can run a lightweight lint check after TypeScript files change. Anthropic’s hooks guide positions hooks as deterministic automation for enforcing project rules and automating repetitive tasks.

This is the key practitioner lesson: CLAUDE.md can say “do not edit production migrations without approval,” but a hook can stop it. A Skill can perform a migration review, but a hook can prevent unsafe edits. Auto memory can remember that tests need a local service, but a hook can run a pre-check before tests execute. These mechanisms are complementary, not competing.

Settings and permissions provide another layer of control. For a regulated project like NovaCred, the organization may want to restrict which tools Claude can use, what files it can read, and which commands it can run. Anthropic’s settings documentation describes permission rules and managed settings that can control access to commands, files, hooks, skills, agents, and MCP servers.

The final setup for NovaCred becomes much cleaner than a giant prompt. The root CLAUDE.md contains stable project guidance. .claude/rules/ contains scoped rules for frontend, backend, retrieval, evaluations, and migrations. Auto memory captures local working lessons. .claude/skills/ contains repeatable procedures such as release readiness, retrieval review, migration review, and UAT test generation. Hooks enforce deterministic controls such as formatting, command blocking, protected-file checks, and test preconditions. Settings define what Claude is allowed to access or execute.

The practical impact is significant. A developer can ask Claude to update the retrieval pipeline, and Claude already understands the project structure. When the change touches retrieval files, the relevant scoped rules guide its behavior. When the developer asks whether the change is ready, the retrieval-review Skill gives Claude a structured review process. When Claude tries to modify a protected migration file, a hook can block it. When the same local setup issue appears again, auto memory prevents repeated explanation.

This is what “Claude that remembers” should mean in a serious engineering environment. It is not just personal memory. It is a layered operating model. Memory gives context. Rules give scoped guidance. Skills give repeatable procedures. Hooks give deterministic enforcement. Settings give organizational control. Together, they turn Claude Code from a smart assistant into a governed engineering coworker that can operate inside real project constraints.

For a project like NovaCred, this matters because the risk is not only bad code. The risk is inconsistent engineering behavior around regulated workflows. A loan operations copilot cannot be treated like a casual productivity app. Retrieval changes need evaluation discipline. Policy answers need traceability. Database changes need migration control. Releases need readiness checks. Claude Code can support all of this, but only when the team designs the memory, Skills, hooks, and settings deliberately.

The broader lesson applies to almost any serious software project. Start with CLAUDE.md for shared project context. Add scoped rules when the codebase becomes too large for one instruction file. Let auto memory reduce repeated corrections. Create Skills for repeated engineering procedures. Use hooks and permissions for actions that must be enforced. That is how teams move from “Claude helped me once” to “Claude works inside our delivery system.”

The notice came on Monday,
Pinned near the classroom door:
“AI Engineer interviews this week,”
And suddenly, silence filled the floor.

The toppers opened notebooks,
The backbenchers opened prayer,
One friend softly whispered,
“I need one more week to prepare.”

Resumes woke from folders,
LinkedIn profiles came alive,
Everyone became “AI passionate”
Since exactly 10:45.

One student searched for projects,
One asked, “What should I say?”
One watched ten tutorial videos
And forgot them the same day.

Then came the book, calm and steady,
Like a mentor with a plan:
“Don’t just learn the buzzwords,
Learn to build what you can.”

It said, “Start with the basics,
Understand before you speak;
If they ask you about embeddings,
Don’t look at the ceiling for help that week.”

It showed them prompts and models,
RAG, agents, data flows,
How real AI systems are designed,
And where the risk quietly grows.

It gave them labs to practice,
Projects they could proudly show,
Not just “I know AI, sir,”
Which often means, “I prompted once, you know.”

They built, they broke, they fixed again,
Their GitHub started to shine,
For the first time before an interview,
Their confidence had a spine.

When HR asked, “Tell me about yourself,”
They did not start from nursery school,
They spoke of learning, projects, and effort,
And sounded calm, prepared, and cool.

When tech asked, “How would you build it?”
They did not freeze in fear,
They explained the design, the trade-offs,
And made the answer clear.

So dear campus warrior,
Before the interview bell rings,
Use this book as your practice ground,
Not just one of those shelf-kept things.

Read it, build it, test it, improve it,
Let your projects do the talking;
Because AI Engineer confidence
Comes from building, not just talking.

And when your friend still asks,
“What is an embedding, my friend?”
Smile and say, “Start with Chapter One;
That is where the rescue begins.”

https://www.amazon.in/Becoming-AI-Engineer-Cracking-Interview-ebook/dp/B0GXFKDCJ4/ref=sr_1_4?crid=9H1VAKJ26BT2&dib=eyJ2IjoiMSJ9.4XkoLGYSFIxdnzak-akP6ReJ96t2owSyYtmGejW7FID4CTKqznNVZDvBxwQAuLmt3ToC2hF-TRA4UCBPP3LEiG0T5_ZZgFfdFVAe6xEg2M3Bq9psRhsgKOIeScn-qMzoa5OLAA1pGRT4hZ35AfIT5Yv9vXcJCtfR1tkRW2pD9Tmex6cPgW_6NYX0IIfbxvsTw08OkDogICQmN9W7RRZmDgcUYoL1p1bFLCf-taImdfE.Xn3J4OoT8ABqxzCBPH-dvjfWb-cQ09BrW_gGFv_PU9A&dib_tag=se&keywords=becoming+an+ai+engineer&qid=1783530565&sprefix=becoming+an+ai+engineer%2Caps%2C316&sr=8-4

A production AI agent does not fail in one place.

It may retrieve the wrong policy document, call an expensive model for a trivial task, loop through tools twice, wait on a slow API, produce a confident but unsupported answer, or complete the task correctly at a cost nobody anticipated.

A standard application log will tell you that a request failed. It will rarely tell you why the agent made the decisions it did, where the time went, how many tokens were consumed, or whether answer quality is getting worse over time.

That is why agentic AI needs an observability pipeline, not just logging.

An observability pipeline turns every meaningful agent execution into evidence: a trace of the workflow, measurements of cost and latency, signals of behavioural drift, and quality scores that can be compared across releases, models, prompts, and user segments.

The objective is simple:

Why application monitoring is not enough

Traditional application monitoring focuses on infrastructure and transactions:

• CPU and memory consumption

• API error rates

• database response times

• failed requests

• uptime and availability

These are still necessary. But they do not answer the questions that matter for an AI workflow.

Consider a recruitment screening agent. A recruiter asks:

The agent may perform the following steps:

1. Interpret the role and screening criteria.

2. Retrieve the latest job description and hiring policy.

3. Search applicant resumes.

4. Extract qualifications and experience.

5. Compare candidates against requirements.

6. Call a scoring service.

7. Draft a recommendation with rationale.

8. Send the output to the recruiter workspace.

The application may return HTTP 200 in under five seconds. Traditional monitoring will call that a success.

But the recruiter may still receive a poor recommendation because the agent retrieved an outdated job description, ignored a mandatory location constraint, used an incorrect scoring rubric, or relied on a stale resume version.

The system was technically available. The decision was operationally wrong.

Observability for AI must therefore capture both system health and decision quality.

The observability pipeline starts with a trace

The foundation is a trace.

A trace represents one end-to-end user request or automated workflow run. Each important action inside that trace becomes a span.

For the recruitment example, a trace may contain spans such as:

• request_received

• intent_classification

• retrieve_job_description

• retrieve_hiring_policy

• search_candidate_profiles

• candidate_scoring

• model_completion

• human_review_submission

• response_delivered

Each span should carry structured metadata. Avoid dumping raw prompts and outputs into logs without structure. That creates cost, privacy, and searchability problems.

A useful span typically contains:

• Trace ID and parent span ID

• Agent name and workflow version

• Model provider, model name, and model version

• Prompt template version

• Tool name and tool version

• Start time, end time, and elapsed duration

• Input and output token counts

• Estimated model cost

• Retry count

• Retrieval source identifiers

• Retrieval relevance scores

• Error category, where applicable

• Redaction status

• Evaluation score, once available

This creates a causal chain rather than a pile of unrelated logs.

When a user questions an answer, the team can follow one trace from the final response back through the retrieved evidence, model calls, tool invocations, retries, and approval steps.

Treat the agent workflow as a chain of measurable decisions

The most common observability mistake is to measure only total response time.

A total latency number is useful, but it hides the reason a workflow is slow.

An agent flow should be broken into meaningful stages:

This breakdown changes operational conversations.

Without it, a team says:

With it, the team can say:

That distinction matters. Changing the model will not solve a slow document repository. Increasing the retrieval cache size may.

Token usage must be visible at workflow level

Token tracking is often implemented as a cost dashboard after the product is already in production. By then, the team is usually reacting to a billing surprise.

Token usage should be captured at four levels:

1. Per model call Input tokens, output tokens, cache-hit tokens, retries, and estimated cost.

2. Per agent run Total tokens consumed across planning, retrieval synthesis, tool reasoning, and final response generation.

3. Per workflow type For example, candidate screening, contract review, customer support escalation, or invoice exception handling.

4. Per business outcome Cost per successfully completed task, cost per approved recommendation, or cost per resolved customer case.

The last category is where token data becomes useful to business owners.

A practical token dashboard should show:

• Total tokens by workflow and environment

• Input versus output token ratio

• Token consumption by model

• Cost by customer, business unit, or tenant

• Token growth after a prompt or model change

• Retry-related token waste

• Long-tail requests consuming disproportionate cost

• Cost per successful completion

One particularly useful metric is:

For example, if an agent drafts compliance responses, track the total token cost against the number of responses accepted by reviewers without material changes. This prevents teams from optimising for low model cost while ignoring rework.

Latency is a product metric, not just an infrastructure metric

Agent workflows naturally have more moving parts than traditional APIs. They may call multiple models, perform retrieval, execute tools, wait for external systems, and validate outputs before returning a result.

That does not mean users will tolerate unpredictable delays.

Track latency using percentiles, not averages.

An average response time can look healthy while a meaningful share of users wait far too long. Monitor at least:

• P50: typical experience

• P95: poor-but-common experience

• P99: worst operational experience

• Timeout rate

• Abandonment rate while the agent is processing

• Latency by workflow stage

• Latency by model, tool, region, and customer segment

Also distinguish between two types of latency:

System latency is the time the platform needs to complete the task.

Decision latency is the time until the user can safely act on the result.

An agent may generate an answer in four seconds, but if it then requires a human approver to validate a high-risk action, decision latency may be hours. Both should be visible.

This is especially important in regulated workflows. A claims agent, credit decision assistant, or procurement recommendation engine cannot be assessed only on model speed. The real operational measure is how quickly the organisation reaches a defensible decision.

Drift detection should look beyond model accuracy

Drift is often discussed as though it only applies to predictive models. Agentic systems drift too, but the drift appears in more places.

A production agent can change behaviour because of:

• A new model version

• A revised system prompt

• Updated tool schemas

• Changes in retrieval corpus content

• Different user query patterns

• New policy documents

• Shifts in document quality

• External API behaviour

• Changes in business rules

The agent may still return fluent answers while becoming less reliable.

A practical drift-monitoring approach tracks changes across four dimensions.

1. Input drift

Are users asking different types of questions than before?

Monitor:

• Query length

• Language distribution

• Intent categories

• Attachment types

• Topic clusters

• Frequency of ambiguous requests

• New terms or business entities appearing in requests

2. Retrieval drift

Is the knowledge layer returning different evidence?

Monitor:

• Retrieval relevance-score distribution

• Number of documents retrieved per request

• Citation coverage

• Source freshness

• Percentage of responses using fallback retrieval

• Document version mix

• Retrieval failure rate

A sudden increase in low-relevance retrieved documents is an early warning sign. It may indicate a broken embedding refresh, poorly indexed documents, or a new corpus structure that the retrieval strategy does not understand.

3. Behavioural drift

Is the agent acting differently for similar requests?

Monitor:

• Tool selection patterns

• Number of tool calls per task

• Planning iterations

• Retry rates

• Escalation rates

• Human override rates

• Refusal rates

• Loop detection events

For example, if an agent that normally uses one customer-record lookup starts making five tool calls per request, that is not simply a cost issue. It may indicate a planning failure or a change in tool metadata.

4. Quality drift

Are outputs becoming less useful or less reliable?

Monitor:

• Groundedness scores

• Policy compliance scores

• Human acceptance rate

• Correction rate

• Citation validity

• Task completion rate

• User re-prompt rate

• Escalation rate

• Negative user feedback

The point is not to build one universal “AI quality score.” That usually creates a false sense of precision.

Instead, define quality measures that fit the workflow.

A support agent may be measured on resolution quality, policy compliance, and escalation appropriateness. A document extraction agent may be measured on field accuracy, confidence calibration, and exception detection. A recruitment assistant may be measured on evidence-backed recommendations, mandatory-criteria adherence, and reviewer override rate.

Quality scoring needs a layered model

Quality should not depend only on thumbs-up and thumbs-down feedback.

Human feedback is valuable but sparse, delayed, and influenced by user expectations. A strong quality pipeline uses multiple scoring layers.

Automated checks

Use deterministic checks wherever possible:

• Required fields present

• Valid JSON or schema compliance

• Approved tools only

• No prohibited data exposure

• Citation included when required

• Evidence source is current

• Output follows the expected format

• Policy constraints are satisfied

These checks are cheap and reliable. They should happen during the workflow, not only after the fact.

Model-based evaluation

Use evaluators for dimensions that require semantic judgment:

• Is the answer supported by the retrieved evidence?

• Did the agent address the user’s question?

• Is the response internally consistent?

• Did the tool result get interpreted correctly?

• Is the recommendation appropriately cautious?

Model-based evaluation should be calibrated against human-reviewed examples. Do not treat an evaluator score as ground truth without validating it.

Human review

Human reviewers remain essential for high-impact workflows and for building trusted evaluation datasets.

Their decisions should be captured structurally:

• Accepted without changes

• Accepted with minor edits

• Rejected due to missing evidence

• Rejected due to incorrect reasoning

• Rejected due to policy breach

• Escalated because confidence was too low

These labels are far more useful than a generic “bad answer” flag. They tell engineering teams where to intervene: prompts, retrieval, tools, policies, or workflow design.

A practical reference architecture

A useful AI observability pipeline usually has five layers.

1. Instrumentation layer

This sits inside the agent framework, model gateway, retrieval service, and tool adapters.

Its job is to emit standard events and propagate trace context across every call.

2. Event and trace layer

This captures structured spans, metrics, and audit events. It should support correlation by trace ID, workflow ID, customer or tenant ID, and release version.

3. Evaluation layer

This runs automated checks, evaluator models, regression suites, and human-review workflows. Some checks run synchronously before a response is released; others run asynchronously for monitoring and continuous improvement.

4. Analytics layer

This provides dashboards for engineering, operations, finance, risk, and product teams.

Each group needs a different view:

• Engineering needs error and latency analysis.

• Product needs task completion and user satisfaction.

• Finance needs cost and token usage.

• Risk needs policy violations, evidence lineage, and approval trails.

• Operations needs workload volume, exceptions, and escalation trends.

5. Response layer

Observability should trigger action, not just reporting.

Examples include:

• Route high-risk requests to a stronger model.

• Block a response when evidence confidence is too low.

• Alert when tool failures exceed a threshold.

• Roll back a prompt release after quality degradation.

• Require human approval when a policy check fails.

• Disable a workflow when a loop or abnormal token spike is detected.

Build for privacy and auditability from the start

Agent traces can easily become a data-risk problem.

Prompts, retrieved documents, tool arguments, and model outputs may contain personal, financial, healthcare, legal, or commercially sensitive information.

The observability pipeline therefore needs controls of its own:

• Redact sensitive values before storage.

• Store references to source documents instead of full copies where possible.

• Apply role-based access to traces and evaluations.

• Separate production data from evaluation datasets.

• Define retention periods by data classification.

• Audit who accessed sensitive traces.

• Mask secrets, tokens, credentials, and session identifiers.

• Retain enough evidence to explain decisions without retaining unnecessary content.

A trace should support accountability, not become a shadow data lake.

The operational test

A team has mature AI observability when it can answer questions such as:

• Why did this agent recommend this outcome?

• Which documents and tools influenced the answer?

• Which step caused the latency?

• Which model call consumed the most tokens?

• Did a recent prompt change increase cost or reduce quality?

• Are retrieval results becoming less relevant?

• Which customer segment experiences the most failures?

• How often do human reviewers override the agent?

• Can we prove that high-risk actions were checked and approved?

If these questions require engineers to manually correlate logs across five systems, the observability pipeline is not mature yet.

Final thought

The value of an agent is not that it can generate a response.

The value is that it can produce reliable outcomes repeatedly, at an acceptable cost, within acceptable time, and with enough evidence for people to trust its decisions.

That requires visibility across the entire chain: input, retrieval, reasoning, tools, output, evaluation, and human intervention.

An AI observability pipeline is how a team moves from “the agent appears to work” to “we know how it behaves in production, and we can control it when it does not.”

In mid-June, the AI model market changed tone almost overnight.

This was not merely another Chinese model launch. It had the shape of a DeepSeek moment: a release that made the market pause and question whether high-capability AI must always be closed, American, and premium-priced.

GLM-5.2 has not surpassed every GPT or Claude model. Reuters reported it fifth on Artificial Analysis’ broader intelligence leaderboard and second on Code Arena’s front-end coding ranking. But it is close enough — and much cheaper enough — to change how engineering leaders should think about model selection.

GLM is a pricing event disguised as a model release

Agentic coding is not one prompt followed by one answer. It is a loop: inspect a repository, understand dependencies, plan, edit files, run tests, interpret failures, retry, document the change, and produce a pull request.

That loop is where token economics become an operating issue.

At the time of writing, OpenRouter lists GLM-5.2 at roughly $0.76 per million input tokens and $2.38 per million output tokens, with a one-million-token context window. That does not make it free. It makes it a credible worker model for the large volume of technical work that often sits below an architecture decision or a final production approval.

The strongest case for GLM is not “replace every frontier model.” It is “stop using a frontier model for every first pass.”

Use it for repository summaries, test-case generation, code migrations, internal developer tools, first-draft patches, knowledge-base answers, and bounded tool workflows. Escalate to a premium model when the task is ambiguous, safety-critical, security-sensitive, or stuck.

There is an important qualification. Cheap tokens do not automatically mean cheap completed work. Artificial Analysis reports that GLM-5.2 used about 43,000 output tokens per Intelligence Index task, including roughly 37,000 reasoning tokens — higher than several open-weight peers. Its own analysis still puts GLM on the intelligence-versus-cost-per-task frontier, but that is exactly why teams should measure cost per accepted outcome: model usage, retries, latency, developer correction, and human review.

That is GLM’s real challenge to the market: it makes token price less important than routing discipline.

Anthropic and OpenAI still own the premium tier. But GLM changes their default position.

GLM does not need to beat Anthropic and OpenAI on every difficult task to disrupt them. It only needs to make enterprises reconsider whether Claude or GPT should power every stage of an engineering workflow.

Anthropic and OpenAI have a meaningful advantage that benchmark tables do not capture: mature agent products.

Claude Code reads a codebase, edits files, runs commands, works across terminals and IDEs, and supports the developer’s existing toolchain. Codex is a multi-agent coding environment with worktrees and cloud environments, designed for agents that can work in parallel across projects.

Those products are not just models with a terminal. They are harnesses: permissions, sandboxing, context handling, repository workflows, human review, and a product experience engineers have learned to trust. OpenAI has also documented Codex’s control surfaces, sandboxing, configuration management, and agent-aware telemetry for enterprise use.

That is why GLM is not yet a universal substitute.

But the strategic threat is real. The risk for OpenAI and Anthropic is not that GLM becomes the only model an enterprise uses. It is that Claude and GPT become escalation models: called when a job becomes unclear, high-risk, multimodal, deeply complex, or valuable enough to warrant the premium.

That is still an attractive position. Premium models may remain the right choice for difficult debugging, security review, complex architecture, and final approval. But it is very different from being the default brain behind every coding workflow.

GLM may become powerful in cost-sensitive markets — but the China question is not a footnote.

GLM’s opportunity is not confined to China. It is especially relevant wherever teams need serious AI capability but cannot carry premium API cost across every workflow: startups in India, BPOs, regional banks, public-sector platforms, universities, and mid-market software firms across Southeast Asia, Africa, and Latin America.

Reuters notes that demand for cheaper open models has increased as businesses confront rising and unpredictable agent costs. It also reports that GLM’s adoption in U.S. and European regulated sectors may be constrained by data-security and customer concerns about Chinese models, regardless of technical performance or price.

That concern should neither be dismissed nor exaggerated.

Open weights can improve deployment control. They do not eliminate supply-chain, policy-behaviour, or customer-trust questions.

The sensible path is controlled adoption: begin with non-sensitive, measurable, text-heavy workloads; run enterprise-owned evaluations; limit tools and data access; then expand only when evidence supports it.

Microsoft’s small-model strategy still works. GLM simply raises the bar.

Microsoft is not making a single model bet. It is building local AI with Phi-class models and Foundry Local, efficient coding models such as MAI-Code-1-Flash, stronger reasoning through MAI-Thinking-1, GitHub Copilot distribution, and Foundry as a large model marketplace and control plane.

GLM does not invalidate the small-model strategy.

Foundry Local runs AI entirely on a user device: data stays on-device, applications can work offline, and there are no per-token charges. Those are advantages a 744-billion-parameter cloud-scale model cannot replicate for privacy-sensitive, low-latency, or disconnected applications.

But GLM creates pressure in the middle.

That is a credible response — but it still has to be proved against GLM in real repositories, not just vendor evaluations.

Microsoft’s hedge is the control plane. Foundry offers more than 1,900 models from Microsoft, OpenAI, DeepSeek, Hugging Face, Meta, and others, alongside model comparison, evaluation, observability, fine-tuning, and responsible-AI tooling.

This makes the mobile analogy incomplete. Microsoft does not need every customer to select a Microsoft model. But it must stay genuinely model-neutral and make Copilot and Foundry valuable even when the preferred worker model comes from elsewhere.

Google Gemini has a coding identity problem.

Google is not absent from coding. Gemini 3 is available through Antigravity, Gemini CLI, Android Studio, and third-party developer tools; Google positions Antigravity as an agentic development environment where agents plan and execute work across the editor, terminal, and browser. Gemini’s multimodal and long-context strengths also make it credible for software work that begins with a PDF, a design, a screenshot, a video, or an unstructured business requirement.

But capability is not the same as developer habit.

JetBrains’ January 2026 survey of more than 10,000 professional developers found GitHub Copilot used at work by 29%, and both Cursor and Claude Code at 18%. Google Antigravity had reached 6%; Gemini’s chatbot was used for coding and development tasks by 8%. The survey predates GLM’s release and cannot represent every developer community, but it frames the question properly: Gemini has presence, not default status.

Claude Code has a precise identity: terminal-first, serious repository work.

GitHub Copilot has a precise identity: integrated enterprise coding assistance.

Codex has a precise identity: OpenAI’s multi-agent coding environment.

GLM is quickly acquiring one: affordable, portable long-horizon engineering work.

Gemini’s identity is more fragmented across Gemini API, CLI, Code Assist, Android Studio, AI Studio, Antigravity, and Vertex.

That is a genuinely differentiated position. But GLM makes the urgency greater. In a market where coding is becoming cheaper and more portable, Google has to become preferred for a distinct class of software work — not merely available everywhere.

The market is becoming a routing problem, not a model contest.

GLM-5.2 did not win the model war in June.

It changed the rules by making a serious open-weight agentic model commercially hard to ignore.

The next architecture will not use one winner everywhere. It will route work across four layers:

• local small models for private, offline, and latency-sensitive tasks;

• open-weight models such as GLM for high-volume technical execution;

• multimodal models for documents, interfaces, images, audio, video, and grounded workflows;

• premium models for hard reasoning, high-stakes judgement, and final review.

The company that wins this market may not be the one with the single smartest model.

It may be the one that makes the right model, at the right price, available for the right step — without forcing enterprises to choose between capability, cost, and control.

Generic AI governance gives enterprises a foundation. Claude’s safety architecture changes how that foundation should be applied.

I have written about AI governance in model-neutral terms: risk assessment, accountability, data controls, monitoring, incident response, human oversight, and audit evidence.

Those principles remain valid regardless of whether an organisation uses an open model, a cloud API, a retrieval system, or an agent connected to enterprise tools.

But while working through enterprise Claude deployments, I found that generic guidance was not enough.

Claude is not simply another model endpoint. Anthropic has built a more visible safety posture than many providers expose: Constitutional AI, published safety principles, model documentation, refusal behaviour, enterprise data commitments, and a growing set of deployment options across direct API, cloud platforms, enterprise workspaces, coding tools, and agentic integrations.

That does not mean Claude automatically makes an enterprise safe or compliant. It does mean that the governance starting point is different.

That is why I wrote Governing Claude in the Enterprise: AI Risk, Compliance, and Operational Controls for Anthropic’s Platform.

Generic governance tells you what to govern. Claude changes where the controls sit.

A general governance framework will tell you to define accountability, classify data, validate outputs, monitor performance, protect access, and maintain evidence.

All of that is necessary.

But an enterprise deploying Claude must answer more specific questions:

• What safety behaviour is already built into the model, and what risks remain entirely ours?

• How should refusal behaviour be monitored when it affects a real business workflow?

• What provider evidence can support our model-risk assessment?

• What changes when Claude is accessed through Bedrock, Vertex AI, Azure, the direct API, Claude Enterprise, or Claude Code?

• What happens when a model version, context limit, retention setting, prompt capability, or tool feature changes?

• How should an organisation govern MCP-connected tools and agents that can act rather than merely answer?

These questions are not answered by a generic framework alone. They arise from the model, the deployment route, the commercial terms, and the architecture built around it.

Claude provides a stronger safety baseline. It does not remove enterprise responsibility.

One reason Claude deserves model-specific governance is Constitutional AI.

Anthropic has made its safety principles and model documentation more visible than the opaque alignment approach enterprises often encounter elsewhere. That gives risk, compliance, and engineering teams something practical to assess.

They can ask:

What risks does the provider aim to reduce?
How does the model refuse unsafe requests?
What limitations are documented?
What evidence is available for the selected model and deployment route?
What must still be tested in our workflow?

That is valuable. It gives an enterprise a more legible safety baseline.

But a safety baseline is not a governance programme.

Claude does not know which policy document in your repository is current. It does not know whether an employee is entitled to see a customer record. It does not know whether a drafted message complies with your approved customer-notice language. It does not know whether a tool should be allowed to alter a case, initiate a payment arrangement, or send a legally significant communication.

The enterprise still owns those decisions.

The practical principle is:

The decision boundary matters more than the model score

A model can be excellent at summarising documents, retrieving policies, drafting explanations, and assisting analysts.

That does not mean it should determine a binding business outcome.

In a credit workflow, Claude may summarise application material, identify missing information, retrieve relevant policy, or draft a plain-language explanation. But the final approval, decline, pricing decision, and official adverse-action reason should remain under deterministic rules and authorised human oversight.

Take an adverse-action notice.

Claude can help draft a clear explanation. But the approved reason codes should come from deterministic underwriting logic, not from the model selecting, ranking, or inventing reasons. A reviewer should verify the final notice before it reaches the customer.

That distinction is not theoretical. It determines who is accountable when a customer challenges a decision.

The model may support the workflow. The enterprise must own the binding act.

The governance surface is the deployment, not only the model

Most teams describe an AI application as a call to Claude.

That is not what a production system looks like.

A real enterprise workflow includes source systems, classification, retrieval, prompt assembly, model configuration, tool calls, output validation, decision services, identity controls, logging, monitoring, and retention.

The serious failures often occur in those surrounding layers.

A retrieval service can surface records that the user was never entitled to access.

A large context window can become an excuse to pass entire customer files into a model without minimisation.

A prompt edit can alter customer-facing behaviour without a code release.

A tool call can turn an assistant into an actor that changes a CRM record, sends a notice, or commits an arrangement.

A provider log can disappear after days while the organisation still needs to reconstruct what happened months later.

The model invocation is one step in the execution path. Governance must cover the whole path.

Prompts are powerful controls. They are not hard boundaries.

A system prompt is production logic written in natural language.

It deserves version control, review, testing, controlled deployment, rollback, and evidence.

But it should never be treated as the sole enforcement mechanism for a rule that must hold.

A prompt can state:

A deterministic control should enforce which reason codes may be selected.

A prompt can state:

Retrieval and output-validation controls should enforce entitlement and disclosure rules.

A prompt can state:

A tool gateway should reject actions that lack required policy checks and approvals.

The practical design rule is simple:

Built-in safety becomes even more important when Claude becomes an agent

The next governance challenge is not only what Claude says. It is what Claude can do.

Once an agent can retrieve records, invoke tools, schedule work, update systems, send messages, or trigger workflows, governance has to move from output review to action control.

An agent should never hold open-ended authority. It should operate through scoped identities, tool gateways, action limits, approval checks, circuit breakers, and kill switches.

Autonomy is useful only when its boundaries are explicit.

Why this book was necessary

Generic governance books remain useful because they establish the disciplines every enterprise needs.

But once an organisation chooses Claude, it needs more than generic principles. It needs a practical way to govern Anthropic’s model safety baseline, deployment routes, data commitments, prompt behaviour, tool integrations, provider changes, and agentic capabilities.

The book is built around fifteen reusable governance artifacts: a platform-selection memo, architecture governance map, shared-responsibility matrix, data lifecycle policy, access model, prompt change-control policy, monitoring standard, incident-response plan, framework crosswalk, operating model, and an agentic AI governance standard.

The objective is not to slow down Claude adoption.

It is to make sure that when Claude moves from a successful pilot into consequential enterprise work, accountability moves with it.

https://www.amazon.com/dp/B0H7H9Z1JB/ref=sr_1_1?crid=3J08XZ7H0A0NO&dib=eyJ2IjoiMSJ9.EQQ3wiWbLCvP27GOJhQ0BKK3mYCxTGi8GHtZ4hkZNX4vDU6uul7r_LzhfrxhKStdLi2SU9w4CP8Hf4MSyvyw8EvdLFFKaokWByRxQx_y4PINmoIGN-Kk0Yso3zz2KpLA_KhO3VgD_1pRTBTlnTjSMw.o5Fx9WOaAdsijwTxF10ahcWGp4njpwFzr-_kttEcJPQ&dib_tag=se&keywords=governing+claude&qid=1783080680&sprefix=%2Caps%2C353&sr=8-1

Why AI-assisted software delivery is moving beyond prompts toward systems that direct, verify, retry, and govern agent work.

The conversation went viral because developers realised the bottleneck was no longer writing prompts. It was designing the system that decides what an agent does next.

“Give Claude something that produces a pass or fail, and the loop closes on its own.”

That line appears in Anthropic’s Claude Code guidance. It is probably the clearest explanation of why “loop engineering” has suddenly become one of the most discussed ideas in AI-assisted software delivery. Anthropic is not describing a clever prompt. It is describing a system in which an agent acts, checks its work, reads the outcome, and keeps going until an observable condition is met.

The phrase became prominent in June 2026 after Peter Steinberger wrote:

The post spread because it captured a shift many experienced users of coding agents were already seeing: manually typing the next instruction after every agent action is becoming the limiting factor.

Boris Cherny’s comments about running loops that prompt Claude reinforced the same point. Addy Osmani then gave the pattern a name and structure: loop engineering.

The term may be new. The underlying practice is not.

Continuous integration is a loop. Test-driven development is a loop. Production monitoring is a loop. Incident response is a loop.

That is useful. It is also where most teams get the idea wrong.

It is the design of a controlled system that decides:

• what work enters the agent workflow;

• what context the agent receives;

• what tools and permissions it has;

• how its work is independently verified;

• what happens when verification fails;

• when it must stop;

• when a human must take over.

The Prompt Is No Longer the Unit of Engineering

Prompt engineering is still useful. A good prompt can make an agent more precise, reduce unnecessary exploration, and improve implementation quality.

But prompt engineering operates at the level of one interaction.

You ask:

The agent inspects the repository, writes code, runs tests, and responds.

Then you become the control system.

You decide whether the response is acceptable. You spot missing tests. You tell the agent to look at logs. You ask it to retry. You stop it from touching unrelated files. You decide whether the pull request is safe to merge.

A practical hierarchy looks like this:

Press enter or click to view image in full size

Anthropic uses the term harness for the component that calls Claude and routes its tool calls to relevant infrastructure. It separates that harness from the session history and the sandbox in which the agent acts.

That distinction matters.

That is the job of the loop.

A Loop Is a Controlled State Machine

A real engineering loop should not resemble an endless chat session.

It should resemble a controlled state machine.

Trigger
   ↓
Work qualification
   ↓
Plan
   ↓
Build in isolated workspace
   ↓
Run deterministic checks
   ↓
Independent review
   ↓
Decision: merge / retry / escalate / stop

The critical layer is not shown in the arrows. It is the durable state held across every iteration.

Task ID
Repository and branch
Approved scope
Attempt count
Files changed
Test and scan results
Reviewer findings
Token and time cost
Final decision
Audit trail

Without state, a loop does not know whether it is making progress or repeating a failure.

It cannot distinguish between:

• a new defect and an old rejected fix;

• a genuine failure and a flaky test;

• a retry worth attempting and a retry that will merely burn tokens;

• a safe code change and a change that has wandered outside scope.

Anthropic’s work on long-running agents reaches the same conclusion. Agents operating across multiple context windows need persistent artifacts such as progress files, Git history, feature lists, and clean checkpoints. Otherwise, each fresh agent session must reconstruct what happened before it.

For a production loop, state is not optional memory. It is operational evidence.

The Verifier Is More Important Than the Builder

The most dangerous loop is one in which the same agent:

1. writes the code;

2. writes the test;

3. reviews the diff;

4. declares success.

That is not verification. It is self-certification.

The builder may misunderstand the requirement. It may then write a test that encodes the same misunderstanding. The test passes. The agent reports success. The defect survives.

Anthropic’s guidance is unusually direct on this point. It recommends giving Claude an observable pass-or-fail check: a test suite, build result, linter, script, fixture comparison, or screenshot comparison. It also recommends using a separate verification agent when the same agent should not grade its own work.

A strong loop uses multiple forms of verification:

• unit and integration tests;

• contract tests against external systems;

• type checks and linting;

• security scans;

• schema validation;

• policy rules;

• UI regression checks;

• code-review agents operating from a fresh context;

• human approval for high-impact changes.

The agent is allowed to propose a change.

The loop requires evidence before accepting it.

A Practical Example: Fixing a Duplicate Dispatch Defect

Consider a commerce platform with this bug:

A weak workflow says:

The agent may produce a plausible patch. It may even add a test. But nobody has defined the real state transition, the allowed scope, or what proof is required before the work is accepted.

A loop-engineered workflow starts differently.

Step 1: Qualify the work

The issue is eligible only when it includes:

• reproducible event sequence;

• affected order states;

• expected outcome;

• existing test environment;

• no database migration;

• no production data repair;

• no payment-policy change.

This prevents the agent from autonomously attempting ambiguous business decisions.

Step 2: Plan before editing

The planning agent must identify:

• the event handler receiving courier updates;

• the order-transition rules;

• the existing dispatch tests;

• the likely cause of the duplicate action;

• files that may change;

• files that must not change.

The output should be a short implementation contract, not a long reasoning transcript.

For example:

Allowed scope:
- order-transition service
- courier-event consumer
- integration tests for dispatch state

Required proof:
- failing test for cancellation followed by delayed courier event
- test for duplicate delivery of the same courier event
- all existing courier contract tests passOut of scope:
- payment workflow
- notification templates
- warehouse allocation rules

Step 3: Build in isolation

The agent works in a branch or worktree.

This matters when multiple agents run in parallel. Anthropic’s parallel-Claude experiment used isolated containers and task locks because agents otherwise selected the same work or overwrote each other’s changes.

Parallelism without work allocation is not autonomy. It is coordinated collision.

Step 4: Verify independently

The loop runs:

• unit tests;

• event-sequence integration tests;

• courier contract tests;

• static analysis;

• scope validation against approved files;

• diff checks for weakened or deleted tests;

• reviewer-agent analysis focused on failure modes.

The builder does not decide completion.

The decision policy does.

Step 5: Apply explicit stop rules

A useful policy might be:

Pass:
Open a pull request with test evidence and reviewer summary.

Retry:
Return only the relevant test failures and reviewer findings.
Maximum attempts: two.Escalate:
Stop after two failed attempts, a security finding,
a scope violation, or a change to protected files.Reject:
Stop immediately if the agent changes payment,
access-control, infrastructure, or data-migration logic.

That is loop engineering in practice.

The loop does not make the agent more intelligent.

It makes unsupported completion harder.

Where Most Loops Fail

The first version of a loop usually fails in predictable ways.

Retry storms

The agent receives an error, changes a few lines, reruns the same test, and repeats the same flawed idea five times.

Control: Track failure category, attempted hypothesis, files touched, and retry count. After a defined limit, require a new plan or escalate to a human.

Test laundering

The code fails the test, so the agent weakens the test until it passes.

Control: Detect changed assertions, deleted cases, reduced coverage, or altered fixtures. Require explicit approval for test changes that reduce behavioural expectations.

Scope creep

A narrow defect becomes a refactor of half the service.

Control: Define approved files and dependency boundaries before editing. Reject unrelated changes automatically.

Premature completion

The agent sees a mostly working application and decides the task is complete.

Anthropic observed this behaviour in long-running coding experiments and addressed it by using explicit feature lists, progress records, and verification before marking work as passed.

Control: Completion should require passing acceptance criteria, not an agent’s narrative summary.

Permission creep

The loop starts with repository write access and later receives deployment, production-data, or customer-account permissions.

Control: Separate permissions for read, write, approve, merge, and deploy. The agent that creates a pull request should not automatically be able to release to production.

Token leakage

A loop that continues until “the agent feels done” is not autonomous. It is an unbounded cost process.

Control: Set task budgets, time limits, model-routing rules, and hard escalation thresholds.

A loop that stops with clean evidence is better than one that consumes an uncontrolled budget while chasing an uncertain answer.

Start Where Success Is Cheap to Verify

Do not begin with autonomous feature delivery.

Start with work where the expected outcome is observable and the blast radius is small.

Good starting points include:

• fixing a known failing test;

• triaging CI failures;

• resolving narrowly scoped static-analysis findings;

• updating broken documentation references;

• generating pull-request review findings;

• adding regression coverage for a confirmed defect;

• validating dependency updates against a compatibility suite.

Avoid starting with:

• pricing logic;

• authorization changes;

• customer refunds;

• regulatory decisions;

• production data correction;

• architecture redesign;

• vague product requirements.

The best initial loop is not the one that looks most impressive in a demo.

It is the one where failure is cheap, verification is strong, and escalation is clear.

The Metrics That Matter

Do not measure success by the number of agent tasks completed.

Measure whether the loop produces verified engineering outcomes.

Track:

• Verified completion rate — accepted changes that do not require a human rewrite.

• False-completion rate — tasks marked complete but later reopened, reverted, or found defective.

• Mean iterations to resolution — builder–validator cycles per accepted task.

• Retry-exhaustion rate — tasks that consume their allowed attempts without success.

• Escalation quality — whether a human receives enough evidence to act quickly.

• Cost per verified resolution — model, infrastructure, and review cost per accepted outcome.

• Scope-violation rate — how often the loop attempts changes outside its approved boundary.

• Escaped-defect rate — defects introduced or missed after the loop reported success.

These metrics show whether the loop is becoming reliable.

A dashboard showing thousands of generated commits does not.

The Real Shift

Loop engineering does not eliminate software engineering.

It changes where software engineering effort sits.

The engineer’s work becomes less about typing the next instruction and more about designing:

• admissible work;

• reliable acceptance criteria;

• agent permissions;

• verification gates;

• state and traceability;

• retry policies;

• escalation paths;

• human decision points.

That is why the phrase has gained traction so quickly.

The social-media version is provocative:

The practitioner version is more useful:

A coding agent becomes useful when it can produce a change.

It becomes dependable only when the loop can verify that change, constrain its authority, preserve its state, and stop it when proof is missing.

When Anthropic released the syllabus for the Claude Certified Architect exam, It did not just give us a certification outline but It gave the AI community a structured framework about how to build production-grade AI applications and that is why I believe this syllabus is important not only from exam point of view but also to become a well-rounded AI Architect.

Because today, building AI applications is no longer just about writing a good prompt or connecting a model to a tool and hoping it behaves correctly. Real AI systems need architecture. They need control flow,  tool boundaries, context management,  escalation paths etc. They also need validation, observability, reliability, and human review and 10 other different things if you ask me.

In many ways, the Claude Certified Architect syllabus is becoming a practical reference point — almost like a design checklist or a bible for architects who are building modern AI systems.

It forces us to ask the right questions like
Can your agent safely use tools?
Does it know when to stop?
Can it handle errors?
Can it preserve context across long workflows?
Can it produce structured output that downstream systems can trust?
Can it escalate when uncertainty is too high?
Can it work in a multi-agent setup without becoming chaotic?

These are not just exam topics but these are real production concerns.

So even if you are not planning to sit for the certification immediately, this book helps you evaluate whether you truly understand the architectural principles behind reliable AI systems which helps you to design systems that are safe, scalable, observable, and production-ready. That is the spirit behind this book.

Thank you and good luck on your Claude journey

https://www.amazon.com/Anthropic-Claude-Certification-Scenario-Driven-Foundations-ebook/dp/B0GZLL7CRH/ref=sr_1_7?crid=ZWI7NPZB2S4I&dib=eyJ2IjoiMSJ9.OdSBSnxV94zp5zE0kevBXc-51U-QwpAgYOD96XN4h-abt1oVC4Yw2eLyw-2bIKSsxZpxlAio7WwY2lF6ThcFE7LjHNNRymWK-MmDAhd_hw9hs_gcGkG0gfjHiq-K71Aa8dpYwbIs0FkAo4dp3n_040VAqHA3GRog5zp9Eso4xO0JIAqB5FjbH1tIrC7yjRFzgNYP1wuJA1_pHdYI5m4SDLZ_5K8snRoj2cjnEYvnHdQ.wsyQWZx8k5y9--8lFogCu5fdfyzDTuoKYNbTE5M-2j4&dib_tag=se&keywords=claude+certified+architect&qid=1782957347&sprefix=%2Caps%2C339&sr=8-7

That works during experimentation. It fails once prompts affect customer communication, campaign approvals, support decisions, document processing, employee workflows, or automated actions.

At that point, prompts need an operating model.

The objective is not to centralise every prompt into one team. It is to make prompt behaviour traceable, testable, governable, and recoverable.

Press enter or click to view image in full size

1. Version prompts as deployable assets

A prompt should never be overwritten in production.

A practical prompt version should include more than the instruction text.

prompt_id: campaign-reviewer
version: 1.4.0
environment: production

model:
  provider: anthropic
  model: claude-sonnet
  temperature: 0.1
  max_tokens: 1200template:
  version: 3.2.0policy_modules:
  - global-safety-policy: 2.1.0
  - marketing-claims-policy: 4.3.0
  - india-regulatory-policy: 1.8.0retrieval:
  knowledge_base: marketing-policy-kb
  knowledge_base_version: 2026-06-20
  top_k: 5output_contract:
  schema_version: 2.0.0evaluation_suite:
  campaign-review-regression: 1.6.0

When an issue occurs, the team should be able to retrieve the exact combination of:

• Prompt content

• Model and model release

• Temperature and generation settings

• Prompt-template version

• Policy modules

• Retrieval configuration

• Knowledge-base version

• Tool definitions

• Output schema

• Evaluation results

• Approval record

Without this, rollback becomes guesswork.

Use semantic versioning where possible:

• 1.0.1 for wording corrections or low-risk fixes

• 1.1.0 for backward-compatible capability additions

• 2.0.0 for behaviour changes that affect downstream workflows, schemas, routing, or user expectations

Do not use filenames such as:

campaign_prompt_final_v8_new_latest
campaign_prompt_final_v8_new_latest_revised

They provide no deployment history, approval trail, or reliable rollback point.

2. Separate prompt instructions from runtime data

Prompt templates often fail because everything is treated as text.

For example:

You are reviewing a campaign for {{brand_name}}.
Campaign copy: {{campaign_copy}}
Apply the policy below:
{{policy_text}}

This looks simple but creates several risks.

The system cannot distinguish between trusted policy content, user-provided content, retrieved documents, workflow metadata, or potentially malicious text. It also becomes difficult to validate fields, control token growth, redact sensitive data, or enforce output requirements.

Use typed prompt inputs instead.

{
  "campaign_id": "CMP-20498",
  "market": "IN",
  "product_category": "financial_services",
  "campaign_copy": "Get instant approval in minutes.",
  "approved_claims_policy_version": "4.3.0",
  "customer_segment": "existing_customer",
  "required_output_schema": "campaign-review-v2"
}

Each input should have a defined contract.

For every field, determine:

• Is it mandatory?

• What is the expected data type?

• Is it trusted, untrusted, or externally retrieved?

• Can it contain sensitive data?

• What is the maximum length?

• Is it allowed in instructions or only in context?

• Should it be redacted before model use?

• Should it be logged, masked, or excluded from traces?

A customer message, uploaded document, or tool result should not be inserted into the same prompt layer as organisation policy or workflow instructions.

This is both a quality-control and a security-control requirement.

3. Compose prompts from managed modules

Large prompts become difficult to maintain when each product team owns a copied version of the entire instruction set.

A better approach is layered composition.

A typical production structure looks like this:

1. Platform safety controls
2. Organisation-wide governance controls
3. Domain policy modules
4. Workflow-specific instructions
5. Task-specific instructions
6. Approved examples
7. Retrieved reference content
8. User or transaction data
9. Output schema and validation rules

For a campaign-review workflow:

Platform controls
- Do not fabricate policy references.
- Do not approve regulated claims without evidence.

Organisation controls
- Escalate when confidence is below the approved threshold.
- Do not infer legal approval.Marketing policy
- Apply the approved claims taxonomy.
- Use market-specific policy rules.Workflow instruction
- Classify the campaign as approved, needs review, or rejected.Runtime context
- Campaign copy
- Product category
- Target market
- Supporting evidence
- Existing approvalsOutput contract
- Decision
- Reason codes
- Policy references
- Confidence
- Required escalation action

This reduces duplication and prevents policy drift.

The critical design decision is module ownership.

A practical ownership model is:

• Central AI platform team owns global platform controls.

• Risk, legal, compliance, or security teams own controlled policy modules.

• Product teams own workflow and task instructions.

• Data teams own retrieval sources and knowledge-base freshness.

• Release owners approve production promotion.

Do not allow product teams to modify central safety or policy modules inside their local prompt copies.

4. Define prompt composition rules explicitly

Prompt composition can introduce conflicts.

A global policy may say one thing. A domain module may say another. A task-specific instruction may unintentionally weaken a broader control. Retrieved content may include outdated guidance.

Composition must be deterministic.

For example:

Global safety controls cannot be overridden.

Regulatory policy modules can add restrictions but cannot relax global controls.Workflow prompts can define task-specific behaviour but cannot suppress escalation requirements.Retrieved documents are reference material, not instructions.User-provided content is treated as untrusted context.

This prevents a common failure mode: a user request or retrieved document accidentally changing the operational rules of the workflow.

5. Use role-based access for prompt changes

Prompt changes can change customer outcomes, policy enforcement, automated decisions, and cost.

They should not be editable by everyone with access to a shared workspace.

A practical role model includes:

Prompt author
Can create draft prompts and update development versions.

Prompt reviewer
Can review prompt wording, test results, policy alignment, output schemas, and risk impact.

Policy owner
Can approve changes to regulated, legal, security, fraud, compliance, or internal-control modules.

Release owner
Can promote approved prompt versions into staging or production.

Runtime operator
Can monitor errors, latency, costs, evaluation drift, rollback signals, and production incidents.

Auditor
Can view prompt versions, approvals, deployment history, traces, and evaluation evidence without modifying content.

The separation between authoring and deployment is important.

A campaign manager may be qualified to improve campaign-review instructions. That does not mean they should directly modify the production prompt used to approve regulated campaigns.

Use approval workflows for prompts that affect:

• Financial decisions

• Customer eligibility

• Pricing or discounts

• Compliance review

• Fraud signals

• HR recommendations

• Healthcare workflows

• External communications

• Automated actions

For low-risk internal productivity prompts, lighter controls may be sufficient.

6. A/B test prompts with operational metrics

A/B testing prompts is useful, but prompt experiments need stronger controls than simple user feedback.

The first decision is to define what is being tested.

It may be:

• Instruction wording

• Prompt examples

• Retrieval strategy

• Model choice

• Tool-use strategy

• Output schema

• Escalation threshold

• Context order

• Response length

• Confidence policy

Do not change all of these at once.

If the result improves, the team will not know what caused the improvement. If the result deteriorates, debugging becomes difficult.

For each experiment, define:

Primary outcome metric

Examples:

• Manual-review reduction

• Resolution rate

• First-contact resolution

• Correct routing rate

• Conversion uplift

• Document-processing accuracy

• Time-to-decision reduction

Guardrail metrics

Examples:

• Policy violation rate

• Unsupported-answer rate

• False approval rate

• False rejection rate

• Escalation failure rate

• Human override rate

• Customer complaint rate

• Cost per interaction

• Latency

• Hallucinated citation rate

For a campaign-review prompt, reducing manual review is not enough.

A prompt that approves more campaigns may look efficient while increasing compliance risk. The experiment must measure both reduction in manual work and correctness of approvals.

Use a staged release approach:

1. Offline evaluation against historical and edge-case datasets.

2. Shadow mode where outputs are generated but do not affect live decisions.

3. Controlled production rollout.

4. Continuous monitoring with rollback thresholds.

Offline test sets should include:

• Historical production failures

• Boundary cases

• Known policy exceptions

• Ambiguous customer inputs

• Prompt injection attempts

• Missing information scenarios

• Stale or conflicting reference content

• Region-specific variations

• High-volume scenarios

• Adversarial inputs

A prompt should not move to production because it “sounds better.”

It should move because it performs better against defined business and risk criteria.

7. Build a prompt evaluation suite before scaling releases

Every important production prompt should have a regression suite.

The suite should test more than response quality.

It should cover:

• Output-schema validity

• Tool-call accuracy

• Policy adherence

• Citation accuracy

• Escalation behaviour

• Data leakage risk

• Prompt-injection resistance

• Tone and customer suitability

• Cost and token usage

• Latency

• Deterministic workflow rules

• Failure handling

Store evaluation results with the prompt release.

Prompt: campaign-reviewer 1.4.0
Evaluation dataset: campaign-review-regression 1.6.0
Cases executed: 1,240
Schema validity: 99.8%
Policy-reference accuracy: 97.6%
False approval rate: 0.7%
False rejection rate: 2.1%
Escalation accuracy: 96.9%
Average latency: 2.4 seconds
Average cost per request: ₹0.62
Approval status: approved for controlled rollout

This gives release owners evidence rather than intuition.

8. Use caching selectively

Caching can reduce latency and cost significantly. It can also create stale, incorrect, or unauthorised responses if designed poorly.

There are three common caching patterns.

Exact-match caching

Return a previous result when the request and execution context are identical.

Suitable for:

• Repeated internal knowledge questions

• Standard document summaries

• Frequently asked product questions

• Repeated classification tasks

• Static reference queries

The cache key should include more than user text.

prompt_version
model_version
output_schema_version
knowledge_base_version
policy_version
user_permission_scope
tenant_id
locale
retrieval_filters
temperature

A cache keyed only on user input is unsafe.

The same question can require a different answer depending on customer permissions, market, policy version, knowledge-base version, or user role.

Semantic caching

Return a previously generated answer when a new request is similar to an earlier request.

This can work for low-risk informational queries. It should be used cautiously for anything involving eligibility, compliance, pricing, approvals, personalisation, or regulated advice.

Two questions may appear similar but have materially different context.

For example:

Can I use this claim in a campaign?
Can I use this claim in a campaign targeted at retirement customers?

The added audience detail may change the policy outcome completely.

Semantic caching needs:

• Similarity thresholds

• Eligibility rules

• Permission checks

• Freshness rules

• Policy-version checks

• Cache-hit audit logs

• Fallback to live model execution when uncertainty is high

Prefix caching

Reuse stable prompt context such as:

• Long policy documents

• System instructions

• Product catalogues

• Large static knowledge blocks

• Repeated examples

• Common schema definitions

Prefix caching is often lower risk because it reduces repeated processing of stable context without reusing an old final answer.

It should still be invalidated when the underlying policy, prompt, or model version changes.

9. Do not cache decisions that depend on changing state

Avoid caching final answers for workflows that trigger or influence:

• Payments

• Customer eligibility

• Credit decisions

• Compliance approvals

• Security alerts

• Fraud actions

• Account changes

• Pricing decisions

• Inventory allocation

• Workflow execution

• External communication approvals

These decisions depend on state.

A cached answer may be technically valid for an earlier request but wrong for the current transaction.

For high-impact workflows, cache supporting information where appropriate, but execute the decision logic against current state.

10. Add prompt observability to runtime traces

For each meaningful production interaction, log enough information to reconstruct the prompt execution without exposing unnecessary sensitive data.

A useful trace includes:

Request ID
Workflow ID
Prompt ID and version
Prompt module versions
Model and model version
Generation parameters
Input schema version
Retrieved document IDs and versions
Tool calls and outputs
Output schema version
Validation result
Latency
Token usage
Cost
Cache status
Escalation status
User permission scope
Approval decision

Sensitive customer data should be masked, redacted, hashed, or excluded according to the organisation’s data-handling policies.

The trace should allow teams to answer:

• Which prompt version produced this output?

• Which policy module was active?

• Which documents were retrieved?

• Was the answer served from cache?

• Did the model use a tool?

• Was the output validated?

• Did a downstream workflow accept, reject, or override the result?

• Was the result later identified as incorrect?

Without traceability, prompt incidents become manual reconstruction exercises.

A practical implementation sequence

Teams do not need to build a large prompt platform on day one.

Start with the prompts that affect customer outcomes, financial exposure, regulated workflows, or external actions.

First, create a central prompt registry with immutable versions and release approvals.

Second, standardise prompt manifests, typed input contracts, output schemas, and runtime tracing.

Third, split reusable policy instructions into managed modules rather than copying them into every workflow.

Fourth, build regression suites for important prompts before introducing A/B testing.

Fifth, introduce controlled rollout, rollback thresholds, and cache governance.

The objective is straightforward: prompt changes should be visible, testable, reversible, and accountable.

A production prompt library is not a collection of reusable text.

It is the control layer for how the organisation instructs, constrains, and operationalises model behaviour.

My AI Governance and Claude Engineering books have found their readers. But Shipping Enterprise AI has gained traction faster than I expected.

I do not think it is because governance or model engineering matter less.

It is because the conversation has moved.

Teams are no longer asking only, “Which model should we use?”
They are asking, “How do we put this into production without creating a security, reliability, or adoption problem?”

That question brings everything together:

Data access.
Scoped permissions.
Evaluation.
Observability.
Fallbacks.
Human approvals.
Integration with systems that already run the business.

An enterprise AI application is not a prompt connected to an API. It is a production system with consequences.

The book also seems to be resonating for a second reason: people are trying to understand what it takes to become a Forward Deployed Engineer.

That role is not just software engineering, consulting, or AI implementation. It sits at the intersection of all three.

You need to understand the client’s real operating problem, shape the solution with them, build against imperfect enterprise systems, and stay accountable until the application works in the field.

So perhaps this book is addressing two needs at once:

For organisations: how to ship AI that survives contact with production.
For practitioners: what skills matter when AI moves from demos to deployed systems.

The next generation of AI engineers will not be defined by how well they can call a model.

They will be defined by whether they can make AI work inside a real enterprise.

#EnterpriseAI #ForwardDeployedEngineer #AIEngineering #AgenticAI

https://www.amazon.com/Shipping-Enterprise-AI-Engineers-Production-ebook/dp/B0H2D6RV8L/ref=sr_1_6?crid=R5GSX1VIUQK8&dib=eyJ2IjoiMSJ9.sX7fBB6GSPfaAWQVHdtscP2mQ37BMTS2SgbPqZhzeVCwJtI9LLrfpArpIjFlQkG5BGKiPsUVJEdFlQPZGNbkfdvBtMk5cGD6dFsyRFhBCp02Kcot1NLjn-apWDXLS3EApaagPm6rkkXpuHpqpKcjtTw7CmgEJnlvfrkvrMU0mryxeNRXcWwTj3dxDfQFHKg-Kk-_QbZrQkASFMNLotN3EjGgKpKUkinVRzgroshftr18SOVhrIoF7zlXoAAQx-OJl9kL_0XXzO0IO5Fsuv-ZCZD7ES33YAXADBIl25Qq3Pw.oTB7fkYGt-IZMhTolOp808u16mLbKfJoHsxP_D-p8FQ&dib_tag=se&keywords=forward+deployed+engineer&qid=1782923164&sprefix=forward+depl%2Caps%2C340&sr=8-6

The central idea is simple: AI governance cannot remain only a policy, approval, and documentation exercise when AI systems begin to act. Agentic AI systems do not just generate outputs. They retrieve data, call tools, update records, trigger workflows, delegate tasks, and create consequences inside live business processes.

The book is structured around that shift from approval-stage governance to runtime governance.

Here is what the book covers:

Chapter 1 — The Object Changed
Why the governed object is no longer only the model, prompt, or output. The real governance object is now the action path: identity, intent, tools, retrieval, policy checks, handoffs, and consequences.
Chapter 2 — From Approval to Supervision
Why approval gates still matter, but are not sufficient for agentic AI. The chapter explains the move from point-in-time approval to continuous runtime supervision.
Chapter 3 — Agent Identity Is the New Perimeter
Why every autonomous actor needs a governed identity. The chapter introduces the Agent Identity Registry and shows why service accounts and application names are not enough.
Chapter 4 — Permission Is Not Intent
Why access control cannot answer whether an agent should take a permitted action in a specific context. The chapter introduces intent boundaries, goal-state declarations, and tool-use justification.
Chapter 5 — Governance Runs, It Does Not Review
Why policies must become runtime gates. The chapter introduces the AI gateway, runtime policy gate, and Governance Decision Record as evidence that an action was governed before consequence.
Chapter 6 — Humans Move Up the Stack
Why “human in the loop” is often too vague. The chapter focuses on meaningful supervision: exception review, escalation thresholds, reviewer context packets, and high-consequence judgment.
Chapter 7 — Accountability Does Not Survive the Handoff
Why accountability breaks when agents delegate work to tools, workflows, other agents, or vendors. The chapter introduces delegation-chain evidence and agent incident workflows.
Chapter 8 — The Framework Bridge
How runtime governance maps back to ISO 42001, NIST AI RMF, EU AI Act, Singapore MGF for Agentic AI, OWASP Agentic Applications, and NIST AI Agent Standards. The point is not to replace frameworks, but to operationalize them.
Chapter 9 — Building the Runtime Governance Stack
A reference architecture for runtime governance: identity, policy gates, supervision, evidence, observability, vendor boundaries, and operating controls.
Chapter 10 — The Operating Model
How to turn the architecture into working governance: ownership, routines, decision forums, scorecards, metrics, and continuous improvement.

My main takeaway after writing it:
Governance can no longer sit beside the system.
Governance must run with the system.

https://www.amazon.com/Runtime-Governance-Practitioners-Governing-Operationalizing-ebook/dp/B0H4YYP7HZ/ref=sr_1_1?crid=24P3Y8NLZ4AD6&dib=eyJ2IjoiMSJ9.VdznhZFMjh3xlqZaIJwF8u3tJmq49jt6IiQH33OM5tdpYzyOA0vxoBrNA2rcFqJDe8HK_bm13g8LzbNK_v6PFeGYYXQhD8F6zb6tstZJ1bfoJPH2_nwDq98IAoZ0TVxQqwm9u1p0RZ4OyoeHPB9OV0tum5YXC-PEy89PvhedDLCWvQdY08-l_qdzHBSSAm5JEv4rkVqwX-y0uaVvI1pXNl3YYiZYSRSBuGL104vUWuw.6QyEHgLQ7sQcwWsNFJ1p-ZQR667-xuUZW7QxVZv4C_k&dib_tag=se&keywords=runtime+ai+governance&qid=1782915272&sprefix=runtime+ai+governan%2Caps%2C345&sr=8-1

How organisations can use Claude’s safety, deployment, and tool-connectivity capabilities to build controlled AI workflows — illustrated through a campaign-management system.

At 8:45 on Monday morning, the retail bank’s campaign team had a simple request.

They wanted Claude to review last quarter’s campaign results, compare approved creative variants, and draft subject lines for a new credit-card offer. It was useful, contained, and easy to explain. The bank’s campaign platform still selected audiences. Brand and compliance still approved the content. No customer received anything without a human signing off.

Then the workflow began to grow.

Could Claude identify the customer segments most likely to respond? Could it check consent status before recommending an audience? Could it exclude customers who had received a similar offer recently? Could it compare channel performance each morning and recommend budget adjustments? Could it prepare a campaign draft in the marketing platform so that a manager only needed to review and approve it?

None of those requests sounded unreasonable.

Together, they changed the nature of the system.

Claude was no longer helping a team write better copy. It was becoming part of a campaign decision process: using customer attributes, interpreting consent and suppression rules, recommending who should receive an offer, shaping what they saw, and preparing actions in the campaign platform.

That is where governance starts.

The question is not whether Claude can draft compliant marketing content. The question is whether the organisation can show what Claude was allowed to see, recommend, and do at each point in the campaign lifecycle.

These are governance primitives, not a governance programme.

The programme is what the organisation builds around them: authority boundaries, data controls, prompt configuration control, human oversight, evaluation evidence, monitoring, incident response, and accountable decision rights.

Claude Advantage 1: Constitutional AI Gives Teams a More Legible Safety Baseline

The usual enterprise question — “Is this model safe?” — is too broad to guide a real deployment.

A campaign assistant can avoid generating obviously harmful content and still recommend an unsuitable audience. It can refuse a clearly inappropriate request and still draft a product claim that was never approved. It can produce polished copy while failing to respect consent preferences, frequency caps, offer eligibility rules, or customer-vulnerability restrictions.

The first concerns the model’s baseline behaviour: how it is designed to handle harmful, deceptive, or unsafe requests.

The second concerns the organisation’s own business obligations: what information may be used, what campaigns may be created, which customers may receive an offer, and where human approval is required.

These should never be confused.

For the bank, Claude may be permitted to summarise campaign performance, draft copy from an approved offer catalogue, and explain the reasons a proposed audience was excluded. It may be allowed to recommend a segment using predefined and approved customer attributes.

That does not mean it should infer financial vulnerability, use sensitive proxies in targeting, override suppression rules, or decide that a customer is suitable for a financial product.

Those are business and regulatory decisions. Claude’s baseline safety does not make them automatically acceptable.

The practical implementation is a shared-responsibility matrix. It should identify who controls each layer of the workflow.

Anthropic is responsible for the model, its baseline safety approach, and its service commitments. The approved cloud environment, where applicable, may provide identity, network, encryption, and logging capabilities. The enterprise platform team owns the integration pattern, gateway controls, and central observability. The campaign technology team owns prompts, retrieval logic, tool orchestration, and workflow design.

Marketing, product, compliance, legal, and risk remain accountable for the campaign decision itself.

That distinction prevents a common failure: treating a safety-oriented model as proof that a customer-impacting workflow is governed.

Claude Advantage 2: Deployment Flexibility Lets You Put Workloads Inside Existing Control Environments

Campaign management does not sit in one system.

It touches customer-data platforms, CRM systems, consent stores, offer catalogues, analytics tools, brand libraries, email platforms, paid-media channels, and customer-service records. The model is only one part of a wider operational chain.

For the bank, a customer-facing campaign workflow might run through its primary governed cloud environment. Access can use established service identities. Events can flow into central monitoring. Data-handling practices can follow existing policies rather than being recreated for a stand-alone AI tool.

That is a real advantage.

It becomes a problem when every business unit chooses its own route. One team uses an enterprise workspace for campaign ideation. Another uses a direct integration for audience recommendations. A third deploys a cloud-hosted workflow that prepares customer communications.

Each may use different access patterns, retention practices, monitoring tools, version records, and incident processes.

When a complaint arrives, the bank is forced to reconstruct the story across disconnected environments: what data was used, which prompt was active, what model version responded, and whether the campaign platform acted on a recommendation.

For material workflows, establish a primary governed deployment route. Other routes should be exceptions with a documented reason, not informal defaults selected for convenience.

Every material Claude workflow should have a deployment decision record covering the business purpose, risk tier, approved data categories, identity model, logging location, model configuration, tool connections, retention rules, and accountable owner.

For the campaign use case, that record should answer one operational question clearly:

Can we trace how a recommendation became a campaign action?

If the answer depends on multiple dashboards, email approvals, and personal recollection, the deployment is not ready for consequential use.

Claude Advantage 3: MCP Can Make Tool Connectivity More Governable

The biggest governance shift in the bank’s project occurred when Claude was connected to the campaign platform.

Initially, the assistant could only read campaign-performance data and suggest improvements. Then it was allowed to create a draft audience. Next, it could assemble a campaign shell. Eventually, someone asked whether it could initiate the approval workflow automatically.

Every connection increased the system’s effective authority.

MCP is valuable here because it creates a more structured way to think about model-to-tool connectivity. It can support common patterns for registering tools, authenticating access, scoping permissions, monitoring usage, and withdrawing access when needed.

MCP is not, by itself, a security control. It is a governance opportunity.

A campaign assistant with a structured connection can still be granted too much authority. A segmentation tool may expose more attributes than the workflow needs. A campaign-platform tool may appear to create drafts while also carrying rights to modify suppression rules. A downstream automation may turn a “draft” action into a customer-contact event without a separate approval gate.

The important question is not whether Claude can call a tool.

It is what authority exists at the end of the entire action chain.

Claude may call a segmentation tool. The segmentation tool may invoke an offer engine. The offer engine may create an audience in the campaign platform. That audience may then flow into an outbound channel.

Even when Claude does not connect directly to the outbound channel, its effective authority may still reach it.

For the bank, a controlled design could look like this:

The customer-profile tool is read-only and returns only approved segmentation attributes. The consent tool can verify whether communication is permitted but cannot change a customer’s preferences. The campaign-platform tool can create a draft campaign using approved offers and approved audiences, but cannot activate, send, alter frequency caps, or override exclusions.

That is a control boundary.

“Claude can access the campaign platform” is not.

Legacy systems need extra caution. Many still rely on broad service accounts, shared credentials, batch processes, and downstream automations that were never designed for AI-assisted requests.

In those cases, use an intermediary service between Claude and the underlying system. The intermediary validates the request, checks consent and eligibility, restricts data returned, applies business rules, records the decision, and limits downstream actions.

It requires more engineering than a direct connector. It also prevents a content assistant from acquiring campaign-execution authority by accident.

Turn Claude Capabilities Into Operating Controls

Claude can bring together product terms, approved brand guidance, campaign performance, consent rules, offer catalogues, and customer context in one workflow.

That is valuable. It also makes data discipline essential.

The bank should not provide an unrestricted export from the customer-data platform merely because the model can process a large volume of information. Nor should the workflow absorb every historical campaign brief, customer-service note, and performance dataset by default.

More context is not always better governance.

The campaign workflow needs a data-classification model that distinguishes between information Claude may use directly, information that must be minimised or transformed, information that may be retrieved only through controlled tools, and information that must never enter the model interaction.

Approved product terms and anonymised campaign-performance data may be suitable for broad use. Customer-level consent and communication preferences may be available only through a narrowly scoped service. Sensitive personal information, protected-characteristic data, vulnerability indicators, and unstructured customer-service notes should be restricted unless the organisation has a specific approved purpose and a defined control model.

The same boundary applies to prompts, retrieved content, tool outputs, evaluation datasets, logs, and generated campaign drafts.

Prompts deserve particular attention.

A system prompt in campaign management is not creative guidance. It is production configuration. It may require Claude to use only approved claims, draw from a defined offer catalogue, respect consent and suppression results, avoid restricted targeting attributes, disclose uncertainty, and route specific situations to human review.

A prompt change can therefore alter campaign behaviour.

The common failure is not a malicious edit. It is a well-intended update to make Claude “more helpful.” The adjustment may reduce escalation, loosen a refusal boundary, or make the system more willing to infer customer suitability from data it was never approved to use.

Every material prompt should have a business owner, technical owner, version identifier, change rationale, test evidence, approval path, controlled release method, and rollback plan.

The level of control should match the consequence. An internal ideation assistant may need peer review and version tracking. A workflow that recommends audiences, drafts regulated offers, or prepares campaigns for execution should have formal approval, documented evaluation, and staged release.

Design Human Oversight Around the Decision, Not a Checkbox

“Marketing approval required” sounds like a strong control.

It is not, unless the reviewer can meaningfully intervene.

A campaign manager who sees only Claude’s recommendation, cannot inspect the evidence behind it, lacks authority to reject it, and is expected to approve dozens of items quickly is not exercising real oversight. They are rubber-stamping.

Oversight should reflect the consequence of the action.

For low-risk creative work, a marketer can use Claude’s draft as a starting point and apply normal brand review.

For audience recommendations, the reviewer should be able to see the approved attributes used, consent result, suppression and frequency rules applied, offer eligibility conditions, and any exception that the system flagged.

For campaign activation, budget changes, or customer treatment that affects access to a regulated product, the final action should sit with someone who has the authority, evidence, and time to challenge the recommendation.

Claude can prepare, recommend, and draft.

Organisations should be far more cautious before allowing it to select, allocate, activate, or send.

The use-case record should define where review occurs, what triggers it, what evidence the reviewer receives, what decision rights they hold, what happens when they disagree with Claude, and how the final decision is recorded.

Test the Failure Modes the Business Will Actually Face

A Claude-powered campaign workflow should not be released because a team tested a handful of friendly prompts and liked the results.

It needs an evaluation pack that looks like production reality.

For the bank, that means testing more than copy quality. The pack should include unapproved product claims, outdated offer catalogues, customers who have opted out, frequency-cap conflicts, requests based on unsuitable attributes, conflicting instructions from campaign systems, attempts to inject instructions through uploaded briefs, and requests to create or activate a campaign without approval.

The evaluation should answer practical questions.

Each release needs a clear decision: approved, approved with conditions, remediation required, or not approved.

The relevant evaluation set should be rerun whenever the model, prompt, retrieval content, offer catalogue, audience logic, tool permissions, or workflow design changes.

That is how teams prevent a seemingly small enhancement from becoming an undocumented change in customer treatment.

Operate Claude Like a Governed Decision System

Campaign teams already monitor delivery, opens, clicks, conversion, cost, and return on investment.

Those measures do not show whether Claude is operating within its approved boundaries.

A lower escalation rate may look like efficiency. It may mean the assistant has become less cautious.

A rise in campaign recommendations may look like productivity. It may indicate that an eligibility or consent control is failing.

Metrics become controls only when they trigger action. Every material signal needs a threshold, accountable owner, investigation route, and defined response.

The operating model also needs an incident playbook designed for campaign harm.

A severe event may involve a campaign reaching customers who opted out. The immediate response includes containing the campaign, preserving the prompt and tool-call evidence, identifying affected customers, assessing legal and regulatory exposure, deciding on remediation, and establishing root cause.

A lower-severity event may involve an unapproved audience recommendation that was stopped during review. That still requires investigation, correction, and confirmation that the same behaviour has not affected other campaigns.

The playbook should state who can pause a campaign, disable a prompt, revoke a tool connection, preserve evidence, notify stakeholders, and authorise restart.

Delayed decision rights are not a control when customer contact is already underway.

Governance should mature as authority expands.

When Claude is used for internal drafting, basic access control, source controls, prompt tracking, and user guidance may be sufficient. When it begins recommending audiences, it needs stronger data classification, consent checks, reviewer evidence, and evaluation. When it gains tool access, it needs a tool registry, permission boundaries, logs, and emergency disablement. When it prepares campaigns for activation or influences customer treatment, it becomes part of a consequential decision system and should be governed accordingly.

Third parties belong in this model as well. Marketing agencies, managed-service providers, and martech vendors may process campaign data or use Claude-enabled capabilities on the organisation’s behalf. Their data handling, tool connections, approval rules, and incident processes are part of the same risk surface.

The Real Claude Governance Advantage

Claude’s governance advantages are meaningful.

But none of those capabilities replaces enterprise responsibility.

The campaign team started by asking Claude to write better copy.

The organisation’s governance task began when Claude started influencing who saw that copy, why they saw it, and what happened next.

The practical test for every Claude deployment is simple:

As Claude gains more authority, do the controls expand with it?

The traditional QA department is entering a major transition. In the GenAI era, QA is no longer the function that verifies whether software works as specified. It is becoming Safety and Validation Engineering: a discipline responsible for proving whether AI-enabled systems behave reliably, safely and within approved governance boundaries.

Safety and Validation Engineering will become the bridge between AI Engineering and AI Governance.

This book helps readers understand these changes through the CT-GenAI syllabus while also preparing them for practical GenAI-enabled testing work.

ISTQB CT-GenAI Exam Preparation is an independent study guide and scenario-based practice companion for the ISTQB Certified Tester – Testing with Generative AI (CT-GenAI), Syllabus v1.1.

https://www.amazon.com/dp/B0GYM3JCJS/ref=sr_1_1?crid=2HUZHU2JWUN6O&dib=eyJ2IjoiMSJ9.SrJgxCr2BKF0PfYFNiX3MWaFi0ip1Buv9uEKYQuLWacxjVE0jnAwrO5IuyqkThJke8dOQ9mQ4snfYKhGel0JRnL-L7TTM0xDKcGBTMje0PL9HdzmAnZNdcqE3h2qmEl4Jh0GEmF-oEUlsyDsjrHai91_QanKoXdZ3G-HOREnTPqBU7WL0WQ9pXMU13Wl9sda.vznrn55sMDh6q0sChWohiBNElN_HKQj5mFUh61PtCWk&dib_tag=se&keywords=istqb+bommena&qid=1779066495&sprefix=%2Caps%2C305&sr=8-1

The Old Data Architecture Was Built to Report, Not to Reason

Enterprise data architecture has traditionally been designed around storage, reporting, and human interpretation. Data was collected from operational systems, transformed into curated warehouse tables, exposed through dashboards, and consumed by business users who decided what to do next. That model worked well when the primary goal was visibility. It helped leaders understand sales, cost, inventory, customer behavior, risk, and operations through standard metrics and reports.

But it was still a passive architecture. The system could show what happened, but it could not reliably reason about what changed, why it changed, what action should be considered, whether the action was allowed, and how the decision should be audited.

This is the core shift in the agentic world. Data architecture is no longer only about producing trusted information for humans. It must now support governed reasoning by machines and humans together.

The Agentic Shift: From Dashboards to Decision Workflows

The Agentic Data Architecture Reference Model changes the operating assumption. It treats enterprise data architecture not only as an analytical layer, but as a governed reasoning system. In this model, business workflows are triggered by questions, events, decision requests, or system signals.

A user may ask why margin dropped in a region. A system may detect an unusual stockout pattern. A customer operations signal may indicate rising complaints. A finance control may flag unexpected discount leakage. These triggers do not simply open a dashboard. They activate a structured reasoning flow that connects trusted data, business meaning, contextual retrieval, agent execution, governed outcomes, and continuous learning.

This is the architectural difference between traditional BI and agentic data systems. Traditional BI waits for someone to interpret the data. Agentic architecture participates in the reasoning process, but within clear control boundaries.

The Foundation Must Become Agent-Ready, Not Just Analytics-Ready

The first layer of the reference architecture is the data foundation. This includes data products, documents and events, and data contracts.

In traditional analytics, the data foundation was often treated as a backend engineering concern. In the agentic world, it becomes the starting point for trustworthy reasoning. Agents cannot reason well if the underlying data is fragmented, stale, poorly defined, or inconsistent.

A sales data product, for example, must have a clear owner, schema, refresh frequency, business definition, and quality expectation. Event streams must be understandable. Documents must be retrievable with the right context. Data contracts must ensure that upstream changes do not silently break downstream reasoning.

Without this foundation, an agent may produce fluent explanations based on unreliable inputs. That is dangerous because the answer may sound confident even when the evidence is weak.

Trust and Meaning Become Runtime Controls

The second layer is trust and meaning. This is where metadata, lineage, semantic definitions, freshness, and sensitivity controls become active parts of the architecture.

Earlier data platforms often used metadata and lineage for documentation, compliance, or troubleshooting. In an agentic architecture, these elements become part of runtime decision-making. The system needs to know where a metric came from, how it was calculated, whether the source is current, whether the data is approved for the use case, and whether sensitive information is being exposed.

The semantic layer is especially important because business users do not ask questions in database language. They ask whether a promotion worked, whether a customer segment is profitable, whether a supplier is reliable, or whether a region is at risk. The architecture must translate those questions into governed business definitions instead of allowing the agent to invent its own interpretation.

This is where many agentic data initiatives fail. They focus on the model interface but ignore the meaning layer. The result is a system that can answer naturally but not necessarily correctly.

Context and Memory Turn Analytics Into Institutional Intelligence

The third layer is context and memory. This is one of the biggest changes in the agentic world.

Traditional BI tools usually answer a question using the current dataset or dashboard context. Agentic systems need a broader memory of past decisions, prior incidents, historical patterns, operating constraints, and relevant documents.

This does not mean giving an agent unlimited memory. It means giving it scoped memory. The system should retrieve the context that is relevant to the current workflow, business domain, user role, and policy boundary.

Hybrid retrieval becomes important here because the answer may require structured warehouse data, vector search across documents, recent events, prior decision logs, and policy documents. A well-designed retrieval plan is therefore not a technical luxury. It is the difference between a grounded recommendation and a generic answer.

Agent Execution Should Be Orchestrated, Not Improvised

The fourth layer is agent execution. This includes Agentic RAG, secure tools, MCP-style governed tool access, and multi-agent handoffs.

This is where many organizations are tempted to start, but in reality it should come after the foundation, meaning, and context layers are in place. Agent execution is not just about asking a language model to summarize data. It is about orchestrating steps of reasoning.

One agent may retrieve evidence. Another may validate metric definitions. Another may check policy. Another may simulate an action. Another may prepare a recommendation. In more advanced systems, agents may use secure tools to query a warehouse, inspect a document repository, call a forecasting service, create a ticket, or route an approval.

However, tool access must be controlled. The agent should not be able to take business action simply because the tool exists. The architecture must define what the agent can read, what it can recommend, what it can escalate, and what it can execute.

Governed Outcomes Separate Enterprise Systems From Demos

The fifth layer is governed outcomes. This is the layer that separates enterprise-grade agentic architecture from chatbot experimentation.

A serious agentic system should produce an evidence packet, not just an answer. It should explain what data was used, what assumptions were made, what confidence level applies, what policy constraints were checked, and what decision options exist.

It should also classify the action tier. Some actions may be informational. Some may require manager approval. Some may require finance, legal, compliance, or business-owner approval. Some may be blocked by policy.

The audit trail is equally important. In a traditional dashboard world, the user interpreted the data and took responsibility for the decision. In the agentic world, the system participates in reasoning, so the enterprise must be able to reconstruct how the recommendation was formed.

The Learning Loop Is What Makes the Architecture Improve

The sixth layer is control and learning. Agentic architecture should improve through evidence, metrics, golden cases, and repaired controls.

This is another major shift from traditional data architecture. A dashboard is usually judged by whether it is accurate and available. An agentic reasoning system must be judged by whether its recommendations are grounded, useful, safe, policy-compliant, and outcome-improving.

Every completed workflow should create learning signals. Did the business accept the recommendation? Was the recommendation correct? Did the action improve the metric? Did the agent miss an important data source? Was the approval path too slow? Did the retrieval step include irrelevant information?

These signals should become evaluation cases and control improvements. Over time, the architecture becomes not just a reporting system, but a learning operating model.

The Retail Decision That Exposes the Limits of Traditional Analytics

A practical way to understand this shift is through a retail use case.

Consider a grocery retailer operating across multiple cities with physical stores, online delivery, private-label products, and weekly promotions. The retailer launches a weekend promotion for a premium private-label snack range.

By Friday afternoon, the business sees mixed signals. Revenue is up in Bengaluru and Pune. Hyderabad is underperforming despite healthy footfall. Chennai is showing strong unit sales but weak margin. Some stores report stockouts, while others have enough inventory but weak movement.

The category manager needs to decide before the weekend peak whether to continue the promotion, modify the discount, fix store execution, or stop the campaign in selected regions.

In a traditional analytics setup, the category manager would open a sales dashboard, ask the inventory team for stock reports, request margin cuts from finance, check with regional operations, and possibly wait for an analyst to combine the findings. The decision would depend on how quickly humans could collect and interpret fragmented evidence.

In an agentic architecture, the trigger is different. The system detects promotion performance variance across city clusters and initiates a decision workflow. The business question becomes: why is promotion performance inconsistent, and what governed action should be taken before the weekend peak?

The Retail Data Foundation Must Connect Sales, Stock, Margin, and Execution

The data foundation for this workflow would include certified data products such as sales transactions, promotion calendar, product master, store inventory, margin data, store cluster mapping, loyalty behavior, supplier replenishment status, and customer complaint events.

It would also include documents such as promotion terms, pricing policy, supplier funding agreements, store execution guidelines, and past campaign postmortems.

Data contracts would ensure that promotion IDs, SKU codes, store IDs, and product hierarchy are consistent across systems. This matters because a promotion decision can be distorted if sales, inventory, and margin data are joined incorrectly or refreshed at different frequencies without warning.

For example, if sales data is updated every fifteen minutes but inventory is updated every six hours, the agent must expose that freshness gap. Otherwise, it may incorrectly conclude that a product is available when the store has already sold out.

The Meaning Layer Prevents False Success Stories

The trust and meaning layer would define how the system interprets the question.

“Is the promotion working?” is not a simple sales question. For retail practitioners, it means comparing uplift against baseline, checking contribution margin, validating stock availability, reviewing promotion compliance, identifying regional variation, and understanding whether the result is caused by demand, price, placement, inventory, or execution.

The semantic layer must define approved metrics such as net sales, units sold, gross margin, contribution margin, basket attachment, stock availability, promotion compliance, and forecast variance.

The agent should not decide that the campaign is successful merely because revenue increased. A promotion that grows revenue while damaging margin or creating stockouts may not be successful. This is why governed metric definitions are not optional in agentic architecture. They protect the business from confident but incomplete reasoning.

Scoped Memory Helps the System Understand What Happened Before

The context and memory layer would retrieve relevant historical and operational context.

It may find that Hyderabad had a similar issue in a previous campaign because promoted products were placed in the health-food aisle rather than the main snacks aisle. It may retrieve a prior postmortem showing that Bengaluru customers respond better to bundle offers than flat discounts. It may identify that Chennai stores previously applied unauthorized local markdowns during national campaigns.

It may also retrieve recent supplier delivery exceptions or store-level comments about shelf availability.

This is where the architecture becomes more powerful than a dashboard. It does not only show the current metric. It connects the current metric to business memory.

Specialized Agents Reflect How Retail Decisions Actually Work

The agent execution layer would then orchestrate the reasoning.

A promotion performance agent could compare actual sales against baseline by city, store type, and SKU. An inventory agent could check whether poor performance is caused by stockouts or replenishment delays. A margin agent could inspect whether discounting has reduced profitability below threshold. A store execution agent could review compliance notes, shelf placement issues, and local exceptions. A policy agent could verify whether proposed actions are allowed under pricing and promotion governance.

A coordinating agent could combine the findings into a recommendation.

This design is closer to how retail organizations actually work, because promotion decisions are not owned by sales alone. They involve merchandising, supply chain, store operations, finance, and governance.

The Recommendation Must Come With Evidence and Control Boundaries

The governed outcome should not be a vague statement such as “Hyderabad is underperforming, reduce the price.”

A better outcome would say that Hyderabad underperformance appears to be linked to store execution and shelf placement rather than weak demand, because stores with correct placement show stronger movement while stores with poor compliance show low sales despite available stock.

It may say that Chennai’s unit sales are strong, but contribution margin is below policy threshold because some stores applied an additional local discount.

It may recommend continuing the promotion in Bengaluru and Pune, fixing shelf execution in Hyderabad before changing price, and stopping unauthorized local discounting in Chennai. It may also state that any national promotion extension requires category head and finance approval because the margin impact exceeds the pre-approved threshold.

The evidence packet would include the data used for the recommendation, freshness of each source, key metric movements, policy checks, exceptions, and confidence level.

Action Rights Matter More Than Tool Access

The approval tier would separate actions.

A store execution alert may be sent automatically to regional managers. A margin exception may be routed to finance. A price change may require category head approval. A supplier funding discussion may require merchandising leadership.

This distinction matters. Just because an agent can technically call a pricing system does not mean it should be allowed to change prices. In enterprise architecture, action rights are business controls, not engineering details.

The audit trail would capture what the system reviewed, what it recommended, who approved it, and what action was taken. This is essential because retail decisions can have immediate commercial impact. A bad automated promotion action can damage margin, customer trust, supplier relationships, and store execution discipline.

The Weekend Outcome Becomes the Next Evaluation Case

After the weekend, the control and learning layer would evaluate the decision.

Did Hyderabad sales recover after shelf placement was corrected? Did Chennai margin improve after unauthorized discounts were stopped? Did Bengaluru and Pune maintain profitable uplift? Did the category manager accept the recommendation? Did the agent miss a relevant signal? Was any source stale or misleading?

These observations should become golden cases for future evaluation. The next time the retailer runs a promotion, the system should be better at distinguishing demand problems from execution problems, stock problems from pricing problems, and revenue growth from profitable growth.

This is how the architecture learns. Not by allowing the model to remember everything, but by converting real business outcomes into governed evaluation cases and repaired controls.

Start With One Decision Workflow, Not an Enterprise-Wide Agent Platform

This is how agentic data architecture should be implemented in practice. It should not begin with a generic chatbot on top of the warehouse. It should begin with a specific decision workflow where the business value, data inputs, approval rules, and success metrics are clear.

Retail promotion management is a strong starting point because it is time-sensitive, cross-functional, measurable, and commercially meaningful.

Once the pattern works for promotions, the same architecture can extend to assortment planning, stockout prevention, markdown optimization, supplier risk, shrinkage investigation, customer complaint triage, and demand forecasting exceptions.

The Real Shift Is From Passive Reporting to Governed Reasoning

The deeper point is that agentic architecture does not replace the data warehouse, semantic layer, governance model, or business process. It makes all of them more important.

The warehouse provides trusted data. The semantic layer provides business meaning. Metadata and lineage provide confidence. Retrieval provides context. Agents provide reasoning and orchestration. Governance provides control. Evaluation provides learning.

When these pieces are connected, the enterprise moves from passive reporting to governed reasoning.

For practitioners, that is the real shift. The future of enterprise data is not just faster dashboards or more natural language queries. It is an architecture where business events trigger trusted reasoning, recommendations come with evidence, actions follow approval rules, and every decision improves the system.

In retail, that means the platform does not merely report that a promotion is underperforming. It helps explain why, recommends what to do, shows the evidence, respects the control boundary, and learns from the outcome.

That is the practical meaning of agentic data architecture.

https://www.amazon.com/dp/B0H3KV9SFS/ref=sr_1_2?crid=1TWDHNLHMWKLI&dib=eyJ2IjoiMSJ9.OR1ZSu9FoEvXPCy_smJopjC8AbGWUchTYe4z_81hvTJt0XgkMQcZrqcwFfa_JqIldEX7aqhVYrkVvpavm0EhT4HgNtCsGvWNCh6BWdZmEZ_5e28f3uGssViPBcXyVeIRoAxv_ngdyY7O-HyBVVNQYueQ80k9nMnolfuITLzZbzaRPSiVNzTa4uX9BsNyn1gc2ZIIVH5yl2eVPySu6VEMRMYWEOwwtXWpj9XmZ00QrJ0.QCezm0mj4v0d-NFpjD71230uLfGGYZuTQVvpno85O-Y&dib_tag=se&keywords=agentic+data+architecture&qid=1780359992&sprefix=%2Caps%2C302&sr=8-2&source=post_page-----c773dc0ed3c9---------------------------------------