Hizal Search

Search before you build. Don't rediscover what the team already decided.

Semantic Search

Start with 2-3 broad searches using different phrasings:

hizal__search_context(query="\x3Ckey concept from the task>")
hizal__search_context(query="\x3Cticket id or feature name>")
hizal__search_context(query="\x3Crelated subsystem or endpoint>")

Narrow by Scope

# Project-specific knowledge and conventions
hizal__search_context(query="\x3Cconcept>", scope="PROJECT", project_id="\x3Cid>")

# Prior agent memory / investigation notes
hizal__search_context(query="\x3Cconcept>", scope="AGENT", chunk_type="MEMORY")

# Org-wide principles and standards
hizal__search_context(query="\x3Cconcept>", scope="ORG")

Filter by Chunk Type

hizal__search_context(query="\x3Cconcept>", chunk_type="KNOWLEDGE")
hizal__search_context(query="\x3Cconcept>", chunk_type="CONVENTION")
hizal__search_context(query="\x3Cconcept>", chunk_type="MEMORY")

Exact Lookup by query_key

When you know the exact key:

hizal__read_context(query_key="\x3Cexact-query-key>", project_id="\x3Cid>")

Read a Specific Chunk

hizal__read_context(id="\x3Cchunk-uuid>")

Synthesize Related Context

Pull related chunks for synthesis (read-only, never delete source chunks):

hizal__compact_context(query="\x3Cconcept>")
hizal__compact_context(query="\x3Cconcept>", scope="PROJECT", project_id="\x3Cid>")

Version History

Inspect how a chunk evolved:

hizal__get_context_versions(id="\x3Cchunk-uuid>")

Search Strategy

1. Broad first — 2-3 searches with different phrasings
2. Read the results — chunks contain architecture decisions, conventions, and prior work
3. Narrow by scope if broad search returns too much noise
4. Use query_key if you already know the key
5. If an AGENT memory chunk is broadly useful — promote it with write_knowledge or write_convention

See hizal-write skill for writing back to Hizal.