Valla Index

AI Quick Start

Open Valla Index in your preferred AI client.

OpenAI CodexClaude CodeCursor

Ask questions about this page

How It Works

Preview page prompt
Use the MCP tools provided by Valla Index to answer questions about this page.
Current page focus: How It Works
Page URL: https://valla-index.pages.dev/architecture
Page path: /architecture
Search the index for this page and its related project evidence before answering.
Prioritize results directly related to this page.
Cite the relevant indexed pages, distinguish indexed evidence from inference, and wait for my question.

How It Works ​

Index keeps source-controlled knowledge readable by people while exposing approved material to agents through a read-only MCP interface.

Knowledge Flow ​

  1. Maintainers record durable context in Markdown and structured metadata.
  2. index.json defines ownership, approved content roots, registries, lifecycle, and enabled interfaces.
  3. Contract, documentation, and workspace checks catch broken paths, malformed records, invalid dates, and unsafe metadata keys.
  4. MCP and Slack expose approved documentation and repository records through the same read-only search service.
  5. Clients can list, read, and search that context without gaining write access.

Source Of Truth ​

SurfaceSource
Management contractindex.json
Documentationdocs/
Repository registryrepos/index.yaml
Workspace schemaschemas/workspace.schema.json
Workspace checksscripts/validate-workspaces.mjs
MCP and Slack runtimemcp/src/

Design Principle ​

Prefer evidence-backed files with stable paths over knowledge that exists only in chat history or individual memory.

Private Valla project memory maintained by Baker Street.

Licensed under the MIT License.