From 849e91971c4fc1b270ee262d954c9d70035b6a51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D1=8F=D1=82=D0=BA=D0=B8=D0=BD=D0=90=D1=80=D1=82?=
 =?UTF-8?q?=D1=91=D0=BC?= <a.vyatkin@npo-echelon.ru>
Date: Wed, 8 Apr 2026 09:50:45 +0300
Subject: [PATCH] =?UTF-8?q?feat:=20=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=82=D1=83=D1=80?=
 =?UTF-8?q?=D1=83=20=D0=BA=D0=B0=D1=81=D1=82=D0=BE=D0=BC=D0=B8=D0=B7=D0=B0?=
 =?UTF-8?q?=D1=86=D0=B8=D0=B9=20GitHub=20Copilot=20=D0=B4=D0=BB=D1=8F=20VS?=
 =?UTF-8?q?=20Code=20=D0=B2=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/README.md b/README.md
index e69de29..344b64e 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,46 @@
+# github-copilot
+
+Этот репозиторий содержит структуру кастомизаций GitHub Copilot для VS Code.
+Основная цель — хранить и развивать специализированные агенты, навыки (skills), инструкции, хуки и готовые промпты в одном месте.
+
+## Что находится в репозитории
+
+Вся рабочая конфигурация лежит в директории `.github/`:
+
+- `agents/` — определения кастомных агентов (`*.agent.md`)
+- `skills/` — каноничные навыки в формате `.github/skills/<skill-name>/SKILL.md`
+- `prompts/` — переиспользуемые одноразовые промпты (`*.prompt.md`)
+- `instructions/` — правила поведения и код-стайл инструкции (`*.instructions.md`)
+- `hooks/` — детерминированные lifecycle-хуки в JSON
+
+## Назначение
+
+Репозиторий используется как единая точка для:
+
+- настройки поведения Copilot под рабочие процессы команды
+- автоматизации типовых задач (ревью ветки, Docker, TestLink, OpenWrt и др.)
+- поддержки воспроизводимой архитектуры кастомизаций
+
+## Какие агенты уже есть
+
+В `.github/agents/` сейчас определены:
+
+- `Branch Review Engineer`
+- `Docker Build & Test Engineer`
+- `OpenWrt VPN & Network Engineer`
+- `TestLink Autotest Engineer`
+
+## Как расширять
+
+1. Добавьте или обновите агент в `.github/agents/`.
+2. Добавьте/обновите соответствующий навык в `.github/skills/`.
+3. При необходимости создайте reusable промпт в `.github/prompts/`.
+4. Добавьте инструкции в `.github/instructions/` для правил, которые должны применяться постоянно.
+5. Используйте `.github/hooks/` только для детерминированной автоматизации, а не для описательных правил.
+
+## Принципы структуры
+
+- Один источник истины для каждого навыка — только в `.github/skills/`.
+- Агенты и навыки разделены по ответственности.
+- Инструкции короткие и прикладные, workflow-логика выносится в skills.
+- Хуки быстрые, идемпотентные и недеструктивные.