From 6edb62c592d64e3f2949aaa50e94bb6e3662ad1f Mon Sep 17 00:00:00 2001 From: Andrey Epifancev Date: Tue, 6 Oct 2026 16:52:00 +0400 Subject: [PATCH] =?UTF-8?q?docs(dev):=20=D1=81=D0=BD=D0=B8=D0=BC=D0=BE?= =?UTF-8?q?=D0=BA=20=D0=B4=D0=BB=D1=8F=20=D0=BA=D0=BE=D0=BD=D1=82=D1=83?= =?UTF-8?q?=D1=80=D0=B0=20=D0=B2=D1=8B=D1=80=D0=B5=D0=B7=D0=B0=D0=B5=D1=82?= =?UTF-8?q?=20openspec/config.yaml?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Вопрос разработчика при переносе в контур: .claude/ и CLAUDE.md вырезаются, а openspec/config.yaml с контекстом агента остаётся. Решение владельца 06.10.2026: вырезать, как CLAUDE.md. Блоки context/rules — инструкции агенту с путями ../docs и ../fixtures, которые в контуре никуда не ведут; openspec CLI в контуре нет, specs/ и design.md читаются без него. - prepare-contour-snapshot.sh: rm, проверка раздела 5, SNAPSHOT.md - contour-transfer-guide.md: таблица раздела 1, разделы 2, 3, 9 Проверено прогоном скрипта на tabular-parser@3b32462. Closes #36 Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2 --- dev/contour-transfer-guide.md | 13 ++++++------- scripts/prepare-contour-snapshot.sh | 15 ++++++++------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/dev/contour-transfer-guide.md b/dev/contour-transfer-guide.md index 69027ae..7d6940c 100644 --- a/dev/contour-transfer-guide.md +++ b/dev/contour-transfer-guide.md @@ -14,8 +14,8 @@ Gitea в контуре нет) | Что | В контур | Почему | |---|---|---| | `api/` (код, тесты, `contracts/`, `rules/`, `alembic/`, `scripts/`), `web/` (arm-core), `README.md`, `Makefile`, `setup/`, `raisa_config.yml`, `api/.env.example`, `api/.env.test` | да | это и есть сервис по шаблону платформы | -| `openspec/specs/`, `openspec/changes/archive/`, `openspec/config.yaml` | да | спецификация системы и журнал решений (`design.md`); без них код в контуре нечем объяснять | -| `.claude/`, `CLAUDE.md` | **нет** | инструкции и skills AI-агента, инструментарий внешней разработки | +| `openspec/specs/`, `openspec/changes/archive/` | да | спецификация системы и журнал решений (`design.md`); без них код в контуре нечем объяснять | +| `.claude/`, `CLAUDE.md`, `openspec/config.yaml` | **нет** | инструкции и контекст AI-агента (в `config.yaml` — блоки `context`/`rules` с путями `../docs`, `../fixtures`), инструментарий внешней разработки; `openspec` CLI в контуре нет, `specs/` и `design.md` читаются без него | | `docs/superpowers/` (планы, ledger) | **нет** | рабочие артефакты процесса, содержат локальные пути разработчика | | `Dockerfile`, `.dockerignore` | **нет** | образ для локального `make check-full`; в контуре образ собирает платформа своим CI (шаблон держит `Dockerfile` в `.gitignore`) | | История коммитов | **нет** | снимок одним коммитом; в истории снаружи — трейлеры `Co-Authored-By: Claude …`, `Claude-Session`, ссылки на внешний Gitea | @@ -35,8 +35,8 @@ Gitea в контуре нет) нет. Цели `make up`, `test-integration`, `check-full` в контуре не запускаются; `docker-build` удалена из `Makefile`. - `docs` и `fixtures` рядом с сервисом — тесты идентичности контракта и тесты на реальных данных пропускаются (раздел 5), сверка ORM с DBML (`make dbml-check` в arm-core) не выполняется. -- `tea`, `codegraph`, `openspec` (CLI), хуки `.claude/hooks` — инструментарий процесса; в снимке только их следы в - `openspec/config.yaml` (контекст для агента, безвреден). +- `tea`, `codegraph`, `openspec` (CLI), хуки `.claude/hooks` — инструментарий процесса; его конфигурация + (`.claude/`, `CLAUDE.md`, `openspec/config.yaml`) вырезается. - Внешний Gitea `git.aepif.ru` — ссылки вида `https://git.aepif.ru/RSHB/arm-core/pulls/19` в архивах change'ей скрипт превращает в `RSHB/arm-core#19` (номера относятся к внешнему Gitea, в контуре их нет). @@ -64,13 +64,13 @@ docs/scripts/prepare-contour-snapshot.sh scan-gateway /tmp/contour Что делает скрипт (репозиторий-источник не меняется): 1. `git archive ` → `/tmp/contour//` — дерево коммита без `.git` и без игнорируемых файлов. -2. Удаляет `.claude/`, `CLAUDE.md`, `docs/superpowers/`, `Dockerfile`, `.dockerignore`. +2. Удаляет `.claude/`, `CLAUDE.md`, `openspec/config.yaml`, `docs/superpowers/`, `Dockerfile`, `.dockerignore`. 3. Правит `Makefile`: цель `venv` → `python3.11 -m venv` + `pip install -r requirements-dev.txt` с `setup/pip.conf` (переменная `PYTHON`, по умолчанию `python3.11`); удаляет цель `docker-build` и её упоминания в `check-full`, `.PHONY`, `help`. 4. Заменяет ссылки на внешний Gitea на `RSHB/#`. 5. Пишет `SNAPSHOT.md` (источник, хеш, дата, что вырезано). -6. Проверяет: нет `.claude`/`CLAUDE.md`/планов/`Dockerfile`, нет локальных путей (`/Users/…`, `/home/…`), нет `uv` и +6. Проверяет: нет `.claude`/`CLAUDE.md`/`openspec/config.yaml`/планов/`Dockerfile`, нет локальных путей (`/Users/…`, `/home/…`), нет `uv` и `git.aepif.ru`, на месте платформенные файлы (`raisa_config.yml`, `setup/`, `run_server.py`, `requirements.txt`, `.env.test`, `contracts/`). Любая проблема — код возврата 1 и список. @@ -175,6 +175,5 @@ git diff <коммит sync> HEAD -- . ':!SNAPSHOT.md' > /tmp/contour-arm-core.p скрипт их не переписывает. Ориентир для контура — этот документ и `SNAPSHOT.md`. - В `openspec/changes/archive/*/` остаются относительные пути вида `../docs/openspec/...` и `../fixtures/...`: это ссылки на внешний workspace, в контуре они никуда не ведут. -- `openspec/config.yaml` содержит контекст для AI-агента (упоминает `../docs`, фикстуры, стек); на сборку не влияет. - Тесты, которые снаружи пропускаются без `fixtures`, в контуре не выполняются никогда. Поэтому перед каждым снимком снаружи обязателен `make check-full` с доступными `docs` и `fixtures` (`dev/checks.md`, раздел «Порядок перед PR»). diff --git a/scripts/prepare-contour-snapshot.sh b/scripts/prepare-contour-snapshot.sh index a64e86e..e4285e9 100755 --- a/scripts/prepare-contour-snapshot.sh +++ b/scripts/prepare-contour-snapshot.sh @@ -40,10 +40,11 @@ mkdir -p "$DEST" git -C "$REPO" archive "$REF" | tar -x -C "$DEST" # --- 1. Вырезать то, чего в контуре нет ------------------------------------------------------------------------ -# .claude/, CLAUDE.md — инструкции и skills AI-агента; docs/superpowers/ — планы и ledger (в них локальные пути); -# Dockerfile/.dockerignore — локальная сборка образа, платформа собирает образ своим CI. openspec/ остаётся: -# это спецификация проекта и решения (design.md). -rm -rf "$DEST/.claude" "$DEST/CLAUDE.md" "$DEST/docs/superpowers" "$DEST/Dockerfile" "$DEST/.dockerignore" +# .claude/, CLAUDE.md, openspec/config.yaml — инструкции и контекст AI-агента (config.yaml: блоки context/rules с путями +# ../docs и ../fixtures; openspec CLI в контуре нет, specs/ и design.md читаются без него); docs/superpowers/ — планы и +# ledger (в них локальные пути); Dockerfile/.dockerignore — локальная сборка образа, платформа собирает образ своим CI. +# openspec/specs/ и openspec/changes/archive/ остаются: это спецификация проекта и решения (design.md). +rm -rf "$DEST/.claude" "$DEST/CLAUDE.md" "$DEST/openspec/config.yaml" "$DEST/docs/superpowers" "$DEST/Dockerfile" "$DEST/.dockerignore" rmdir "$DEST/docs" 2>/dev/null || true # --- 2. Makefile: venv через python -m venv + pip с Nexus, без uv; без docker-build -------------------------------- @@ -131,8 +132,8 @@ cat > "$DEST/SNAPSHOT.md" <&2; fail=1; fi done if grep -rIn "/Users/\|/home/[a-z]" "$DEST" >/dev/null 2>&1; then -- 2.47.2