docs: устранены расхождения между CLAUDE.md, паспортом и беклогом

- формат пункта блокера жил в двух местах и разошёлся (четыре пункта против трёх, без рекомендации); теперь его описывает индекс беклога, CLAUDE.md ссылается
- три потребителя названы в паспорте поимённо: README звал их по функции, беклог по прозвищу, канонического списка не было нигде
- восстановлена фраза «спрашиваем только про необратимое» в своём абзаце — вставка про prior art её оторвала
This commit is contained in:
av
2026-08-02 07:06:27 +03:00
parent 2070ef438c
commit 84bcbbea5c
4 changed files with 31 additions and 13 deletions
+7 -6
View File
@@ -92,16 +92,17 @@ Module path — `git.vakhrushev.me/av/healthlog`.
проходы — агенты `healthlog-review-*`.
**Действуем автономно.** Умолчание — делать, а не спрашивать. Вопрос, который
решать не мне, **вынимается блокером** в секцию `блокеры` беклога (что решить,
варианты с ценой каждого, что стоит без решения, рекомендация), задача
переформулируется на остаток, остаток доводится до коммита. Блокеры
разбираются пачками.
решать не мне, **вынимается блокером** в секцию `блокеры` беклога, задача
переформулируется на остаток, остаток доводится до коммита. Блокеры разбираются
пачками; из чего состоит пункт блокера — в
[индексе беклога](docs/backlog/README.md). Спрашиваем только про
**необратимое**: деплой, выкладку наружу, удаление или перезапись данных в
`./data`.
**Развилка или блокер — сперва prior art.** Проект не уникален: прежде чем
проектировать своё, смотрим, как это решено в референсах
[паспорта](docs/passport.md) и в интернете. Готовое решение либо берётся, либо
отвергается с названной причиной — и причина идёт в `architecture.md`. Спрашиваем только про **необратимое**: деплой, выкладку
наружу, удаление или перезапись данных в `./data`.
отвергается с названной причиной — и причина идёт в `architecture.md`.
Гейт блокирует: пока `task gate` красный, опиниативные проходы ревью не
запускаются.
+4 -4
View File
@@ -6,10 +6,10 @@
## Зачем
Данные о здоровье и тренировках нужны сразу нескольким приложениям: анализ
здоровья, разбор тренировок, мотиватор по активности. Интегрировать каждое
из них с Health Auto Export по отдельности — значит в каждом писать приём,
дедупликацию и хранение заново.
Данные о здоровье и тренировках нужны сразу трём моим приложениям: агенту-медику
(анализ здоровья), трекеру (разбор тренировок) и игре (мотиватор по активности).
Интегрировать каждое из них с Health Auto Export по отдельности — значит в
каждом писать приём, дедупликацию и хранение заново.
healthlog делает это один раз. Телефон шлёт данные в него, все остальные
проекты берут данные из него.
+9 -3
View File
@@ -7,9 +7,15 @@
**Блокеры** — вопросы, вынутые из задач. Работа над задачей идёт автономно; если
внутри обнаружился вопрос, который решать не мне, он **вынимается** отдельным
пунктом сюда, а сама задача переформулируется на остаток и продолжается. Пункт
блокера отвечает на три вопроса: что именно решить, какие есть варианты с ценой
каждого, и что заблокировано, пока решения нет. Разбираются пачками, а не по
одному — прерывать поток ради каждого дороже, чем накопить.
блокера отвечает на четыре вопроса: что именно решить, какие есть варианты с
ценой каждого, что заблокировано пока решения нет, и какая **рекомендация**
без неё вопрос перекладывается целиком, а решать его всё равно с тем же
контекстом. Разбираются пачками, а не по одному: прерывать поток ради каждого
дороже, чем накопить.
Варианты ищутся **не с нуля**: сперва prior art — как это решено в референсах
[паспорта](../passport.md) и в интернете, — и только потом своё. Готовое решение
либо берётся, либо отвергается с названной причиной.
## блокеры
+11
View File
@@ -11,6 +11,17 @@
проект — так, чтобы ни один из них не писал приём, дедупликацию и хранение
заново.
**Потребителей три**, и в остальных документах они зовутся так:
| Как называем | Что это | Что ему нужно от нас |
| --- | --- | --- |
| **агент-медик** | анализ здоровья через MCP | актуальная сводка, влезающая в контекст |
| **трекер** | разбор тренировок | тренировка целиком, с маршрутом и рядом пульса |
| **игра** | мотиватор по активности | шаги и энергия с суточной разбивкой |
Список закрытый: он определяет, что считать нужным, а что — интересным. Появится
четвёртый — строка добавляется сюда, а не подразумевается.
Цель достигнута, когда одновременно верно:
- телефон шлёт непрерывно, и поток не требует внимания неделями;