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>
6.0 KiB
🎯 goal — возможность приложения
Цель отвечает на «что приложение будет уметь». Не область работ и не имя подсистемы: не «Работа со слиянием», а «Исход слияния не зависит от порядка доставки». Свойство поведения — тоже возможность.
Общая форма записи (мета, слаг, строка индекса) — task-format.md. Здесь только то, что у этого типа своё.
Схема
| Заголовок отвечает на | что приложение будет уметь |
| Обязательные разделы | Завершение |
| Допустимые сверх того | — |
| Поле места | Секция — часть роадмапа |
Цель (goal:<слаг>) |
запрещена: цель и есть цель |
| Индекс | ROADMAP.md, и никогда BACKLOG.md или SPRINT.md |
| Берётся в спринт | нет — берутся её задачи |
Поле места у цели называется «Секция», а не «Категория», и это не разнобой: у задачи оно называет полку домена, в которую она вернётся из спринта, а у цели — часть роадмапа, то есть состояние очереди. Одно имя на два смысла и было конфляцией.
«Завершение» — списком, а не абзацем
Это признаки того, что приложение уже умеет, и на строки этого раздела ссылаются задачи цели: «двигает пункт 2 «Завершения» — накопительная метрика перестаёт уменьшаться». Абзацем такая ссылка не берётся, поэтому список.
Отсюда же читается обратное и более полезное: строка «Завершения», к которой не относится ни одна задача, — незакрытая часть возможности. Достаточность набора задач видна из самой цели, а не из чьей-то памяти.
Алгоритм
- Проверить, что это возможность, а не работа. Работа, которой держат
проект, на вопрос «что приложение будет уметь» не отвечает; состав перечислен
в каноне, раздел «Сопровождение и
эксплуатация». Ей отведена секция
Сопровождение— там она видна в том же экране и не читается как обещание продукта. Граница проходит по тому, кто наблюдает: «приложение сообщает о своём состоянии» — возможность, «дежурный видит состояние на одном экране» — сопровождение. - Выбрать секцию. Очередь значима и обоснована прозой —
Запланировано; тянется долго и очереди не имеет —Направления; про то, чем держат проект, —Сопровождение. ВГотовокладёт самclose. - Написать «Завершение» — 2–5 наблюдаемых признаков списком. Пишутся до декомпозиции: иначе задачи придумают себе цель задним числом.
- Разложить на задачи и проставить им
goal:<слаг>. Перечень задач в теле цели не хранится — он был бы третьим индексом и поехал бы на первой же закрытой задаче; выводитtasks.py list --goal <слаг>. - Пометить
decomposed. Тег отличает «ещё не разобрана» от «все задачи закрыты» — два состояния с одним внешним признаком.check --fixставит его сам цели, у которой задачи есть. - Закрыть достигнутой —
close <слаг> --implemented, когда не осталось открытых задач. Файл удаляется, строка с датой переезжает вГотово. Скрипт откажет, если задачи ещё живы.
Что видит машина, а что человек
check считает цели, различает разобранные и пустые, ставит decomposed,
запрещает закрыть цель с живыми задачами и держит Секцию в согласии с
заголовком роадмапа. Годность формулировки — не машине: «возможность это или
область работ» решает агент вычитки.
Достигнутая цель не исчезает: «что приложение умеет» — половина вопроса, ради
которого роадмап открывают. Вторым домом поведения роадмап при этом не
становится: нормативное поведение живёт в openspec/specs/, роадмап отвечает,
когда и в каком порядке оно появилось.