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