Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ahvn.top/llms.txt

Use this file to discover all available pages before exploring further.

Ask not what your agents can do for you, ask what you can do for your agents.
HeavenBase grows out of a handful of convictions about what intelligence really is, and where it tends to come from. Together they lead to one question: if models keep getting smarter, what is left for the rest of us to build? Our answer is not a better brain — the brains are already good enough. What they still lack is a world worth looking at: discoverable, unified, and structured. The sections below sketch that world one observation at a time, and the last one ties them back together.

Search is Intelligence

Strip almost any task down and the same skeleton tends to remain: find the right information, then process it the right way. Models keep getting better at the second half — they reason more carefully, plan more deeply, and recover from their own mistakes more gracefully every year. But reasoning can only work on what it can see, and a mind with no eyes stays blind no matter how sharp it is. The first half, finding the right information, is where most real systems quietly fail. In the enterprise especially, “the right way” is rarely something a model should invent on the spot; more often, specs simply triumph over flexibility. The right way usually means finding the right spec and following it, or finding the right past experience and imitating it. This is why Skills became the bedrock of modern agents, and why memory grew into a standalone layer that almost any agent can plug into. So most forms of intelligence seem to fold back into a single capability: search. Finding the right data and tools, the right specs and workflows, sometimes even the right agents. The sharper your search, the smarter you can be. That is why data observability tends to matter more than any single model upgrade, and why a unified data interface can quietly unlock so much capability that already sits in your systems, unused. The models do not really need a bigger brain right now. They need sharper eyes.

Agent is Data

In an e-commerce system, orders, customers, and products are data. That part is obvious. The quieter claim is that everything around the agent is data too. Its prompts are data, with their own versions, translations, and evaluations. Its model choices are data, shaped by updates, tuning, and routing. So are its workflows, its per-agent memory and tools, its sessions and messages, and the logs and feedback it leaves behind. This echoes von Neumann’s stored-program idea, where instructions and ordinary data finally lived in the same memory, addressed the same way. The agent era seems to call for a similar move: store what an agent is — its prompts, sandboxes, memories, knowledge, and model choices — through the same data abstraction we already use for the data it works on. With one management interface and a little self-reference, a system gains room to maintain, evolve, and gradually optimize itself. Once you see it this way, orchestration stops being a discipline of its own and starts to look like another instance of search. You find the right spec, prompt, tool, memory, and model, then compose them for the task at hand. And when an agent can manage its own data the way it manages business data, it can begin to improve itself — search for a better prompt or a better workflow, and write the result back — under one abstraction that covers the data, the agent, and the loop between them.

Knowledge is Unified

As the agent era matures, certain shapes keep reappearing. Almost every agent artifact, whatever its underlying source, often carries a name to identify it, a short description for progressive disclosure, a longer one for detail, a few examples, some metadata for classification and governance, and maybe more. Prompts, functions, datasets, and workflows all tend to converge on the same envelope. This is what a Unified Knowledge Format (UKF) tries to capture. UKF is not a new physical format that everything must be rewritten into; it is more of a shared entrance — a guide that lets an agent make sense of a piece of knowledge without first knowing its source or storage. A single UKF record is roughly the smallest unit an agent needs to grasp and use something, which is why it can serve as the common language agents use to talk to data, and humans use to talk to agents about data. It also softens the old tension between hierarchy and flatness. A single cell can be a UKF record; so can a collection of cells, a table, or a whole database. The same vocabulary works at every granularity, and that is part of what lets agentic systems stay composable as they grow. The fields that matter fall into seven common groups:
  • Identity — name, version, type: what tells one piece of knowledge from another.
  • Payload — long description, instructions, examples, artifacts, localizations, confidence: what actually becomes the prompt to an LLM.
  • Searchable — short description, type, tags, priority: what drives retrieval but need not be payload.
  • Governance — creator, owner, authentication, lifecycle, metadata.
  • Lineage — source, history, transformations.
  • Usage — statistics, feedback, annotations.
  • Reference — related knowledge, related automations.
HeavenBase adopts a MetaSchema and Catalog that roughly follow this structure, and we expect it to evolve as we learn more about what agents need to know about their knowledge. Meanwhile, user-defined schemas can be joined with the UKF fields to capture whatever domain-specific attributes a particular application needs.

World is Structured

Most memory layers picture the world as something fairly unstructured: natural-language files or snippets, arbitrary graph edges, or weights inside a model. We think this misses a quieter property of reality. Individual facts and links can be arbitrary, but their types rarely are. Types tend to be power-law distributed — a handful of data and relation types show up constantly, while a long tail of them barely appears at all. Take “Bavaria is in Germany” as an example. The unstructured instinct is to keep it as one more sentence, or one more edge on a graph. The structured instinct notices instead that “State” and “Country” are recurring types that all belongs to “Administrative Region”. Instead of memorizing each fact, we build the schema like Region(Continent, Country, State, City), and from then on every new state and country relation are part of that schema. Agent is only informed of the Region concept, and it can reason and search about the facts as if the facts were rows in a table, rather than sentences in a pile or an edge in a graph. Put differently, we don’t memorize the dictionary; we learn how to look a word up in it. This is the same instinct behind the schema in a database and the type system in a programming language, and it is what keeps a growing body of knowledge from collapsing into an unsearchable pile of sentences.

Next Steps: Recursion is the Answer

The earlier sections start to fold into each other here. Search is intelligence and the agent is data, so in the end what we really care about is data. Knowledge is unified and the world is structured, so what we care about narrows further, to the structure of that data. Pythagoreanism once held that all is number. We’d offer a smaller cousin of that idea: nearly all is structure. Teach an agent the structure of data and it can begin to understand the data no matter what domain it is; teach it the structure of structure, and it can begin to understand structures it has never seen before. This is roughly how human work has always moved forward. We notice a repeating pattern, then build a layer that automates it. Repeating manual procedures turned into code. Repeating coding patterns turned into generative agents. Repeating prompting patterns to generative agents turned into specs, skills, and workflows. And now that designing those specs and workflows has itself become a repeating pattern, that seems to be the next layer worth automating. Each turn compounds the one below it, so that when code removes most manual labor and prompting removes most of what’s left, only a sliver of the original effort remains. HeavenBase leans toward this by treating structure itself as something that lives inside the data model rather than above it. A structure entity doesn’t only hold rows; it can hold “Attribute”, “Entity”, “Class”, and “Instance” — the structure of structures. Because those live as data too, an agent can do more than work within the data models you hand it. It can start to reason about how such models are built, and define new ones. That is the recursion HeavenBase is meant to support: data describes the work, structure describes the data, and structure describes structure, as far up as you care to go.

Further Exploration

Related resources: