Capabilities — Pillar 1: Rationale

2026-08-19

Why this repo exists. workspace-mcp is the workspace-level MCP server that provides agent-facing discovery, routing, and context for all repos in the ovesorg workspace.

What This Repo Owns

• Workspace repo registry and inventory
• Repo manifest contracts (docs/agent/manifest.yaml)
• MCP server (server/src/server.js) and tool/resource surfaces
• Provisioning workflow (scripts/mcp_provision.py)
• Canonical repo structure definition (ADR-0003)
• Workspace-level authority model

What This Repo Does Not Own

• Individual repo content — each repo owns its own documentation
• dirac-framework — that repo owns cross-repo architecture decisions
• mkdocs-template — that repo owns docs site scaffolding
• consolidated-docs — that repo owns the global doc hub

Cross-Repo Boundaries

• Framework repo: dirac-framework
• Template authority: mkdocs-template
• Hub authority: consolidated-docs