BaseCoat

Versioned GitHub Copilot customization library for enterprise repos.

BaseCoat gives your organization one place to manage agents, skills, instructions, and prompts. Sync it into each team repo with a single command so standards stay consistent and reusable instead of being rewritten in every codebase.

• README.md — Getting started, installation, and overview
• CHANGELOG.md — Release history
• CONTRIBUTING.md — Contribution guide
• philosophy.md — Design philosophy and principles

---

What's included

Asset type	Count	What it does
Agents	116	End-to-end task executors — sprint planners, code reviewers, security analysts, and more
Skills	116	Reusable domain capabilities invoked by agents
Instructions	91	Copilot behavior rules scoped by file path pattern
Prompts	5	Structured templates for repeatable tasks

---

How it works

flowchart LR
    BC[BaseCoat\nSource Repo] -->|sync.ps1 / sync.sh| CR[Your Team Repo\n.github/base-coat/]
    CR -->|auto-discovered| CP[GitHub Copilot]
    CP -->|guided by| DEV[Your Developers]

1. Sync — pull the latest BaseCoat release into .github/base-coat/
2. Use — Copilot auto-discovers agents, instructions, and prompts from .github/
3. Contribute — open a PR to share patterns back with the org

---

Explore the docs

• integrations/mcp-deployment.md — Deploying the Base Coat MCP server
• integrations/pydantic-mcp-integration.md — Pydantic + MCP integration
• integrations/pydantic-typescript-client-generation.md — TypeScript client generation
• integrations/azure-ad-integration-guide.md — Azure AD integration
• integrations/azure-sql-migration-guidance.md — Azure SQL migration
• integrations/enterprise-identity-access.md — Identity & access patterns
• integrations/enterprise-kubernetes-patterns.md — AKS / K8s guidance
• integrations/application-gateway-routing-guidance.md — App Gateway routing
• integrations/rbac-only-authentication-patterns.md — RBAC auth patterns
• integrations/untools-integration.md — UnTools integration guide

Reference (docs/reference/)

• GOVERNANCE.md — Canonical governance landing page for shared vs repo-specific rules
• reference/governance-contract.md — Canonical common-vs-specific governance guide
• reference/inventory.md — Full asset listing (agents, skills, instructions, prompts)
• reference/governance.md — Contribution policies and review standards
• reference/distribution.md — Sync mechanism for consumer repos
• reference/hooks.md — Git hooks and pre-commit validation
• reference/goals.md — Project goals and OKRs
• reference/scoped-instructions.md — Scoped instruction authoring guide
• reference/label-taxonomy.md — GitHub label taxonomy
• reference/prompt-registry.md — Prompt catalog and registry
• reference/asset-registry.md — Asset registry metadata
• reference/cli-command-reference.md — CLI command reference
• reference/component-library.md — Component library reference
• reference/product.md — Product vision and roadmap
• reference/quick-reference.md — Quick reference card
• reference/guidance-vocabulary-syntax-guide.md — Canonical vocabulary, taxonomy, ontology, and prompt syntax
• reference/treatment-matrix.md — Issue treatment matrix
• reference/guardrails/ — Guardrail configuration files

Guides (docs/guides/)

• guides/intent-prefixes.md — Intent vocabulary, routing behavior, and prompt templates
• guides/token-optimization.md — Operator token-efficiency checklist, model/mode defaults, and context normalization patterns
• agents/taxonomy.md — Agent and skill taxonomy with chain archetypes

Operations (docs/operations/)

• operations/fleet-dispatch-policy.md — Guardrails and checklist for parallel sub-agent dispatch in fleet mode
• operations/label-cleanup-plan.md — Safe label normalization plan that preserves repo-specific labels
• operations/release-process.md — How releases are cut and published
• operations/release-metrics.md — Release metrics and KPIs
• operations/operational-runbook.md — Runbook for common operations
• operations/disaster-recovery.md — DR procedures
• operations/cost-optimization.md — Cost analysis and optimization
• operations/enterprise-runners.md — Self-hosted runner setup
• operations/enterprise-security-hardening.md — Security hardening guide
• operations/blocked-issues.md — Blocked issues tracking
• operations/telemetry-adoption.md — Adoption telemetry guide
• operations/github-secrets.md — Repository secrets setup and rotation guide
• operations/copilot-extension-github-app-registration.md — GitHub App registration runbook for BaseCoat Copilot Extension
• operations/build-master-control-plane.md — Build master architecture, policy matrix, and runbook for lane-aware continuous merge with cloud break-fix
• operations/security/ — Security policies and audit docs

Templates (docs/templates/)

• templates/ — File templates and scaffold taxonomy guidance

Examples (docs/examples/)

• examples/ — Read-only examples and starter references

Archive

Historical Wave 3 staging deliverables, portal design docs, wireframes, and cleanup reports. These are preserved for reference but are not part of the active framework.

• View archive on GitHub — All archived Wave 3, portal, design, and audit documents