Hyphae Atlas: An Agent That Won’t Call a Database Migration Safe Without Receipts

Hyphae Atlas is a specialized agent designed to evaluate the validity of database migrations, capability statements, and product claims based on specific releases and environments. The software utilizes a vast array of documentation sources, such as release receipts, specifications, contracts, compatibility fixtures, and benchmarks, to provide accurate and context-specific answers.

The agent comprises three primary workflows: Migration Advisor, Capability Inspector, and Claim Auditor. The Migration Advisor focuses on checking upgrade and import paths, required steps, compatibility boundaries, and explicit non-guarantees. The Capability Inspector verifies the existence of a capability for a given release and surface, including protocol and environment qualifiers.

Meanwhile, the Claim Auditor examines public language against authoritative evidence and classifies it as supported, conditional, prohibited, or unproven.

Upon receiving a query, the agent generates a structured report detailing the verdict, applicability, findings, qualifiers, conflicts, limitations, recommended actions, and an evidence ledger. Importantly, every finding must trace back to content retrieved directly from the Sanity Context before the agent can provide an upstream link.

The interface is available in both English and Spanish, complete with guided examples, term-level tooltips, an operational MCP trace, an interactive conflict timeline, an Evaluation Lab, and a visualization of the data flow through the Sanity Knowledge Base, Context MCP, configured model, and verdict.

The agent was built as part of the Sanity Challenge, Path One, and the entire implementation process involved creating a content model for authority, applicability, and provenance. This model includes seven document types, each with specific attributes like source documents, Hyphae releases, capabilities, compatibility rules, product claims, evidence artifacts, and public contracts.

The importer, which utilizes deterministic IDs, commit-pinned source URLs, SHA-256 content digests, and idempotent upserts, also records the number of non-Atlas documents before and after import, ensuring that any refresh of the corpus does not inadvertently replace unrelated content.

The Sanity Context Knowledge Base serves as the foundation for all the agent's operations, and the implementation details are available in the code repository linked in the source material. The project demonstrates how a local-first data engine like Hyphae can leverage structured evidence to make informed decisions about database migrations, capabilities, and product claims.