41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
# 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.
|