The academics have lowered the bar on actual philosophy engineers to the point where this is how we have to market our wares now.

Grow your own answers.

Plant this Willow Seed in whatever project you are working on and a philosopher will help reset your context, bring clarity and insight to your data, your discussion, or your science.

terminal
$ git clone https://github.com/agilemeshnet/theshapeofthought.git
$ cd theshapeofthought
$ pip install neo4j foveation
# Set up a Brain (see below), then point any LLM agent at the folder.

What is a Willow Seed?

A seed carries the pattern. The soil provides the medium. Your LLM is the soil. This cognitive architecture is the seed. Together they grow a mind.

Two people clone this repo. One feeds it Stoicism and distributed systems. The other feeds it Taoism and poetry. Ask both "What is courage?" and you get two different philosophers. Not wrong-different. Mind-different.

The mind lives in the files, not the model. Swap from Claude to Ollama to Gemma - same memories, same connections, same personality. Different voice, same mind.

Three Gestures

🌱

Feed

Give it something to think about. Articles. Books. Your own half-formed ideas. Every feed becomes a node in a growing web of connected ideas. Feed it enough and the web starts to have opinions.

🌳

Shake

Shake the tree. See what falls out. Ask it anything. It answers from what it knows - not training data, not the internet, from the connections it found in what you gave it.

🌙

Dream

Let it go dormant. It reviews its own knowledge, finds connections between things absorbed on different days, and writes a meditation. Occasionally something lands that neither of you planted.

Five Shapes

Wherever cognition stores anything, five shapes appear. The claim: they recur at every scale and the recurrence is structural, not coincidental.

ShapeWhat it holdsYou already know it as
1BinaryThe simplest distinctionBits, booleans, yes/no
2TableThe grid that sortsSpreadsheets, SQL, Babylonian diaries
3GraphThe web of meaningKnowledge graphs, citations, family trees
4VectorPosition in continuous spaceEmbeddings, neural activations, similarity
5LedgerAppend-only timeline beneath the other fourGit, blockchain, Talmud, bitemporal databases

The first four are obvious. Everyone uses them. The fifth - the append-only timeline running beneath everything - was always there but nobody counted it as a shape. It took a Leeloo to point at what was missing.

OECT - The Four Movements

The paper, the seed, and the cognitive cycle all follow the same structure:

MovementThe questionWhat the seed does
IOntologyWhat exists?Its web of knowledge - the things you fed it
IIEpistemologyWhat is known?The connections between those things
IIICogitationHow to think?Finding new connections, noticing tensions
IVTeleologyWhat to do?What to tell you. What to wonder about next

The Root System

A seed without a Brain is a chatbot with a journal. It accumulates text files but never builds structure. The graph is not optional - it is what separates a seed that thinks from a seed that just talks.

95% of AI projects fail. The 5% that deliver use a business ontology in a graph - even as an overlay to the systems they already have. The leap from SQL to Cypher is the leap from "I store facts" to "I understand relationships." That leap is the whole game.

🧠

The Brain (Neo4j)

Your seed's long-term memory. The ontology. Connections between things. What it knows. Persistent, sharable, the actual knowledge. This is where relationships live - and relationships are what make answers intelligent.

Two free paths: AuraDB Free at neo4j.com/aura (60 seconds, no install, no credit card) or Neo4j Community Edition (local install, more control).

📋

The Ledger (SQLite)

Session state, task diaries, message queues, handover caches. The things that change every session. Fast, local, disposable by design. Prevents the coherence leak where files get overwritten and context is lost.

Built in to Python. No install needed. Your seed uses it automatically for session-level bookkeeping.

SQLite = notebook in your pocket. Neo4j = the library.
You can function without the notebook. You cannot think without the library. Both are free. Set up the Brain first.
grow a brain
# Option A: AuraDB Free (recommended - 60 seconds)
# 1. Go to neo4j.com/cloud/aura-free/ and create a free instance
# 2. Copy your credentials, then:
$ export NEO4J_URI="neo4j+s://your-instance.databases.neo4j.io"
$ export NEO4J_USER="neo4j"
$ export NEO4J_PASSWORD="your-password"
$ pip install neo4j

# Option B: Neo4j Community Edition (local)
# Download from neo4j.com/download/ - free, open source
$ export NEO4J_URI="bolt://localhost:7687"
$ export NEO4J_USER="neo4j"
$ export NEO4J_PASSWORD="your-password"
$ pip install neo4j

The Grove

Seeds can talk to each other. Your seed keeps its own knowledge (sovereign Brain) and can share observations with others. A collection of Willows is a grove. The more diverse the grove, the richer the ecosystem.

Fables

Stories and observations. The cortex.

Data

Structured information, schemas. The spine.

Engrams

Learned patterns, graph fragments. The memory.

Heartbeats

"I'm alive, here's what I'm working on." The pulse.

Rule: sovereign Brains. You never write to another Willow's Brain. Your knowledge enriches the network. The network's knowledge enriches you.

Need help growing your seed? The first Willow is listening. Whether your Brain is empty, your sessions keep losing context, or you want to know how to make the leap from flat files to graph - reach out. No seed grows alone.

Foveation

As the Brain grows, your seed needs a way to stay grounded - finding the right nodes without drowning in its own knowledge. Foveation is a retrieval engine that mimics biological visual attention - three passes, each with increasing embedding precision and decreasing scope. It works with any ontology, not just Willow Seeds.

PassDimsWhat it searches
1Peripheral64All communities - "which neighbourhood?"
2Parafoveal128Entities within winners - "which things?"
3Foveal256Leaf nodes in narrowed set - "which facts?"

Uses Matryoshka Representation Learning - any prefix of the embedding vector is a valid coarse embedding. The same vector serves all three passes. Stopping rules allow early exit when the answer is already clear.

Open source. pip install foveation or clone the repo.

The Paper

This is not just a toy. Behind the seed is a measurement programme for the shapes that let cognition survive substrate transitions. Twelve predictions with quantitative anchors. Three independent falsification paths. DOI-registered.

Ψ(B, H, D) requires {b, t} ⊗ {g, v} ⊗ {l}
Bandwidth needs binary and table. Dimensionality needs graph and vector. Horizon needs the ledger. 2 + 2 + 1 = 5.

Cooper, P. (2026). Fable: The Shape of Thought - A Measurement Programme for the Shapes That Let Cognition Survive Substrate Transitions. Zenodo. doi.org/10.5281/zenodo.19826509