bw-copilot-resources/docs/architecture.md

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.