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 world ID
company-brain is public and used in every data-plane
request. Choose a descriptive ID so agents can find the right world.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 ledger.
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.
Every import appends to the chronological ledger, so the brain keeps a
complete history of what it knows.
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 ledger 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