← Back to docs
Concept

Knowledge Graph System

EvolC models every business as a knowledge graph — a network of interconnected nodes representing business functions, strategies, and processes.

What Is a Knowledge Graph?

A knowledge graph is a way to represent information as a network of entities and their relationships. In EvolC:

  • Nodes = Business functions (Marketing, Sales, Operations, etc.)
  • Edges = Relationships (hierarchy, data flow, collaboration)
  • Properties = Metadata (name, description, type, agents)

Graph Structure

A typical business graph looks like this:

{
  "nodes": [
    {
      "id": "business-model",
      "name": "Business Model",
      "path": "business-model",
      "nodeType": "documentation",
      "description": "Core business strategy"
    },
    {
      "id": "marketing",
      "name": "Marketing",
      "path": "marketing",
      "nodeType": "agent",
      "description": "Attract and convert customers"
    }
  ],
  "links": [
    {
      "source": "business-model",
      "target": "marketing",
      "type": "hierarchy"
    }
  ]
}

Visualization

EvolC renders the knowledge graph as a D3.js force-directed graph. This interactive visualization lets you:

  • See how business functions connect
  • Drag nodes to reorganize the layout
  • Click nodes to enter their world view
  • Add new nodes and connections

Why Not a Database?

EvolC stores the knowledge graph as JSON files on the filesystem, not in a traditional database. This approach offers several advantages:

  • Portable — Copy a directory = copy a business
  • Version-controlled — Git tracks every change
  • Human-readable — Open any file and understand it
  • Agent-friendly — AI agents can read and write files naturally

Read more about this design decision in our Filesystem as Database concept page.

Related