Dmitryaf · Oct 11, 2026 · Oct 11, 2026 · Oct 11, 2026
diff --git a/.gitattributes b/.gitattributes
@@ -1,7 +1,5 @@
 * text=auto
 .gitignore text eol=lf
 *.md text eol=lf
-*.json text eol=lf
 *.yml text eol=lf
-*.ps1 text eol=lf
-.githooks/* text eol=lf
+*.py text eol=lf
diff --git a/.githooks/commit-msg b/.githooks/commit-msg
diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
@@ -11,44 +11,30 @@ permissions:
 
 jobs:
   validate:
-    runs-on: windows-latest
-    steps:
-      - name: Check out repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-      - name: Validate structure and links
-        shell: powershell
-        run: ./scripts/check-hub.ps1
-      - name: Test commit and sync tooling
-        shell: powershell
-        run: ./tests/test-tooling.ps1
-
-  validate-pwsh-windows:
-    runs-on: windows-latest
-    steps:
-      - name: Check out repository
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-      - name: Validate structure and links
-        shell: pwsh
-        run: ./scripts/check-hub.ps1
-      - name: Test commit and sync tooling
-        shell: pwsh
-        run: ./tests/test-tooling.ps1
-
-  validate-pwsh-ubuntu-experimental:
-    continue-on-error: true
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           persist-credentials: false
-      - name: Validate structure and links
-        shell: pwsh
-        run: ./scripts/check-hub.ps1
-      - name: Test commit and sync tooling
-        shell: pwsh
-        run: ./tests/test-tooling.ps1
+          fetch-depth: 0
+      - name: Check documents
+        run: python3 scripts/check.py
+      - name: Check whitespace
+        shell: bash
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha || github.event.before }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha || github.event.after }}
+        run: |
+          if [[ "$BASE_SHA" == "0000000000000000000000000000000000000000" ]]; then
+            BASE_SHA="$(git hash-object -w -t tree /dev/null)"
+          elif ! git cat-file -e "${BASE_SHA}^{commit}" 2>/dev/null; then
+            git fetch --no-tags origin "$BASE_SHA"
+          fi
+
+          if [[ "$EVENT_NAME" == "pull_request" ]]; then
+            git diff --check "${BASE_SHA}...${HEAD_SHA}"
+          else
+            git diff --check "$BASE_SHA" "$HEAD_SHA"
+          fi
diff --git a/AGENTS.md b/AGENTS.md
@@ -1,22 +1,9 @@
-# Правила работы агента
+# Работа над Agent Engineering Kit
 
-Перед изменениями прочитай:
+Репозиторий хранит личные предпочтения Codex и минимальный пример проектных инструкций. Продукт — Markdown; исполняемой установки и синхронизации нет.
 
-1. [`rules/CORE.md`](rules/CORE.md) — обязательная основа;
-2. [`hub/PROJECT_RULES.md`](hub/PROJECT_RULES.md) — правила именно этого хаба;
-3. [`hub/ARCHITECTURE.md`](hub/ARCHITECTURE.md) — границы нормативных правил, профилей и шаблонов;
-4. [`hub/COMMIT_RULES.md`](hub/COMMIT_RULES.md) — формат и границы коммитов;
-5. релевантные тематические документы из [`rules/README.md`](rules/README.md).
+Сохраняй эту простоту. Не превращай проектные особенности в универсальные правила и не добавляй обязательные процессы без конкретной потребности. Локальные игнорируемые материалы не удаляй и не публикуй.
 
-Для средней или большой задачи веди короткий план с одним активным пунктом. Сначала проверь `git status`, сохрани чужие изменения и отдели изменение правил от несвязанных правок структуры.
+При изменениях проверь ссылки и образцы: `python scripts/check.py`, затем `git diff --check` и `git status --short`. Проверка требует Python 3.10+ и Git, использование Kit — нет.
 
-После изменения структуры, ссылок или состава правил выполни:
-
-```powershell
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/check-hub.ps1
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/test-tooling.ps1
-git diff --check
-git status --short
-```
-
-Не выполняй commit, push, публикацию, переписывание истории или удаление данных без отдельного явного разрешения пользователя.
+Переход со старого механизма описан в [MIGRATION.md](MIGRATION.md); читай его при работе над совместимостью. Не изменяй подключённые проекты и глобальные настройки без отдельного запроса. Commit и push требуют явного разрешения; формат коммитов — английский Conventional Commits с областью, например `docs(kit): simplify instructions`.
diff --git a/CLAUDE.md b/CLAUDE.md
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,18 +1,9 @@
-# Участие в развитии Agent Engineering Kit
+# Участие в проекте
 
-Agent Engineering Kit развивается под управлением владельца: внешние задачи и запросы на слияние приветствуются как предложения, но окончательное решение о направлениях развития и составе правил принимает владелец.
+Изменения рассматриваются как предложения; окончательное решение принимает владелец. Сохраняйте Kit маленьким: новая инструкция должна выражать полезное предпочтение, а не пересказывать обычную инженерную практику.
 
-Перед предложением изменения прочитайте подробное руководство [`hub/CONTRIBUTING.md`](hub/CONTRIBUTING.md). Не публикуйте секреты, личный или внутренний контекст и материалы без подтверждённого права распространения.
+Перед передачей выполните `python scripts/check.py`, `git diff --check` и `git status --short`. Нужны Python 3.10+ и Git. Проверяющий скрипт не устанавливает зависимости и не обращается к сети. Прочитайте изменённые инструкции как пользователь; автоматическая проверка не оценивает их практическую пользу.
 
-## Локальная проверка
+Коммиты: английский Conventional Commits с областью (`docs(kit): simplify instructions`), заголовок до 72 символов без точки в конце; тело при необходимости объясняет причину или несовместимость. Один коммит — один связный результат. Автоматический commit hook больше не поставляется.
 
-Требуются Git и Windows PowerShell 5.1 или PowerShell 7+ на Windows. Из корня чистого clone выполните:
-
-```powershell
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/check-hub.ps1
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/test-tooling.ps1
-git diff --check
-git status --short
-```
-
-Участвуя в проекте, учитывайте условия [MIT License](LICENSE): copyright и license notice должны сохраняться в копиях и существенных частях материалов.
+Не включайте приватные пути, решения, отчёты и секреты в публичные файлы. О проблемах безопасности сообщайте по [политике безопасности](.github/SECURITY.md). Участие предполагает сохранение условий [MIT License](LICENSE).
diff --git a/MIGRATION.md b/MIGRATION.md
@@ -0,0 +1,47 @@
+# Совместимость со старым Kit
+
+Новая версия — обычные Markdown-инструкции. Она не обновляет прежние подключения и не преобразует их форматы. Существующий проект можно оставить как есть.
+
+## Что продолжает работать
+
+В режиме снимка manifest/lock `0.2` проект читает собственные `AGENTS.md`, `.ai-rules/RULESET.md`, `.ai-rules/PROJECT_RULES.md` и `.ai-rules/upstream/`. Удаление генератора из Kit не меняет эти файлы. Старые обязательные маршруты сохраняются до отдельного ручного перехода.
+
+Команды `ai-rules.ps1` и `scripts/shared-kit.ps1` в новой версии отсутствуют. Сохранённые в проектах команды со старым путём к checkout больше не запускаются из этого checkout. Для диагностики, старого обновления или необязательного шаблона используйте отдельную историческую копию ниже. Не направляйте старый updater на новую версию.
+
+В экспериментальном shared-режиме `0.1` проект зависит от внешнего `installRoot`, закреплённого выпуска `releases/<releaseId>`, блока `AEK SHARED` в `AGENTS.md` и возможной ссылки `.agents/skills/aek-project-audit`. Сохраняйте сам выпуск, его исходный путь и ссылку. Git SHA восстанавливает исходники Kit, но не приватные файлы проекта и не произвольную локальную сборку выпуска. Новая версия не удаляет установки и не переключает проекты.
+
+## Восстановление прежнего инструмента
+
+Последний исходный SHA перед упрощением:
+
+```text
+f8f406a32299cd00d9e15bb032ef286765b20e77
+```
+
+Из корня существующей копии Kit создайте **отдельный новый каталог**, не сбрасывая текущую рабочую директорию:
+
+```sh
+git clone --no-hardlinks --no-checkout . ../agent-engineering-kit-legacy
+git -C ../agent-engineering-kit-legacy checkout --detach f8f406a32299cd00d9e15bb032ef286765b20e77
+git -C ../agent-engineering-kit-legacy rev-parse HEAD
+```
+
+Если этого объекта нет в локальной истории, получите историю из доверенного origin. Версия доступна также в [GitHub по точному SHA](https://github.com/Dmitryaf/agent-engineering-kit/tree/f8f406a32299cd00d9e15bb032ef286765b20e77). Восстановленный checkout содержит прежние инструкции и инструменты; он не требует возвращать их в новую версию.
+
+В исторической копии, при установленном PowerShell, можно выполнить read-only диагностику, заменив `PROJECT_PATH` реальным путём:
+
+```powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File ../agent-engineering-kit-legacy/ai-rules.ps1 status -ProjectRoot PROJECT_PATH
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File ../agent-engineering-kit-legacy/ai-rules.ps1 doctor -ProjectRoot PROJECT_PATH
+```
+
+Для воспроизведения снимка сохраняйте **его собственный** `source.revision` из manifest/lock, а не подменяйте его приведённым SHA. Исторический updater использует Git-историю для закреплённой версии; изменение manifest и Apply остаются отдельными действиями. Сначала прочитайте README восстановленной версии и план, не применяйте обновление только ради проверки.
+
+## Переход одного проекта, когда он потребуется
+
+1. Сохраните приватную резервную копию `AGENTS.md`, всей `.ai-rules/`, локальных документов и настроек исключения Git. Для shared-проекта сохраните также выпуск, descriptor и цель ссылки Skill. Убедитесь, что копия читается и позволяет восстановить исходные пути. Git Kit не содержит эти данные; игнорирование файла не является резервной копией.
+2. В существующем проектном `AGENTS.md` оставьте команды, ограничения и ссылки на действующие решения. Сначала можно оставить ссылки на прежние `PROJECT_RULES.md` и проектные документы, убрав из них только обязательное подключение общей политики. Учтите исключения из `RULESET.md` и дополнительные локальные инструкции: они могут содержать уникальные решения.
+3. Замените старую цепочку CORE/INDEX/профилей на локальный контекст, проверьте все пути. Не переносите приватный контекст в публичный README или отслеживаемый `AGENTS.md`. Общие личные предпочтения объединяются отдельно по [README](README.md).
+4. Откройте новую сессию Codex в проекте. Проверьте доступность команд и нужных решений без старой цепочки. До этого оставьте старые файлы и резервную копию. Удаление старого снимка, блока shared или ссылки Skill — отдельное действие после проверки отсутствия потребителей.
+
+Для работы над обычным кодом срочная миграция не нужна. Свежий clone публичного проекта не восстановит игнорируемые инструкции и решения: их нужно вернуть из приватной копии с нужными правами. Отсутствующий контекст следует назвать, а не выдумывать.