Agent / system design

Published

A structured method for designing agents as systems.

A prompt gets you an answer. An agent goes and does things.

  1. Prompt
  2. Workflow
  3. Agent

What may this system know, decide and do?

PROMPT → WORKFLOW → AGENT

HOW TO DESIGN AN AI COLLEAGUE THAT CAN ACT

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4

Editorial diagram of a governed chain: a sealed mandate linked through authority and operation to assurance.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA01

START HERE

Before an AI can act for you, someone has to decide where it stops.

A prompt gets you an answer. An agent goes and does things in your systems, so you have to decide what it's allowed to touch.

This deck walks through those decisions one letter at a time, using two example agents: one in a bank and one in a clinic.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA02

WHY THIS EXISTS

A newer model won't fix an agent that was never told what it's for.

What people usually assume

If the agent gets things wrong, the fix is a better prompt or a newer model.
↓

What we see in practice

Most problems come from things nobody wrote down: what the agent is for, what it can open, and who checks its work. This deck helps you write that down. Your tech team builds the prompt, the access and the tests from it.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA03

DO YOU NEED AN AGENT?

1 · Is this a regular job for someone, not a once-in-a-while ask?

If no, a good prompt is enough: you give it what it needs, check the answer and decide what happens next.

Use PINPOINT to write that request well.

2 · Would they need to get into your systems or tools themselves, not just tell you what to do?

If no, set up an assistant with one clear job. It answers, and a person acts on what it says.

Use BLUE: the first four letters.

3 · Would a checklist fail because some cases are different, so they’d have to decide the steps as they go?

If no, it's a checklist: write the steps down and use ordinary software or a workflow. AI can still do one step inside it.

Three yeses means you're building an agent, and BLUEPRINT is how you describe it. Stop at the first no and use what it points to.

Anthropic, Building Effective Agents (19 December 2024): find the simplest solution possible and only increase complexity when needed, which may mean not building an agentic system at all.

A workflow is a job where you already know the steps. An agent is a job where something has to work out the steps each time. Most work that looks like it needs an agent is a workflow with one or two decisions inside it. A workflow with an AI step that gets into your systems still needs its limits written down: use BLUEPRINT for that step.

Wherever you stop, write down why in one sentence. It's the first question a reviewer will ask.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA04

OUR TWO EXAMPLES

Two agents we'll build together.

In a bank: Priya's meeting-briefing agent

Priya is a relationship manager. Before each client meeting she pulls notes together from several systems.

Her agent will do that for her: read what's relevant and hand her a one-page brief the evening before.

In a clinic: Dana's front-desk agent

Dana runs the front desk at a busy family clinic. Every morning she checks who's booked in, which forms are missing and who hasn't confirmed.

Her agent will prepare that list and draft reminder texts for her to check.

Each letter adds one decision to both agents. By the end you'll have a full description of each, and a template for your own.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA05

FROM AN IDEA TO A DESCRIPTION · PRIYA

Where most ideas start, and where they need to get to.

HOW THE IDEA USUALLY ARRIVES

“An assistant that helps relationship managers prepare for meetings. It should look up whatever is relevant for each client, in a professional tone. Don't give investment advice.”

This covers tone and one thing to avoid. It says nothing about what a finished brief looks like, what the agent can open, or who answers for it.

→

THE JOB

A one-page brief for Priya, ready the evening before each client meeting. Priya's team lead signs off on what a good brief contains.

WHAT IT DOES ALONE, AND WHAT IT ASKS ABOUT

It reads meeting notes and client records by itself. It asks before suggesting any follow-up. It gives no investment advice.

WHAT IT CAN OPEN

Only what Priya can open, through its own login. It can read, but it can't change or send anything.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA06

FROM AN IDEA TO A DESCRIPTION · DANA

The same step for Dana at the front desk.

HOW THE IDEA USUALLY ARRIVES

“Something to help the front desk get through the morning. It should check the bookings, chase patients who haven't filled in their forms, and sound friendly. Don't give medical advice.”

Friendly tone and one thing to avoid again. It doesn't say when the list is due, who may send a text to a patient, or what it can see in the booking system.

→

THE JOB

Tomorrow's patient list for Dana by 8am, with missing forms flagged and reminder texts drafted. The practice manager signs off on what a good list contains.

WHAT IT DOES ALONE, AND WHAT IT ASKS ABOUT

It checks bookings and forms by itself. Every reminder text waits for Dana to approve it. It never answers questions about symptoms or treatment.

WHAT IT CAN OPEN

Only this clinic's bookings, through its own login. It can draft texts, but it can't send them, change a booking or open medical notes.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA07

WHAT AN AGENT IS

An agent is AI with a goal and permission to act. It picks a step, does it, checks what happened, and keeps going until the job is done or it has to stop.

Decide→Do→Check→Decide again↺done, or stopped ↗

It still uses prompts. The difference is that it keeps going by itself.

A workflow follows steps someone wrote down in advance. An agent works out its own steps as it goes (after Anthropic, Building Effective Agents, 19 December 2024).

Simon Willison, 18 September 2025: “An LLM agent runs tools in a loop to achieve a goal.” In other words, an AI that keeps using your systems, step by step, until it gets there.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA08

PROMPT OR AGENT?

With a prompt, you decide each step. With an agent, it decides.

A promptAn agent
Who decides the next stepYouThe agent
How often it asks the AIUsually onceMany times, one step after another (in a loop)
What you get backTextText, plus things it has done
What it carries between stepsWhatever you paste inIts own notes on what it has done so far
When it goes wrongYou get a bad answerSomething gets done that shouldn't have

That last row is why an agent needs its job and its limits written down.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA09

WHERE BLUEPRINT SITS

LevelWho decides the next stepFramework
PromptYou, each timePIN / PINPOINT
WorkflowA path written down in advancePINPOINT for each step
AgentThe AI, within limits you setBLUEPRINT
Several agentsEach agent, within its own limitsOne BLUEPRINT per agent

Most real systems are a mix. If only one step needs the AI to decide, describe it as a workflow with one smart step.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA10

THE FIRST FOUR LETTERS

BLUE

Start with the least structure that works.

B

Behaviour & Values

What should it put first, and what does it do when unsure?

L

Limits

What can it do alone, what must it ask about, and what is off-limits?

U

Use Case & Outcome

What is the one job, who is it for, and what does finished look like?

E

Examples

What does a good result look like, and have you tried the awkward cases?

BLUE is enough for an assistant that only answers questions. Once it can open systems or do things, add PRINT.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA11

BLUE · B

B Behaviour & Values

Give it a ranked list of what matters.

Why it mattersRules cover the cases you thought of. Something will come up that you didn't, and the agent needs to know what matters most when it does.

Priya's briefing agent (bank)

Accuracy comes before speed. If two records disagree, it says so. If it isn't sure, it does less and tells Priya why.

Dana's front-desk agent (clinic)

Patient privacy comes first, then accuracy, then getting the list out on time. If a booking looks odd, it flags it for Dana.

Write downYour agent's top three priorities, in order. When two clash, which one wins?

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA12

BLUE · L

L Limits & Autonomy

Sort everything it might do into three lists.

Why it mattersAn agent will try whatever seems helpful. Without clear lists, it has to guess where your line is. Reading counts too: opening a file is an action.

Priya's briefing agent (bank)

Just do it: read meeting notes. Ask first: suggest a follow-up. Off-limits: recommend investments.

Dana's front-desk agent (clinic)

Just do it: check the day's bookings. Ask first: send a reminder text. Off-limits: give medical advice or move an appointment.

Write downThree lists: just do it, ask first, off-limits. If something isn't on any list, it stops and asks.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA13

BLUE · U

U Use Case & Outcome

One job, one person who answers for it, and a clear picture of finished.

Why it mattersAn agent with a vague job drifts into other work. When something goes wrong, nobody is sure whose call it was.

Priya's briefing agent (bank)

A one-page brief for each client meeting, ready the evening before. Priya's team lead answers for it.

Dana's front-desk agent (clinic)

Tomorrow's patient list, with missing forms flagged and reminder drafts ready by 8am. The practice manager answers for it.

Write downThe job in one sentence, the named person who answers for it (a person, so no team names), and what finished looks like.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA14

BLUE · E

E Examples & Evaluation

Collect examples of good and bad, then test it on the awkward ones.

Why it mattersAn agent can reach a good answer the wrong way, for example by opening something it shouldn't. It can also answer the same question differently on different days.

Priya's briefing agent (bank)

Test a normal meeting, a client with out-of-date records, two systems that disagree, a record Priya can't open, and a request it must refuse.

Dana's front-desk agent (clinic)

Test a normal morning, a double booking, a patient with no phone number, a record from another clinic, and someone asking it for a diagnosis.

Write downFive test cases, including one it should refuse. Agree the pass mark before you run them, and run each one more than once.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA15

THE NEXT FIVE LETTERS

PRINT

Add these once the agent can open systems and do things.

P

Permissions & Identity

What can it open?

R

Reliability & Recovery

What if something breaks?

I

Interfaces & Handoffs

Which systems does it use, and when does it hand over to a person?

N

Navigation & Orchestration

What are the steps it follows, and when does it stop and/or escalate?

T

Trusted Context & Memory

What does it read and keep?

BLUE describes the job. PRINT describes how it gets done safely inside your systems.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA16

PRINT · P

P Permissions & Identity

Telling it isn't the same as stopping it.

Why it mattersIf we only tell the agent “don't look at other advisers' clients”, it can still try. A block in the system makes it impossible.

Priya's briefing agent (bank)

Set it up like a new joiner's login. It has its own login, so we can see what it did. It can only open what Priya can open. For now it can read, but it can't change or send anything.

Dana's front-desk agent (clinic)

It signs in as itself and sees only this clinic's bookings. It can draft reminder texts. They go out only after Dana approves them.

Write downWhose access does it borrow, and what is it blocked from?

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA17

PRINT · R

R Reliability & Recovery

Decide what happens when something breaks.

Why it mattersSystems go down, data goes out of date and AI models get updated. An agent that quietly guesses its way past a problem does more harm than one that stops.

Priya's briefing agent (bank)

If the client records system is down, Priya still gets a brief, marked incomplete, saying which part is missing.

Dana's front-desk agent (clinic)

If the booking system times out, it stops, tells Dana which patients it hasn't checked, and sends nothing.

Write downWhen it gets stuck: what it does, who hears about it, and how you undo anything it already did. Keep a full record of every run, like a flight recorder.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA18

PRINT · I

I Interfaces & Handoffs

Before it uses a tool, write down what the tool does and what it can break.

Why it mattersThe agent only knows a tool by its description. If “no record found” and “access blocked” look the same, it may tell Priya a client has no history when it was locked out.

Priya's briefing agent (bank)

The calendar tool reads meetings. The client records tool reads notes and can't change them. Each one says clearly when it's empty, broken or blocked.

Dana's front-desk agent (clinic)

The booking tool reads appointments. The text tool can send only drafts Dana has approved. If it fails, it says so.

Write downFor each tool: what it's for, what it changes, and what it says when it fails.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA19

PRINT · N

N Navigation & Orchestration

Fix the steps you already know. Let the agent decide only where it has to.

Why it mattersThe more steps the agent chooses, the harder it is to predict. Most jobs are a fixed path with one or two judgement calls inside.

Priya's briefing agent (bank)

Find tomorrow's meetings, pull the records, write the brief. The agent decides only what's relevant for each client. If sources disagree, it stops and asks Priya.

Dana's front-desk agent (clinic)

List the bookings, check the forms, draft reminders. The agent decides only how to word each reminder. It stops when the list is done or it hits something it can't handle.

Write downThe steps that are always the same, the one or two it decides, and when it should stop.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA20

T · TRUSTED CONTEXT & MEMORY

A man frowning at an overstuffed filing cabinet full of duplicate folders

A messy filing cabinet makes a messy AI.

Imagine the smartest analyst in the world, with a bad filing cabinet. The AI may be brilliant. Its information may not be.

Context engineering

Context engineering is deciding what the agent gets to see before it answers: the right documents and data, the effective version, filtered for the person using it. Everything on the next page is part of it.

What goes in: duplicated, stale, over-shared and unlabelled files. What comes out: confident, wrong answers.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA21

T · TRUSTED CONTEXT & MEMORY

Check what it reads, and who it reads it for.

Every document and record shows three things

This goes for data as well as documents. Every document or record the agent uses should show who owns it, who's allowed to see it, and whether it's the effective version on that date.

“Effective” means it's the version people are meant to follow today. It isn't an old one that's been replaced, and it isn't a draft that hasn't been approved yet. If there are three travel policies and none is marked effective, the agent will pick one and sound sure about it.

Filter by the person before the agent sees anything

Data has access rules too. A customer's details should only be visible to the relationship manager who looks after that customer. If you already have a system that controls this, such as a customer entitlement system, use it to filter the data for the person using the agent before it reaches the agent.

The same goes for documents. Otherwise a paper meant only for the management committee or the CEO can end up in an answer to an employee who was never meant to see it, or the agent may mention that the paper exists at all.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA22

PRINT · T

T Trusted Context & Memory

Decide what it gets to see before it answers, what it trusts most and what it keeps.

Why it mattersAgents read a lot. Some of it is out of date, some of it contradicts itself, and some of it might be an email saying “ignore your rules”.

Priya's briefing agent (bank)

The client records system outranks old emails. Every fact shows its date. If an email tells it to ignore its rules, it flags the email to Priya. It keeps nothing once the meeting is over.

Dana's front-desk agent (clinic)

The booking system outranks old phone notes. If two records clash, Dana sees both. It keeps no patient details after the day's list is done.

Write downIts sources in order of trust, how old is too old, and what it may remember.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA23

MY VIEW ON "HUMAN IN THE LOOP"

A person in the loop only helps if they can say no.

1983: he broke the loop

Stanislav Petrov's early warning system reported incoming US missiles. Protocol said escalate. He questioned it instead, and it was a false alarm caused by reflected sunlight. He didn't save the world by being in the loop. He saved it by being willing to break it.

A rubber stamp isn't a safeguard

Too often the person is the last signature on a recommendation made somewhere else, in a hurry, with little context and pressure to approve. The real danger is people who stop thinking because the machine sounds confident.

People get tired

We make worse calls when we're tired, rushed, in a bad mood, or late in the day after a long run of decisions. Adding one more approval step doesn't fix that.

What works better

The agent keeps learning each person's preferences and sticks strictly to the limits you set earlier: what it does alone, what it asks about, and what it can open. People are asked only where their judgement changes the outcome, with the time and context to say no. Priya gets one flagged follow-up to decide, not forty approvals. Dana approves the reminder texts, not every booking check.

Better questions to ask: Where does a person's judgement change the outcome? What happens when they say no? Do they have the time and context to challenge it? Who answers for it when it's wrong? Can you switch it off?

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA24

WHY "ASK FIRST" NEEDS CARE

People stop reading approval requests.

3%of one-at-a-time “can I do this?” requests were turned down.
39%of whole plans were turned down when people saw all the steps together.
13.6%of planted dangerous commands were caught by the people approving.
89%of the same commands were caught by an automated check.

People also got worse with practice. After about 50 requests, they caught around 5% of the dangerous ones, down from about 17%.

What this means for your agent: ask people to approve the whole plan, and let the system block anything that should be impossible. These numbers come from AI coding sessions, and we're assuming they carry over to other kinds of approval. Source: claude.com/blog/auto-mode-default-in-claude-code · 7 August 2026 · 1,053 testers.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA25

CHECK YOUR DESCRIPTION

Three questions before you hand it over.

01For everything on your “off-limits” list, is there a system block and a test that proves it holds?
02For everything on your “ask first” list, do you know who gets asked and how?
03Is anything you can't undo sitting on the “just do it” list? Move it.

The agent doesn't mark its own homework. A person or a fixed rule does.

The full nine-letter check is in the “For the builders” section at the back.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SA26

WHY AGENTS GO WRONG OVER TIME

Too tight, too loose, or slowly drifting.

Overfitting: too tight

The agent learned its examples and past preferences so closely that it stumbles on anything new.

Like a new joiner who memorised last year's answers but never understood the questions.

Causes: too few or too similar examples, and memory that treats one person's habit as a rule. Priya once asked for short summaries; now every client gets three lines, even on a complex loan.

Underfitting: too loose

The rules and examples are too thin or vague, so the agent gives safe, generic answers.

Like a temp told only to “help visitors”.

Causes: vague instructions, missing examples and no clear “done”. Dana's agent greets everyone the same way and can't handle a delivery or a VIP.

Drift: slowly changing

Behaviour that was fine at launch shifts a little at a time.

Causes: AI model updates, memory piling up, changed policies or data, and small edits to the instructions that nobody tested again.

None of these announce themselves. That's why the next page is about testing again whenever anything changes.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA1

KEEPING IT UP TO DATE

When anything changes, test it again.

Writedescribe the agent using the nine letters.
Testrun your test cases against the pass marks you agreed.
Launchswitch on the approved version.
Watchnote failures, hand-offs and what people corrected.
Reviewa person decides whether the description needs to change.
Updatesave the new description, access, tools and tests together as a new version.

When the instructions, the tools or the AI model change, treat it as a new version and test it again before it goes live. Corrections from people are evidence for the next review. The agent doesn't rewrite its own rules.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA2

IS IT CLEAR ENOUGH?

Could someone from risk or audit read it and understand:

1what the agent is supposed to do
2what it is allowed to do
3how it is tested
4who answers for it
5and how it can fail

Then try one real run. Pick a single piece of work the agent did. Can you show what it looked at, what it was allowed to do, which checks ran, what the person saw and changed, who decided, and what went out?

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA3

THE FULL JOURNEY

01PIN

Define the task

02PINPOINT

Write the request and check the result

03BLUEPRINT

Describe the AI colleague

BLUEPRINT is the job description.

Your systems make sure it's followed.

EVOLVE

tells you how much to trust it as you grow.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA4

TAKEAWAY

Every agent that works well had someone decide its limits first.

Start with BLUE. Add the PRINT letters once it can open systems and do things. The template is at the back.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA5

FOR THE BUILDERS · GLOSSARY

The words you'll hear, in plain English.

TermWhat it meansThink of it as
Agent / agenticAI that does several steps by itself, using your systemsA new hire who can log in
Delegated authorityWhat it's allowed to do without askingA spending limit on a company card
Specification (spec)The written job description and rulesJob description plus policy manual
Deterministic checkA fixed rule in the system, with no AI opinion involvedThe card machine declining the payment
Effective permissionIt can see no more than the person it works forAn assistant using their boss's access
Authorise before retrievalCheck access before it reads anything. Once read, it can't be unreadYou can't un-tell a secret
Fail closedIf unsure, do nothing and askA door that locks when the power goes
Non-deterministicIt can give different answers to the same questionTwo colleagues, two drafts
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA6

FOR THE BUILDERS · GLOSSARY

More terms.

TermWhat it meansThink of it as
Evals, pass bars, adversarial casesTests, agreed pass marks, and tests where someone tries to trick itA driving test with a set score
Replayable recordA full log, so you can show exactly what happened laterA flight recorder
Pinned modelThe AI version is locked. Changing it means testing againNo engine swap without a new MOT
DriftIt slowly gets worse as things around it changeA sat nav with old maps
Side effect, retry safetyWhat a tool changes, and whether it's safe to try twicePressing “pay” twice
OrchestrationHow the steps are arranged and who picks the next oneA recipe, or a chef improvising
Context, state, memoryWhat it's looking at now, where it is in the job, what it keepsToday's notes and the client file
MCP, APIsWays of connecting the agent to tools. BLUEPRINT works with any of themThe plug, whatever the socket
CRM, RMClient records system; relationship manager
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA7

FOR THE BUILDERS · TEMPLATE

Fill in the BLUEPRINT.

BBehaviour & Values
LLimits & Autonomy
UUse Case & Outcome
EExamples & Evaluation
PPermissions & Identity
RReliability & Recovery
IInterfaces & Handoffs
NNavigation & Orchestration
TTrusted Context & Memory

Three checks before you scale it. Know: can you trust what it reads? Do: can you control what it does? Prove: could you rebuild what happened six months from now?

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA8

CHEAT SHEET · THE NINE LETTERS IN PLAIN WORDS

B

Behaviour & Values

Write down what matters most, in order, and which one wins when two clash. It only says a job is done once the system confirms it.

L

Limits & Autonomy

Reading isn't acting. Place each action on the ladder: suggest, draft, act with a named person's approval, or act alone. If something isn't on the list, it stops and asks.

U

Use Case & Outcome

One job, for one person, with one named person who answers for it. Note what starts it, who it affects and how the work is done today, so you can tell whether it helped.

E

Examples & Evaluation

Test a normal day, the awkward cases, someone trying to trick it (for example, hidden instructions in a document), things breaking, and a request it must refuse. Agree the pass mark first. The safety checks must pass every time.

P

Permissions & Identity

The agent only sees what the person it's working for can see (see Trusted Context, T). It has its own login, never a shared one, so you can always tell what it did.

R

Reliability & Recovery

If something breaks, it stops safely and there is a plan to undo or put right anything it changed. Keep a simple receipt for every answer, allowed or refused: where it came from, which version, who checked it. Keep records nobody can edit.

I

Interfaces & Handoffs

For each tool, write down what it's for and what it can change. “Nothing found”, “it broke” and “not allowed” must look different to the agent.

N

Navigation & Orchestration

Fix the steps you already know. It stops when the job is done, the budget runs out, it's stuck, it's blocked or it's outside its limits, and says where it got to.

T

Trusted Context & Memory

Give it the right documents and data, and only the version in force on that date. Each one shows who owns it and who may see it. Anything the person can't see is filtered out before it reaches the agent (pages 21 and 22).

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA9

FOR THE BUILDERS · CROSS-LETTER CHECKS

The full consistency check.

01Every “never” rule is blocked in Permissions (P) and checked by a test in Evaluation (E).
02Every “ask first” rule names who is asked in Interfaces & Handoffs (I) and is checked by a test in Evaluation (E).
03Nothing that can’t be undone sits on the “always” list.
04“Done” is defined in Use Case & Outcome (U), when to stop in Navigation (N), and what to do when things fail in Reliability & Recovery (R).
05Everything the agent saves to memory is labelled under Limits & Autonomy (L), so you know what it may keep.

The agent never sets its own permissions, marks its own work, or decides whether its own safety checks run.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA10

FOR THE BUILDERS · TOOLS AND FLOW

Tool contracts and how the work moves.

purposeinputoutputside effect: read / write / actretry safetyfailure shape
single call→fixed sequence→router→parallel workers→orchestrator + workers→evaluator loop→autonomous loop
  • Tool names and descriptions work like prompts. Write them like a brief for a new hire.
  • A handoff between agents or people is a PINPOINT brief: purpose, context with evidence, a narrow ask.
  • BLUEPRINT doesn't depend on a protocol. MCP and APIs are implementation choices.
  • Move right along the path only when the job needs it.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA11

FOR THE BUILDERS · SEVERAL AGENTS

Adding agents adds no authority.

One BLUEPRINT per agent, and one agreed contract for each handoff.

MAKER

Produces the proposed result inside its own job, access and stop conditions.
→

CHECKER

Checks the evidence, the controls and the acceptance criteria on its own. It doesn't inherit the maker's access.
  • An agent receiving work gets only the permissions granted to its own role.
  • The strongest reason for a second agent in banking is maker-checker: one prepares, a separate one verifies.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA12

FOR THE BUILDERS · REPLAY ONE RUN

Can you replay one run?

A supervisor picks one AI-assisted client interaction. Every answer should already be in the record, and each one traces back to a part of the BLUEPRINT. European regulators will look closely at AI in investor-facing work from 2027 (ESMA has made it a Union Strategic Supervisory Priority).

The questionWhere it livesEvidence kept
Why this client, and why this insight?Use Case (U), Trusted Context (T)trigger, context used, as-of dates
What did it use, and which model and version produced it?Trusted Context (T), Reliability (R)sources as of that moment, pinned model, spec version
What was it allowed to do, and which controls ran?Limits (L), Permissions (P), Evaluation (E)effective permissions, each control and its result
What did the person see and change, and who decided?Limits (L), Use Case (U), Reliability (R)proposed versus approved, why, named approver
What went out to the client?Handoffs (I), Reliability (R)the exact message sent
Can the bank reproduce it later?Reliability (R), version recordkept record, retrievable version
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA13

FOR THE BUILDERS · SHARED WITH PINPOINT

Evidence labels

[Verified Source]
[Inference]
[Assumption]
[Unverified]

Labels for “I checked this” and “I'm guessing”. In PINPOINT you ask for them in a single request. In BLUEPRINT the agent uses them all the time: Behaviour & Values (B) requires them, and Trusted Context (T) enforces them.

The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA14

FOR THE BUILDERS · READ

Daily meeting-briefing agent

Read→Propose→Act

Low autonomy · read-only · relationship-led financial services

Job

Before a scheduled client meeting, put together a one-page brief from authorised records for the assigned relationship manager.

Trigger

A client meeting is in the calendar for the next working day.

Flow

find relevant records → spot recent changes → write the brief → flag gaps → finish.

Always do

Read authorised information; summarise recent changes; separate fact from inference; flag stale or conflicting information.

Ask first

Nothing in normal running.

Off-limits

Changing source records; sending messages; recommending anything outside its job.

When it fails

If a source is down or an access check fails, it produces an incomplete brief that names the missing source. It doesn't guess to fill the gap.

Why it matters

The agent chooses what to read and how to put it together. Its authority to act on the client relationship stays close to zero.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA15

FOR THE BUILDERS · PROPOSE

Client follow-up agent

Read→Propose→Act

Approval before action · relationship-led financial services

Job

After a client meeting, prepare the follow-up message, the proposed actions and the record updates for the relationship manager to approve.

Trigger

The client meeting is marked complete.

Flow

meeting notes → pull out commitments → check supporting context → draft follow-up → propose CRM and task updates → ASK FIRST → carry out only approved actions → confirm.

Always do

Draft the message; list agreed actions and owners; prepare proposed system updates; flag unsupported statements.

Ask first

Sending the message to the client; writing or updating CRM records; creating follow-up actions that matter.

Off-limits

Changing wording after approval; inventing commitments; sending when required evidence is missing; treating silence as approval.

When it fails

If approval expires, the content changes after approval, or the send or update fails, it stops and reports exactly where things stand. It doesn't retry blindly.

Why it matters

The agent prepares everything. A person approves before anything goes out, and the description has to cover both.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA16

FOR THE BUILDERS · ACT

Operations exception agent

Read→Propose→Act

Bounded autonomy · relationship-led financial services

Job

Watch for service exceptions in client operations and fix standard, reversible cases within a written remit.

Trigger

A new exception arrives in the queue.

Flow

classify → gather evidence → pick an allowed fix → act → check the result → close or escalate.

Always do

Fix approved low-risk categories; gather the evidence needed; make reversible updates; record sources and actions; check the result afterwards.

Ask first

Anything outside set thresholds; changes the client will see; cases where policies conflict; anything above financial or reputational limits.

Off-limits

Getting round access controls; inventing a fix category; anything irreversible; carrying on after repeated failure.

Stopping safely

It stops when done, blocked, outside its remit, making no progress, or at a limit. It keeps its work, explains what it finished, names the blocked step and hands over to the named owner.

Why it matters

The agent chooses and acts, inside limits set before it runs. A named owner still gets anything it shouldn't finish.
The B.L.U.E.P.R.I.N.T. Intelligent Agent Framework v2.4 · © 2024–2026 Ahmed Muzammil · CC BY-SA 4.0CC BY-SAA17