Book Diagnostic — 49€
The layer above prompting · 2026 guide

Graph engineering: stop chatting, start designing the work.

Most people try to get better AI results with better prompts. The bigger gains come from designing the work around the model: which jobs run, in what order, who checks them, and where a human signs off. That is graph engineering.

By Alessandro Capezza, AI Coach Updated 6 October 2026 12 min read
01

Prompt engineering

How you ask a better question.

The wording
02

Context engineering

How you give the model better information.

The inputs
03

Graph engineering

How you design the work around the AI.

The workflow
Definition

What is graph engineering in AI?

Graph engineering is the practice of splitting an AI task into separate jobs, connecting them in the right order, and keeping a shared record of what the system knows. Instead of one long chat that tries to do everything, you get a managed workflow where each step has one owner and one output.

The model does not change. What changes is the structure around it. The same question, run as a graph, comes back researched from several angles, attacked by a checker, merged into a recommendation, and approved by you.

Three words: jobs, arrows, state

Job A Job B Job C State · the shared record every job reads and writes
01

Jobs

One step, one owner, one output. A job does one thing and finishes.

02

Arrows

What has to happen before what. If a step doesn't need the previous one, it shouldn't wait for it.

03

State

The shared record of what the system knows so far: notes, sources, drafts, decisions.

Sequential

One after the other

Classify the request, then look up the customer account. The second step needs the first.

Parallel

At the same time

Research customer pain, competitors and distribution together. None of them depends on the others.

The shift

Same question. Very different work behind the answer.

Old way · one chat

"Should I build this?"

  1. Ask the AI the question.
  2. Get a confident essay back.
  3. No sources, no challenge, no trail.
Graph way · managed workflow

"Should I build this?"

  1. A planner splits the question into lanes.
  2. Researchers run the lanes in parallel.
  3. A skeptic attacks the findings.
  4. A merger writes a one-page recommendation.
  5. You decide the next move.

The output is still a report. The difference is that the work was designed.

The qualifying test

Do you need a graph, or just a better prompt?

A graph earns its place only when the work has at least one of these six traits. Tick the ones that apply to a task you do every week.

Your result
None ticked: write a better prompt.
If none of the six apply, a graph is overhead. Spend the time on a sharper prompt and better context instead.
The first pattern to learn

The Diamond pattern

Split, attack, merge, then let a human decide. It works for any decision that needs evidence from several angles: a new product, a new market, a hire, a supplier.

01 · PlannerTurns the question into research lanes
02 · CustomerHow people handle the problem today
02 · CompetitorsWho already sells this, and at what price
02 · DistributionHow you would actually reach buyers
03 · SkepticAttacks the evidence. Weak claims don't survive.
04 · Merge + human yesSurvivors become a one-page recommendation. You pick the next move: interviews, a teardown, a small prototype, or pass.

The human decides the next move, not the model.

Ready-made pipelines

Five AI workflow templates you can copy

Three classics plus two built for small businesses. Every one has a checker that isn't the writer, and a human gate where a mistake would be expensive.

JobCheckerHuman gate

Customer support

Sequential · 6 jobs
Classify→Account context→Docs + policy→Draft reply→Check accuracy, tone, risk→Human: refunds + angry customers

Content

Sequential · 7 jobs
Research→Thesis→Examples→Hook→Script→Check specificity + pacing→Human: titles, thumbnails, captions

Code

Sequential · 7 jobs
Plan→Edit→Review the diff→Run tests→Check the UI→Hunt edge cases→Human approves the release

Quote or proposal

Parallel outputs · services businesses
Site-visit notes or call transcript→Price list + discount rules→Ops brief ∥ Technical brief ∥ Client quote→Check totals + format vs past quotes→Owner signs off

Weekly owner report

Parallel sources · operations
Jobs app ∥ Accounting ∥ Inbox ∥ Calls→Merge into one report→Flag gaps: overdue, unworked leads, missing notes→Owner picks this week's 3 actions
How it fits together

Prompt, agent, graph, AI employee.

These are not competing ideas. They are the same idea at four zoom levels. Each one contains the previous one.

01 · Prompt

One request

You ask, the model answers. Fine for one-pass work.

02 · Agent

One job, looping

Input → model → tool → result → back to the model, until the job is done. Build one small, narrow agent first.

03 · Graph

Jobs connected

Several jobs linked by arrows, with shared state, a separate checker and a human gate.

04 · AI employee

A graph that runs

The graph plus memory, a schedule and clear permissions: what it does alone, what it asks about, what stays yours.

The on-ramp · updated for 2026

Three levels of implementation

Start by hand. Add tooling only once the structure has proven itself. Current models such as Claude Opus 5.5 make every level easier, which makes skipping level 1 more tempting and more expensive.

1

Manual lanes

No code
  • Draw the graph on paper or a whiteboard first.
  • Run each lane as its own chat or document.
  • You are the state: you carry the outputs from step to step.

In 2026: run it inside one AI project. Save each lane's output as a project file, and the files become the shared state.

2

File trails

Light code
  • Use a code workspace such as Claude Code or a repository.
  • Every step writes its own file, giving you a trail you can compare and reuse.

In 2026: parallel lanes can run as subagents, and the skeptic can be a separate subagent that never saw the draft being written. That makes "the checker isn't the writer" real.

3

Orchestrated

Real tooling
  • LangGraph for state checkpoints and human-in-the-loop.
  • n8n or Make for Slack, email, Airtable and CRM triggers.

In 2026: try connectors to your real tools (accounting, CRM, inbox) plus scheduled tasks before you build a full orchestration stack.

The first rep is to draw the graph before you automate it.

What good looks like

Four traits of a good graph, and one trap.

01

No fake waiting

Steps run in parallel unless one truly needs the other.

02

Worker ≠ checker

The step that writes is never the step that reviews.

03

Human gate where it's expensive

Approvals sit where a mistake costs money or trust, not on every step.

04

It leaves a trail

Notes, sources, drafts and decisions stay behind, so the next run starts smarter.

The trap

More agents means more noise and more coordination cost.

From real coaching work

What graphs look like in real businesses

Anonymised examples from the people I coach. None of them started with a graph. Each started with one workflow they already ran by hand.

Trades business · 12 people

The Monday owner report

Four tools fed into one weekly view of jobs, cash and leads. The checker flags jobs with no notes and leads nobody called back.

Jobs app ∥ Accounting ∥ InboxGap checkOwner + GM
Parallel sources
Event production · 400+ events/yr

From site visit to three documents

One recorded site visit becomes a logistics brief, a technical brief and a client quote, checked against real past examples before the owner signs.

Transcript3 docs ∥Format + totalsOwner
Fan-out + checker
Real estate · CEO

The daily sales brief

Per-agent performance, product mix and a competitor watch are researched separately, challenged, then merged into one page for the CEO.

Sales ∥ Mix ∥ MarketSkepticCEO
Diamond
Accounting firm

Audit checks

Audit is a checker by nature. Each control runs as its own lane, and a human reviews only the exceptions.

Control A ∥ B ∥ CExceptionsAccountant
Parallel checks
Hospitality SaaS

Monthly venue reporting

Point-of-sale and spreadsheet data become a monthly report per venue, with a privacy gate before revenue figures leave the system.

POS ∥ SheetsReportPrivacy checkOwner
Sequential + gate
Voice AI engineer

Voice identity verification

Speech-to-text, spoofing detection and verification run as separate jobs. A person reviews only the uncertain calls.

TranscribeAnti-spoofVerifyReview edge cases
Code pipeline
Your first rep

Build your first graph in four steps

Two hours, no code. Use a task you already do every week, not a new idea.

  1. Pick one workflow

    A weekly report, a quote, a client brief. Something you already run by hand.

  2. Draw it

    Write the jobs, the arrows, the checks, the handoffs and where you approve.

  3. Run it by hand once

    One AI project, one lane at a time, each output saved as a file.

  4. Then automate

    Automate only the lane that costs you the most time.

Copy this prompt to draw your first graph
I want to turn one of my recurring tasks into an AI workflow graph.

The task: [describe it in 2–3 sentences, including the tools and documents it uses].

Before proposing anything:
1. List every step as a separate job (one step, one owner, one output).
2. Mark which jobs must wait for another and which can run in parallel.
3. Add one checker job that reviews the output and is not the job that wrote it.
4. Put a human approval only where a mistake would cost money or trust.
5. Tell me honestly whether this needs a graph at all, or just a better prompt.

Return the graph as a numbered list, then the single lane I should automate first and why.
Don't mix them up

Knowledge graph vs agent graph

One maps how information connects. The other maps how work moves. This guide is about agent graphs, the one you can use this week.

Knowledge graphAgent graph
Question it answersHow does information connect?How should work move?
What it mapsCustomers, companies, products, teamsPlanner, researchers, skeptic, merger, human
Reach for it whenSearch keeps returning the nearest-looking paragraph instead of the right answerThe task has steps, checks and handoffs
Looks likeRelationships you can reason acrossResearch → skeptic → merge → human approves
FAQ

Graph engineering, answered

What is graph engineering in AI?

Graph engineering is designing the work around an AI model: splitting a task into jobs, connecting them with arrows (what must happen before what), and keeping a shared state. It sits above prompt engineering (the wording) and context engineering (the inputs).

How is it different from prompt and context engineering?

Prompt engineering improves how you ask. Context engineering improves what information the model gets. Graph engineering improves how the work is structured: who does which step, in what order, who checks it, and where a human signs off.

When do I need a graph instead of a better prompt?

When the task has multiple steps, multiple sources, parallel paths, checks, real risk or a required human approval. If none of these apply, a better prompt is enough. Use the 30-second test above.

Do I need to code?

No. Level 1 runs entirely by hand inside one AI project, with each step as its own chat or document. Code and orchestration tools come in only once the structure has proven itself.

Is a knowledge graph the same as an agent graph?

No. A knowledge graph maps how information connects. An agent graph maps how work moves. This guide covers agent graphs.

Do more AI agents give better results?

Usually not. More agents mean more noise and more coordination cost. Add a job only when it removes waiting, separates the worker from the checker, or protects an expensive decision.

Work with me

Want your first graph built around your work?

In a 50-minute diagnostic we pick one workflow you already run, draw its graph together, and decide whether it needs a graph or just a better prompt.