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
- A Wazoo private beta account. Sign up at wazoo.dev/beta.
- A platform token (
wzp_) with world permissions. Generate one on the Console tokens page. - The
wazooCLI, installed per the CLI reference. - The
wikiCLI, installed per the Wiki install guide.
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:
Add a shape for decisions in Write an architecture decision record that satisfies the shape in
Person, Team, Project, Decision, Meeting, and Architecture.
Wiki validates documents against these shapes before they reach the world.Start a wiki vault:brain/shapes/decision.md: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 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.
wazoo skill so coding agents can query the brain with native
tool calls:Check for success
Search the brain for the decision you imported: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
- Worlds overview: understand worlds, items, and facts
- Hybrid search: tune retrieval for your agents
- Graph queries: write SPARQL patterns against the brain
- MemSDK: add a backend-agnostic memory interface