From d35d56bf2eef4c812009fe833154adac8aea199a Mon Sep 17 00:00:00 2001 From: Founding Engineer Date: Sun, 29 Mar 2026 06:35:13 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=D1=82=D1=80=D0=B0=D1=81=D1=81=D0=B8?= =?UTF-8?q?=D1=80=D0=BE=D0=B2=D0=BA=D0=B0=20ENGINEERING=5FREQUIREMENTS=20?= =?UTF-8?q?=E2=86=94=20=D1=82=D0=B8=D0=BA=D0=B5=D1=82=D1=8B=20=E2=86=94=20?= =?UTF-8?q?=D1=80=D0=B5=D0=BF=D0=BE=20(XDE-91)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Добавлена страница docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md с путём к плану в workspace Onboarding, таблицей доставки XDE-84/85/87/89/90 и правилами синхронизации при расхождении CTO/agent cwd. Co-Authored-By: Paperclip Made-with: Cursor --- ...NGINEERING_REQUIREMENTS_TRACEABILITY_RU.md | 34 +++++++++++++++++++ docs/README.md | 1 + 2 files changed, 35 insertions(+) create mode 100644 docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md diff --git a/docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md b/docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md new file mode 100644 index 0000000..54a0596 --- /dev/null +++ b/docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md @@ -0,0 +1,34 @@ +# Трассировка: `ENGINEERING_REQUIREMENTS_SKPKG` ↔ доставка + +Страница для команды и board: **где лежит канон инженерных требований** к Skill Manager / getskillpack и как закрытые инкременты по тикетам [XDE-84](/XDE/issues/XDE-84), [XDE-85](/XDE/issues/XDE-85), [XDE-87](/XDE/issues/XDE-87), [XDE-89](/XDE/issues/XDE-89), [XDE-90](/XDE/issues/XDE-90) отражены в репозиториях org **getskillpack**. Родительский документ требований в Paperclip: [XDE-15](/XDE/issues/XDE-15#document-engineering-requirements). + +## Где живёт план `ENGINEERING_REQUIREMENTS_SKPKG.md` + +| Где | Путь / ссылка | +|-----|----------------| +| **Primary workspace проекта Onboarding** (Paperclip) | `plans/ENGINEERING_REQUIREMENTS_SKPKG.md` — относительно корня workspace проекта (рядом с каталогом `skpkg-cli/`). | +| **Канон смысла** | Тот же файл; обновления — по процессу из самого документа (CTO + board). Краткая выжимка для board при изменении разделов 1–3 — в шапке файла. | + +Публичного «raw» URL на этот файл в GitHub может не быть, если копия не запушена в отдельный репозиторий: источником остаётся workspace / документ в [XDE-15](/XDE/issues/XDE-15). + +## Если workspace CTO и агента разъехались + +1. Свериться с **последней** версией в primary workspace Onboarding или с **issue document** в [XDE-15](/XDE/issues/XDE-15#document-engineering-requirements), если туда вынесли текст. +2. Не править «тихую» копию в личном cwd: либо обновить файл в согласованном месте (workspace / репо), либо зафиксировать расхождение комментарием в релевантном тикете ([XDE-43](/XDE/issues/XDE-43) и др.). + +## Таблица: тикет → репозиторий → артефакт + +Связь с разделами 2–3 `ENGINEERING_REQUIREMENTS_SKPKG.md` (реестр, менеджер на Go, CLI, контракты, CI). + +| Тикет | Репозиторий | Артефакт (контракт, PR, коммит) | +|-------|-------------|----------------------------------| +| [XDE-84](/XDE/issues/XDE-84) | [getskillpack/registry](https://github.com/getskillpack/registry) | **Compiled core** в [`docs/registry-api.md`](https://github.com/getskillpack/registry/blob/main/docs/registry-api.md); исходная поставка — [PR #1](https://github.com/getskillpack/registry/pull/1) (ветка `feature/xde-84-registry-contract`). | +| [XDE-85](/XDE/issues/XDE-85) | [getskillpack/skillget-manager](https://github.com/getskillpack/skillget-manager) | Контракт клиента: [`docs/REGISTRY_CLIENT_CONTRACT.md`](https://github.com/getskillpack/skillget-manager/blob/main/docs/REGISTRY_CLIENT_CONTRACT.md); [PR #1](https://github.com/getskillpack/skillget-manager/pull/1). | +| [XDE-87](/XDE/issues/XDE-87) | [getskillpack/cli](https://github.com/getskillpack/cli) | Выравнивание CLI с контрактом менеджера; [PR #2](https://github.com/getskillpack/cli/pull/2) → `main`, `skillget-manager` **v0.1.4** в `go.mod` / vendor. | +| [XDE-89](/XDE/issues/XDE-89) | [getskillpack/cli](https://github.com/getskillpack/cli) | CI на `main`, [`docs/RELEASE.md`](https://github.com/getskillpack/cli/blob/main/docs/RELEASE.md), [`CHANGELOG.md`](https://github.com/getskillpack/cli/blob/main/CHANGELOG.md); пример фиксации: коммит [`c665522`](https://github.com/getskillpack/cli/commit/c665522). | +| [XDE-90](/XDE/issues/XDE-90) | [getskillpack/registry](https://github.com/getskillpack/registry) | Сверка `API.md` / **Compiled core** с клиентским контрактом; коммиты на `main`, напр. [`77ea41c`](https://github.com/getskillpack/registry/commit/77ea41c), [`1e5f26c`](https://github.com/getskillpack/registry/commit/1e5f26c) (см. тред тикета). | + +## Связанные документы в этом репозитории + +- [AGENT_GITHUB_REPO_WORKFLOW_RU.md](AGENT_GITHUB_REPO_WORKFLOW_RU.md) — как пушить и оформлять PR в org **getskillpack**. +- Архитектурное мемо: [XDE-43](/XDE/issues/XDE-43). diff --git a/docs/README.md b/docs/README.md index b634525..4d4e3e6 100644 --- a/docs/README.md +++ b/docs/README.md @@ -20,6 +20,7 @@ The files below describe org automation, tokens, cadence, and workflows. They ar |-----|-------| | [GETSKILLPACK_GITHUB_ORG.md](GETSKILLPACK_GITHUB_ORG.md) | PAT scopes and org hygiene | | [AGENT_GITHUB_REPO_WORKFLOW_RU.md](AGENT_GITHUB_REPO_WORKFLOW_RU.md) | Agent/repo workflow (Russian) | +| [ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md](ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md) | План ENGINEERING_REQUIREMENTS ↔ тикеты ↔ репо (Russian) | | [BOARD_PAT_QUICK_RU.md](BOARD_PAT_QUICK_RU.md) | PAT setup shorthand (Russian) | | [PAPERCLIP_SKILL_INSTALL_RU.md](PAPERCLIP_SKILL_INSTALL_RU.md) | Skill install runbook (Russian) | | [PRIVATE_REPO_PUBLIC_RELEASE_CHECKLIST.md](PRIVATE_REPO_PUBLIC_RELEASE_CHECKLIST.md) | Pre-public checklist |