Initial shared Copilot resources scaffold

docs/architecture.md

@@ -0,0 +1,40 @@
+# 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.