Skip to main content
A company brain is a shared knowledge graph that your agents query instead of scraping Slack threads and stale Notion pages. This guide builds one with Worlds, the Wiki CLI, and the wazoo agent skill. Vector-only chunk search returns whatever text is most similar to a query. A company brain returns verified facts: assertions that passed shape validation and carry provenance you can trace to their source.

Prerequisites

Steps

1

Create the company brain world

Worlds stores facts in isolated worlds. Create one for the company brain:
The Worlds API mints an immutable w_<ULID> ID and returns it as id. Replace the sample WORLD_ID with that exact value; the display name is not an ID, and create requests expose no caller-selected ID or slug field.
2

Model the core schemas

Define SHACL shape constraints for the entities your company tracks: Person, Team, Project, Decision, Meeting, and Architecture. Wiki validates documents against these shapes before they reach the world.Start a wiki vault:
Add a shape for decisions in brain/shapes/decision.md:
Write an architecture decision record that satisfies the shape in brain/decisions/ADR-004.md:
3

Enforce quality gates in CI

Run the integrity and convention checks before any document syncs into the company brain:
Add both to your CI pipeline so a document with a broken shape or a dangling link cannot reach the world.
4

Import verified facts into the world

Export the validated ADR as Turtle, then import it into the world:
The import endpoint accepts Turtle, JSON-LD, N-Triples, N-Quads, and Trig. Import adds facts to the world’s current state. Worlds does not keep a history of earlier states, so keep your source documents in Git as the record of how the brain changed.
5

Connect agent runtimes

Install the wazoo skill so coding agents can query the brain with native tool calls:
Export the tokens the skill reads:
Claude Code, Cursor, OpenCode, and Gemini agents pick up the skill from their workspace automatically. See the Wazoo skill page for environment setup and update instructions.

Check for success

Search the brain for the decision you imported:
Then confirm the fact exists in the graph with a SPARQL query:
The search returns the ADR document, and the SPARQL query returns its quads. Both results prove the agent-facing world contains verified, queryable facts.

Use cases

  • Autonomous onboarding: New engineers query the brain for architecture decisions, system topology, and team roles instead of asking in Slack.
  • Verifiable ADR tracking: Agents check accepted decisions before proposing refactors or API changes.
  • Multi-agent fleet coordination: A shared world keeps Letta, Hermes, and custom bots working from the same verified facts.

Next steps