avandClaude Opus 5
52cc4d05d4
Первый прогон агента — по репозиторию, который его же и содержит. Два прохода, 17 находок, все подтверждены по файлам. Пять находок — остатки прежней модели типов в файлах, до которых я не дошёл двумя коммитами раньше. adopt.md держал имена секций роадмапа канона 2 («порядка», «темы») и «пустой goal законен только у идеи»; from-review.md и TODO.md — упразднённый [idea]; task-batch в другом плагине — «задачи-идеи». Правку модели я вёл от документов, которые менял, а не от тех, что на них ссылаются: grep по упразднённому слову дал бы все пять за минуту. Самая дорогая находка оказалась моей и свежей. Таблица типов в canon.md объявляла цель у fix запрещённой, а tasks/SKILL.md и task-fix.md — необязательной; код на стороне вторых. Копия разошлась с домом за один день, обе половины писал один проход. Поправлено не значение, а причина: canon.md дважды объявлял, что фиксирует только словарь типов, — значит колонкам «разделы» и «цель» в нём не место. Осталась таблица из двух колонок и ссылка на дом схемы. Перечень «чем держат проект» пересказывался втроём и разъехался: «метрики и логи» против «мониторинга», «проверки» есть в двух из трёх. При этом tasks/SKILL.md ссылался на дом рядом с собственным пересказом — ссылка не мешает копии разойтись, если копия всё равно стоит. Перечень остался в canon.md, два места ссылаются. README пересказывал раскладку канона блоком кода, и копия была уже неполна — не хватало путей, чьё отсутствие docs.py считает нарушением. Заменено ссылкой. Там же измеренное число из DECISIONS III заменено ссылкой на решение. REMAINING дублировал два отмеченных сделанными пункта TODO и держал счётчики, которые обязан двигать человек: «двенадцати тем и 16 коммитов» (стало 28 и 52), «три неизмеренных изменения» (стало больше). Счётчики отменены как класс, причина записана в шапку. Открытый вопрос про парный статус ADR переформулирован: судья появился, открыт остался охват. Три противоречия вне av-dev-pm: --roadmap-sections перечислен среди флагов init прозой того же файла, объявляющей, что его нет; review-ops берёт журнал docs/review.md и тут же объявляет историю инцидентов принципиально недоступной; «честный предел» конвейера отменял целиком документ docs/research/. Плюс битый якорь ссылки на раздел вычитки. Находка про Co-Authored-By снята как неверная: агент прочитал av-dev-git/skills/commit/SKILL.md как описание практики этого репозитория, а это продукт, уезжающий в чужие проекты. Устав агента не различает «документ про нас» и «документ про то, что мы производим» — остаток записан в REMAINING, в устав пока не дописан. DECISIONS тема 29 (ЧЧШШ–ЮЮЯЯ, следствия 109–113). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
73 lines
6.0 KiB
Markdown
73 lines
6.0 KiB
Markdown
# 🎯 `goal` — возможность приложения
|
||
|
||
Цель отвечает на **«что приложение будет уметь»**. Не область работ и не имя
|
||
подсистемы: не «Работа со слиянием», а «Исход слияния не зависит от порядка
|
||
доставки». Свойство поведения — тоже возможность.
|
||
|
||
Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
|
||
Здесь только то, что у этого типа своё.
|
||
|
||
## Схема
|
||
|
||
| | |
|
||
| --- | --- |
|
||
| Заголовок отвечает на | что приложение будет уметь |
|
||
| Обязательные разделы | `Завершение` |
|
||
| Допустимые сверх того | — |
|
||
| Поле места | **Секция** — часть роадмапа |
|
||
| Цель (`goal:<слаг>`) | запрещена: цель и есть цель |
|
||
| Индекс | `ROADMAP.md`, и никогда `BACKLOG.md` или `SPRINT.md` |
|
||
| Берётся в спринт | нет — берутся её задачи |
|
||
|
||
Поле места у цели называется **«Секция»**, а не «Категория», и это не разнобой:
|
||
у задачи оно называет полку домена, в которую она вернётся из спринта, а у цели
|
||
— часть роадмапа, то есть состояние очереди. Одно имя на два смысла и было
|
||
конфляцией.
|
||
|
||
## «Завершение» — списком, а не абзацем
|
||
|
||
Это признаки того, что приложение **уже умеет**, и на строки этого раздела
|
||
ссылаются задачи цели: «двигает пункт 2 «Завершения» — накопительная метрика
|
||
перестаёт уменьшаться». Абзацем такая ссылка не берётся, поэтому список.
|
||
|
||
Отсюда же читается обратное и более полезное: **строка «Завершения», к которой
|
||
не относится ни одна задача, — незакрытая часть возможности**. Достаточность
|
||
набора задач видна из самой цели, а не из чьей-то памяти.
|
||
|
||
## Алгоритм
|
||
|
||
1. **Проверить, что это возможность, а не работа.** Работа, которой держат
|
||
проект, на вопрос «что приложение будет уметь» не отвечает; состав перечислен
|
||
[в каноне](../../canon/references/canon.md), раздел «Сопровождение и
|
||
эксплуатация». Ей отведена секция `Сопровождение` — там она видна в том же
|
||
экране и не читается как обещание продукта. Граница проходит по тому,
|
||
**кто наблюдает**:
|
||
«приложение сообщает о своём состоянии» — возможность, «дежурный видит
|
||
состояние на одном экране» — сопровождение.
|
||
2. **Выбрать секцию.** Очередь значима и обоснована прозой — `Запланировано`;
|
||
тянется долго и очереди не имеет — `Направления`; про то, чем держат проект,
|
||
— `Сопровождение`. В `Готово` кладёт сам `close`.
|
||
3. **Написать «Завершение»** — 2–5 наблюдаемых признаков списком. Пишутся до
|
||
декомпозиции: иначе задачи придумают себе цель задним числом.
|
||
4. **Разложить на задачи** и проставить им `goal:<слаг>`. Перечень задач в теле
|
||
цели **не хранится** — он был бы третьим индексом и поехал бы на первой же
|
||
закрытой задаче; выводит `tasks.py list --goal <слаг>`.
|
||
5. **Пометить `decomposed`.** Тег отличает «ещё не разобрана» от «все задачи
|
||
закрыты» — два состояния с одним внешним признаком. `check --fix` ставит его
|
||
сам цели, у которой задачи есть.
|
||
6. **Закрыть достигнутой** — `close <слаг> --implemented`, когда не осталось
|
||
открытых задач. Файл удаляется, строка с датой переезжает в `Готово`. Скрипт
|
||
откажет, если задачи ещё живы.
|
||
|
||
## Что видит машина, а что человек
|
||
|
||
`check` считает цели, различает разобранные и пустые, ставит `decomposed`,
|
||
запрещает закрыть цель с живыми задачами и держит `Секцию` в согласии с
|
||
заголовком роадмапа. **Годность формулировки — не машине**: «возможность это или
|
||
область работ» решает [агент вычитки](../SKILL.md#вычитка-два-прохода-а-не-один).
|
||
|
||
Достигнутая цель **не исчезает**: «что приложение умеет» — половина вопроса, ради
|
||
которого роадмап открывают. Вторым домом поведения роадмап при этом не
|
||
становится: нормативное поведение живёт в `openspec/specs/`, роадмап отвечает,
|
||
**когда и в каком порядке** оно появилось.
|