Skip to content

Agent Start Here — workspace-mcp

Use this repo when the task involves workspace-level MCP discovery, repo provisioning, registry management, or canonical repo structure.

Read Order (Four-Pillar Canonical Structure)

Every repo in this workspace organizes its agent context around four pillars:

  1. Pillar 1 — Rationale (Why this repo exists): Capabilities Workspace MCP server, repo registry, and discovery contracts.
  2. Pillar 2 — Solution Mechanism (How it works): Contracts Registry-first resolution, manifest schema, four-pillar canonical structure.
  3. Pillar 3 — Deployment Instructions (How to operate it): Workflows Provision, inventory, validate, and audit repos.
  4. Pillar 4 — Documentation & Training (How to adopt it): (This page + nav structure) Architecture docs, ADRs, and operational guidance.

Typical Questions This Repo Should Answer

  • How do I discover what repos exist and what they do?
  • How do I provision a new repo with MCP contracts?
  • What is the canonical repo structure and why?
  • How does the workspace registry work?
  • What is the authority model for cross-repo decisions?