docs: устранены расхождения между CLAUDE.md, паспортом и беклогом
- формат пункта блокера жил в двух местах и разошёлся (четыре пункта против трёх, без рекомендации); теперь его описывает индекс беклога, CLAUDE.md ссылается - три потребителя названы в паспорте поимённо: README звал их по функции, беклог по прозвищу, канонического списка не было нигде - восстановлена фраза «спрашиваем только про необратимое» в своём абзаце — вставка про prior art её оторвала
This commit is contained in:
@@ -92,16 +92,17 @@ Module path — `git.vakhrushev.me/av/healthlog`.
|
|||||||
проходы — агенты `healthlog-review-*`.
|
проходы — агенты `healthlog-review-*`.
|
||||||
|
|
||||||
**Действуем автономно.** Умолчание — делать, а не спрашивать. Вопрос, который
|
**Действуем автономно.** Умолчание — делать, а не спрашивать. Вопрос, который
|
||||||
решать не мне, **вынимается блокером** в секцию `блокеры` беклога (что решить,
|
решать не мне, **вынимается блокером** в секцию `блокеры` беклога, задача
|
||||||
варианты с ценой каждого, что стоит без решения, рекомендация), задача
|
переформулируется на остаток, остаток доводится до коммита. Блокеры разбираются
|
||||||
переформулируется на остаток, остаток доводится до коммита. Блокеры
|
пачками; из чего состоит пункт блокера — в
|
||||||
разбираются пачками.
|
[индексе беклога](docs/backlog/README.md). Спрашиваем только про
|
||||||
|
**необратимое**: деплой, выкладку наружу, удаление или перезапись данных в
|
||||||
|
`./data`.
|
||||||
|
|
||||||
**Развилка или блокер — сперва prior art.** Проект не уникален: прежде чем
|
**Развилка или блокер — сперва prior art.** Проект не уникален: прежде чем
|
||||||
проектировать своё, смотрим, как это решено в референсах
|
проектировать своё, смотрим, как это решено в референсах
|
||||||
[паспорта](docs/passport.md) и в интернете. Готовое решение либо берётся, либо
|
[паспорта](docs/passport.md) и в интернете. Готовое решение либо берётся, либо
|
||||||
отвергается с названной причиной — и причина идёт в `architecture.md`. Спрашиваем только про **необратимое**: деплой, выкладку
|
отвергается с названной причиной — и причина идёт в `architecture.md`.
|
||||||
наружу, удаление или перезапись данных в `./data`.
|
|
||||||
|
|
||||||
Гейт блокирует: пока `task gate` красный, опиниативные проходы ревью не
|
Гейт блокирует: пока `task gate` красный, опиниативные проходы ревью не
|
||||||
запускаются.
|
запускаются.
|
||||||
|
|||||||
@@ -6,10 +6,10 @@
|
|||||||
|
|
||||||
## Зачем
|
## Зачем
|
||||||
|
|
||||||
Данные о здоровье и тренировках нужны сразу нескольким приложениям: анализ
|
Данные о здоровье и тренировках нужны сразу трём моим приложениям: агенту-медику
|
||||||
здоровья, разбор тренировок, мотиватор по активности. Интегрировать каждое
|
(анализ здоровья), трекеру (разбор тренировок) и игре (мотиватор по активности).
|
||||||
из них с Health Auto Export по отдельности — значит в каждом писать приём,
|
Интегрировать каждое из них с Health Auto Export по отдельности — значит в
|
||||||
дедупликацию и хранение заново.
|
каждом писать приём, дедупликацию и хранение заново.
|
||||||
|
|
||||||
healthlog делает это один раз. Телефон шлёт данные в него, все остальные
|
healthlog делает это один раз. Телефон шлёт данные в него, все остальные
|
||||||
проекты берут данные из него.
|
проекты берут данные из него.
|
||||||
|
|||||||
@@ -7,9 +7,15 @@
|
|||||||
**Блокеры** — вопросы, вынутые из задач. Работа над задачей идёт автономно; если
|
**Блокеры** — вопросы, вынутые из задач. Работа над задачей идёт автономно; если
|
||||||
внутри обнаружился вопрос, который решать не мне, он **вынимается** отдельным
|
внутри обнаружился вопрос, который решать не мне, он **вынимается** отдельным
|
||||||
пунктом сюда, а сама задача переформулируется на остаток и продолжается. Пункт
|
пунктом сюда, а сама задача переформулируется на остаток и продолжается. Пункт
|
||||||
блокера отвечает на три вопроса: что именно решить, какие есть варианты с ценой
|
блокера отвечает на четыре вопроса: что именно решить, какие есть варианты с
|
||||||
каждого, и что заблокировано, пока решения нет. Разбираются пачками, а не по
|
ценой каждого, что заблокировано пока решения нет, и какая **рекомендация** —
|
||||||
одному — прерывать поток ради каждого дороже, чем накопить.
|
без неё вопрос перекладывается целиком, а решать его всё равно с тем же
|
||||||
|
контекстом. Разбираются пачками, а не по одному: прерывать поток ради каждого
|
||||||
|
дороже, чем накопить.
|
||||||
|
|
||||||
|
Варианты ищутся **не с нуля**: сперва prior art — как это решено в референсах
|
||||||
|
[паспорта](../passport.md) и в интернете, — и только потом своё. Готовое решение
|
||||||
|
либо берётся, либо отвергается с названной причиной.
|
||||||
|
|
||||||
## блокеры
|
## блокеры
|
||||||
|
|
||||||
|
|||||||
@@ -11,6 +11,17 @@
|
|||||||
проект — так, чтобы ни один из них не писал приём, дедупликацию и хранение
|
проект — так, чтобы ни один из них не писал приём, дедупликацию и хранение
|
||||||
заново.
|
заново.
|
||||||
|
|
||||||
|
**Потребителей три**, и в остальных документах они зовутся так:
|
||||||
|
|
||||||
|
| Как называем | Что это | Что ему нужно от нас |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| **агент-медик** | анализ здоровья через MCP | актуальная сводка, влезающая в контекст |
|
||||||
|
| **трекер** | разбор тренировок | тренировка целиком, с маршрутом и рядом пульса |
|
||||||
|
| **игра** | мотиватор по активности | шаги и энергия с суточной разбивкой |
|
||||||
|
|
||||||
|
Список закрытый: он определяет, что считать нужным, а что — интересным. Появится
|
||||||
|
четвёртый — строка добавляется сюда, а не подразумевается.
|
||||||
|
|
||||||
Цель достигнута, когда одновременно верно:
|
Цель достигнута, когда одновременно верно:
|
||||||
|
|
||||||
- телефон шлёт непрерывно, и поток не требует внимания неделями;
|
- телефон шлёт непрерывно, и поток не требует внимания неделями;
|
||||||
|
|||||||
Reference in New Issue
Block a user