# Architecture

## Overview

This repository is the canonical source of truth for shared Copilot resources.
It separates reusable workflows from tool-specific adapters and keeps propagation
Git-based after a resource is published.

## Layers

- `resources/skills/`: portable workflows for VS Code, Copilot CLI, and cloud agents
- `resources/prompts/`: VS Code slash-command adapters
- `resources/instructions/`: shared instruction packs
- `resources/agents/`: shared custom agents for local chat and overlays
- `resources/hooks/`: shared hook definitions
- `templates/repo-overlay/`: files that can be copied into another repository for
  repository-scoped behavior

## Discovery Model

Bootstrap prefers linking default discovery paths back to this repository:

- `~/.copilot/skills` -> `resources/skills`
- `~/.copilot/agents` -> `resources/agents`
- `~/.copilot/instructions` -> `resources/instructions`
- `~/.copilot/hooks` -> `resources/hooks`
- VS Code user prompts directory -> `resources/prompts`

This keeps the repository authoritative while still using default discovery
locations whenever possible.

## Propagation Model

There are only two supported creation paths:

- repo-first
- local-first followed by publish-to-repo

Once a resource lands in the repository, commit and push it. Other systems pick
it up through `install/update.*` or future scheduled sync.