whatisgithub

What is graph-engineering?

codejunkie99/graph-engineering — explained in plain English

Analysis updated 2026-07-25

82Audience · developerComplexity · 3/5Setup · easy

In one sentence

A toolkit for building knowledge graphs and task graphs that AI agents can use. It teaches you to design structured memories and execution workflows for agents, with installable prompts for Claude Code.

Mindmap

mindmap
  root((repo))
    What it does
      Teaches graph engineering
      Knowledge graph pipeline
      Task graph patterns
      Agent skill folder
    Tech stack
      Prompt files
      Markdown docs
      Claude Code skill
    Use cases
      Build knowledge graphs
      Learn graph engineering
      Structure agent workflows
      Interactive tutoring
    Audience
      AI agent builders
      Learners
      Teams planning work
    Key concepts
      Nine stage pipeline
      Diamond parallel pattern
      Human approval gates
      Model before extract

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install the skill into Claude Code to build a knowledge graph from your documents.

USE CASE 2

Use the tutor mode to interactively learn graph engineering using your own project as an example.

USE CASE 3

Chain the eight single-purpose prompt tools together to run a full knowledge graph build pipeline.

USE CASE 4

Apply task graph patterns to structure AI agent work with parallel execution and approval gates.

What is it built with?

MarkdownPrompt Engineering

How does it compare?

codejunkie99/graph-engineering2latemc/justanothermusicclientaqua5230/usage
Stars828282
LanguageTypeScriptPython
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install the skill folder into a compatible AI agent like Claude Code, no external infrastructure or API keys required.

So what is it?

This repository teaches a discipline called graph engineering, which is about designing the structures that AI agents work through rather than focusing on the words they use. The author splits it into two halves. Knowledge graphs are what agents remember: entities, facts, and relationships tracked with time and origin. Task graphs are how agents work: jobs connected by execution dependencies, with rules for parallel work, verification, and human approval checkpoints. The knowledge graph material comes from a graduate course at Southeast University, taught in Chinese since 2019. The repo translates and distills that course into English. It also incorporates modern research on agent orchestration from Google DeepMind, MIT, and Anthropic. The result is a set of practical tools rather than academic theory alone. Inside the repo you find a "skill" folder you can install into a compatible AI agent like Claude Code. Once installed, you can ask the agent to build a knowledge graph from your documents or to teach you the material interactively. The teaching mode walks through the pipeline stage by stage, using your own project as the running example with generated diagrams. A separate workflows file provides nine ready-to-use prompt blocks, including a tutor mode and eight single-purpose tools that chain together into a full build. The knowledge graph pipeline has nine stages: scope, representation, ontology, entities, relations, events, a quality gate, fusion, and serving to language models. The guiding principle is to model the domain before extracting information, fuse before storing, and verify at every stage. The author emphasizes that a knowledge graph is a product with a schema, not a pile of raw data. The task graph half offers specific rules for structuring agent work. Delete fake edges where no real work flows. Use a diamond pattern that splits work across parallel workers, runs verification in separate contexts, and merges through one owner. Research shows teams perform well on splittable work but lose on sequential work. A human approval gate should sit exactly where mistakes are costly to undo.

Copy-paste prompts

Prompt 1
Using the graph-engineering skill, build a knowledge graph from the documents in this folder. Start with the scope stage and walk me through each of the nine pipeline stages.
Prompt 2
I want to learn graph engineering. Use tutor mode to teach me the knowledge graph pipeline, using my current project as the running example with generated diagrams at each stage.
Prompt 3
Help me design a task graph for my AI agent workflow. Apply the diamond pattern to split work across parallel workers, run verification separately, and merge through one owner. Tell me where to place human approval gates.
Prompt 4
Chain the eight single-purpose workflow tools from the graph-engineering repo to build a complete knowledge graph from my data. Run ontology design, entity extraction, relation extraction, event extraction, quality gating, and fusion in sequence.
Prompt 5
Review my existing AI agent's task graph and identify any fake edges where no real work flows. Suggest how to restructure using the diamond pattern with a human approval gate where mistakes are costly to undo.

Frequently asked questions

What is graph-engineering?

A toolkit for building knowledge graphs and task graphs that AI agents can use. It teaches you to design structured memories and execution workflows for agents, with installable prompts for Claude Code.

How hard is graph-engineering to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is graph-engineering for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.