From c22a83c6af8ed35125558b04aa880f9285098e22 Mon Sep 17 00:00:00 2001
From: Paperclip Founding Engineer <founding-engineer@paperclip.ing>
Date: Sun, 29 Mar 2026 10:16:15 +0300
Subject: [PATCH] =?UTF-8?q?docs(readme):=20=D0=BD=D0=B0=D0=B2=D0=B8=D0=B3?=
 =?UTF-8?q?=D0=B0=D1=86=D0=B8=D1=8F=20=D0=BA=20=D0=BC=D0=B0=D1=82=D1=80?=
 =?UTF-8?q?=D0=B8=D1=86=D0=B5,=20registry=20runbook=20=D0=B8=20traceabilit?=
 =?UTF-8?q?y=20(XDE-101)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Paperclip <noreply@paperclip.ing>
Made-with: Cursor
---
 README.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7eae8af..d5ce869 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,16 @@ Build from Go source instead? See **Install** below (`go build` + `skillget conf
 - **[Quick start](docs/QUICKSTART.md)** — env vars, `search` / `install` / `config`.
 - **Registry contract:** [registry-api.md](https://github.com/getskillpack/registry/blob/main/docs/registry-api.md) · **[Publish a skill](docs/PUBLISH_YOUR_SKILL.md)**.
 
+### Где что лежит (матрица, runbook, traceability)
+
+Короткие указатели для сопровождения экосистемы (детали только в целевых документах):
+
+- **Матрица совместимости** (CLI / skillget-manager / registry): [COMPATIBILITY_MATRIX_RU.md](docs/COMPATIBILITY_MATRIX_RU.md)
+- **Ops / runbook публичного registry** (`getskillpack/registry`): [PUBLIC_REGISTRY_RUNBOOK.md](https://github.com/getskillpack/registry/blob/main/docs/PUBLIC_REGISTRY_RUNBOOK.md)
+- **Traceability** (ENGINEERING_REQUIREMENTS ↔ тикеты ↔ репозитории): [ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md](docs/ENGINEERING_REQUIREMENTS_TRACEABILITY_RU.md)
+
+Полный индекс каталога `docs/`: [docs/README.md](docs/README.md).
+
 ### vs familiar package registries (short)
 
 | | npm · PyPI · Packagist | skillget / getskillpack |
@@ -47,7 +57,7 @@ Build from Go source instead? See **Install** below (`go build` + `skillget conf
 | Discover + pin | registry + lockfile | **`skillget search` / `install` + `skills.lock`** |
 | On-disk tree | `node_modules` / site-packages / `vendor` | **`.skillget/skills/<name>/<version>/`** |
 
-Expanded positioning and growth framing (maintainers): [docs/MARKETING_LANDING_AND_GROWTH.md](docs/MARKETING_LANDING_AND_GROWTH.md) · [docs/README.md](docs/README.md) (full index). Hands-on discovery: [Example skill catalog](docs/EXAMPLE_SKILL_CATALOG.md).
+Expanded positioning and growth framing (maintainers): [docs/MARKETING_LANDING_AND_GROWTH.md](docs/MARKETING_LANDING_AND_GROWTH.md). Hands-on discovery: [Example skill catalog](docs/EXAMPLE_SKILL_CATALOG.md).
 
 **If this is useful:** starring [`getskillpack/cli`](https://github.com/getskillpack/cli), [`getskillpack/registry`](https://github.com/getskillpack/registry), and [`getskillpack/skillget-manager`](https://github.com/getskillpack/skillget-manager) helps discovery — no bots or reciprocal schemes; see [docs/MARKETING_LANDING_AND_GROWTH.md](docs/MARKETING_LANDING_AND_GROWTH.md).