# Knowledge Base Specs

This directory contains the canonical Knowledge Base product and architecture specs.

Reading order:

1. [Workspace Knowledge Base](./workspace-knowledge-base.md) defines the product model, user-facing surfaces, lifecycle, and durable product rules.
2. [Knowledge Base Setup And Publication Governance](./setup-publication-governance.md) defines Draft/Official publication, recoverable setup, optional artifacts, and approval boundaries.
3. [Repo-backed Knowledge Base](./repo-backed-knowledge-base.md) defines the top-down technical architecture for repository-backed sources.
4. [Uploaded Understand Anything Dashboard](./uploaded-ua-dashboard.md) defines source-scoped `.ua` import, immutable publication, current-only reads, and the Dashboard UI.
5. [KB Repository Import Progress](./repository-import-progress.md) defines source-scoped progress for repository import, mirror sync, and generated repository knowledge.
6. [KB Permissions](./kb-permissions.md) defines product permissions and their boundary with repository access.
7. [KB / KB Source AGS Permission Matrix](./kb-ags-permission-matrix.md) defines the resource-to-AGS mapping and required authorization controls.
8. [KB Repository Access Grants](./kb-repository-access-grants.md) defines user journeys and support model for KB-level repository access defaults and source-repository overrides.
9. [Knowledge Q&A Hosted Sessions](./knowledge-qa-runtime-sessions.md) defines the organization enable switch, direct AgentTeam-hosted model and reasoning selection, Human-authorized retrieval, durable hosted turns, authenticated external answer sharing, usage overview, and observability.

Knowledge Base is a MeshX product surface. AGS supplies repository primitives; MeshX owns KB membership, source lifecycle, resource-to-repository mapping, permissions, retrieval scope, and user-facing semantics.