commit 0683962cd2b8779072471e163d2e4a77439794b2
Author: Витковских Евгений <vitkovskikh@yandex.ru>
Date:   Thu Nov 5 14:03:38 2026 +0500

    README: формат карточек статистики kit-dev-flow и петля опыта

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-задачей
+или при замыкании итерации).