All notes
In this note (6 sections)
Architecture Jul 22, 2026Updated Jul 24, 2026 8 min

Graph engineering with Claude.

Last updated on Jul 24, 2026

Your agent is already a graph. Stop drawing it as a line. 14 steps, four phases.

Introduction

Most multi-step agents are polite queues. A then B then C, even when half the waits carry no data. The infographic above is the redraw I use on whiteboards: vertical workflow on the left, step cards side by side on the right, four phases from seeing the graph to letting Claude draw it.

This is not Neo4j and not knowledge-graph RAG. It is workflow topology on Claude Code dynamic workflows. For the full 14-step write-up with JavaScript patterns, barrier vs pipeline, and a five-day engagement plan, read graph engineering with Claude Code.

Phase 01: See the graph

Redraw the chain. Nodes are jobs. Chains are already graphs (usually degenerate ones). Give every node a contract (bounded in, validated out). Treat every edge as a data contract. If you cannot draw an arrow because no variable crosses, the two boxes are independent.

Phase 02: Spread the work

Run it all at once. Fan out with parallel(). Fan in at a barrier only when the next stage needs the whole set. The diamond (split → work → merge) is the workhorse. Conditional routing: Claude classifies at the node, code picks the edge.

Phase 03: Make it survive

One failure cannot spread. Put a verifier on the edge (maker ≠ verifier). Isolate every node, especially parallel writers. Cycles are allowed only when they converge (loop-until-dry against everything seen). Same rule as independent verifier loops.

Phase 04: Tune and automate

Cheap, fast, hands-off. Tier models across nodes. Topology is your cost and latency. Let Claude draw the graph: ask for a workflow, run /deep-research, or use ultracode, then save the script into .claude/workflows/.

Conclusion

Stop drawing the agent as a line. Use this note as the shareable map. Use the companion blog when you need contracts, code, and rollout discipline.

Key takeaways

  • 1Your multi-step agent is already a graph. A straight line is a degenerate graph that wastes wall-clock on fake edges where no data moves.
  • 2Phase 01 See the graph: nodes are jobs, chains are graphs, every node needs a contract, every edge is a data contract. Draw boxes and arrows before you write prompts.
  • 3Phase 02 Spread the work: fan out with parallel(), fan in at a barrier only when the next stage needs the whole set, use the diamond (split → work → merge), route conditionally in code.
  • 4Phase 03 Make it survive: put a verifier on the edge (maker ≠ verifier), isolate nodes so one failure cannot poison the run, add cycles only when they converge (loop-until-dry).
  • 5Phase 04 Tune and automate: tier models across nodes, treat topology as your cost and latency lever, let Claude draw the workflow script and save it when it works.
  • 6Not Neo4j. Not knowledge-graph RAG. This is workflow topology on Claude Code dynamic workflows (v2.1.154+).
  • 7Long-form with code, barrier vs pipeline table, and engagement rollout: /blog/claude-code-graph-engineering-14-step-roadmap.
  • 8Pair with sequential vs parallel for the edge smell test: /notes/agentic-ai-sequential-vs-parallel-workflow.

Frequently asked questions

Work with me

Need help shipping this in production?

I help teams design agent architectures, RAG pipelines, and production guardrails on consulting engagements.

Read the full graph engineering roadmap Agentic AI training programs
Tags
#ClaudeCode#GraphEngineering#Multi-Agent#Workflows#Architecture#Orchestration#Verification#Parallel#AgenticAI#Production

Get the visual notes by email

New agentic AI notes and breakdowns, plus what I am shipping for clients, one email on Thursdays.