From 0683962cd2b8779072471e163d2e4a77439794b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D1=82=D0=BA=D0=BE=D0=B2=D1=81=D0=BA=D0=B8?=
 =?UTF-8?q?=D1=85=20=D0=95=D0=B2=D0=B3=D0=B5=D0=BD=D0=B8=D0=B9?=
 <vitkovskikh@yandex.ru>
Date: Thu, 5 Nov 2026 14:03:38 +0500
Subject: [PATCH] =?UTF-8?q?README:=20=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=82?=
 =?UTF-8?q?=20=D0=BA=D0=B0=D1=80=D1=82=D0=BE=D1=87=D0=B5=D0=BA=20=D1=81?=
 =?UTF-8?q?=D1=82=D0=B0=D1=82=D0=B8=D1=81=D1=82=D0=B8=D0=BA=D0=B8=20kit-de?=
 =?UTF-8?q?v-flow=20=D0=B8=20=D0=BF=D0=B5=D1=82=D0=BB=D1=8F=20=D0=BE=D0=BF?=
 =?UTF-8?q?=D1=8B=D1=82=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3482846
--- /dev/null
+++ b/README.md
@@ -0,0 +1,69 @@
+# DB.FlowExp_WorkStatistics — общая статистика применения навыка kit-dev-flow
+
+Единое хранилище опыта работы навыка `kit-dev-flow` (плагин kit-knowledge,
+маркетплейс dev-sys-qa-interactive): карточки прогонов workflow по **всем
+проектам**, где навык применялся. Данные пишутся навыком автоматически —
+действий разработчика не требуется.
+
+## Как работает петля
+
+```
+прогон workflow → карточка (авто: commit + push) → агрегаты flow_stats.py
+       ↑                                                ↓
+       └──── промпты субагентов следующего шага ← навык читает перед шагом
+```
+
+- **После каждого прогона** навык: метрики из отчёта рана ZCode → карточка
+  → `git add + commit + push` (remote недоступен — карточка копится в
+  локальном клоне и уезжает со следующим успешным пушем).
+- **Перед планированием шага** навык: `git pull` → агрегаты по классу шага
+  по всем проектам → удачные приёмы в промпты, неудачные исключаются,
+  выбор формы (пресет/генерация) — по фактической статистике.
+
+## Формат карточки
+
+Путь: `runs/<год>/<дата>-<проект>-<шаг>-<hash>.md`
+
+```markdown
+---
+date: 2026-11-05 14:30
+project: kit-rag
+step: 7.4 этап 2
+kind: db            # документ | требования | архитектура | db | этап-модуля
+form: preset        # preset | generated
+preset: kit-dev-process
+model: GLM-5.3-Flash
+agents: 6
+revisions: 2
+escalations: 1
+result: success     # success | partial | fail
+duration_min: 45
+run_id: dwfrun-...
+---
+## Что делали
+…
+## Уроки (что учесть в следующий раз)
+- …
+```
+
+Имена файлов уникальны (дата+проект+шаг+hash) — параллельная запись
+нескольких разработчиков конфликтов не создаёт.
+
+## Подключение (однократно на машину)
+
+В `~/.zcode/kit-knowledge.json`:
+
+```json
+{
+  "flow_exp_dir": "I:\\Kit\\DB.FlowExp_WorkStatistics",
+  "flow_exp_remote": "https://git.mind01.ru/DB/DB.FlowExp_WorkStatistics.git"
+}
+```
+
+Нет локального клона — навык склонирует по `flow_exp_remote` сам.
+
+## Сводка
+
+`_summary.md` — агрегированный отчёт за период (генерируется
+`flow_stats.py` из плагина kit-knowledge; обновляется вручную, cron-задачей
+или при замыкании итерации).