dev-skills/TODO.md at 2d69ab691ef4b1e7cd94d95d22b999a9ba382a3d

av/dev-skills

Fork 0

Files

T

avandClaude Opus 5 0c8390d774

форма записи: заголовок отвечает на вопрос своего типа

Обкатка скилла tasks на выдуманном проекте — консольные крестики-нолики
на JavaScript, каталог заведён с нуля тем же скриптом. Форма вылезла
раньше содержания, и правки все про неё.

Заголовок отвечает на вопрос типа записи, и форм три: цель —
утверждение о возможности, задача — глагол в неопределённой форме
(допускается «не» перед ним), идея — назывное, без обещания. Причина не
стилистическая: описательный заголовок называет состояние, а из
состояния не видно, чего от работы ждут — «Ничья объявляется, пока
клетки есть» одинаково читается как жалоба и как задание. Отсюда же
разница индексов: роадмап — список возможностей, беклог — список работ,
и перепутанные формы делают каждый похожим на другой.

Механизировано ровно то, что механизируется: check считает заголовки,
где первое слово не на -ть/-ти/-чь, и печатает число в блоке здоровья.
Замечанием на файл нельзя — эвристика грубая, а на 97 записях двух живых
проектов это поток одинаковых строк, после которого пропускают весь блок.

Годность формулировки судит отдельный агент task-wording, а не чек-лист
в скилле: сейчас формулировку пишет и проверяет один агент в одном
контексте, а самопроверка текста слабее всего там, где формулировка
казалась удачной при написании. Он ничего не правит — возвращает готовые
формулировки, и заголовок с «зачем» показываются человеку, потому что
по ним задачу выбирают. Ничего из того, что ловит tasks.py check, он не
трогает намеренно: это был бы второй дом для правила.

Заголовки секций — с прописной, после заголовка пустая строка, во всех
индексах. Канонические имена стали Готово | Запланировано | Направления
| Разработка (англ. Done | Planned | Directions | Tooling), сверка везде
по нижнему регистру, так что старые индексы читаются по-прежнему.
Отбивка живёт на записи, а не на вставке: через Plan.index проходит
каждая правка индекса, а мест вставки три.

Имя секции принадлежит заголовку индекса, файл на неё только ссылается.
Это разрешает единственную неоднозначность починки — расхождение в одном
регистре правится в пользу заголовка. Без него переезд на канон оставил
бы «Готово» в роадмапе и «готово» в каждом файле цели, и свести это было
бы некому. Регистр правится только у канонических секций: имена секций
беклога выбирает проект.

Обкатка нашла два дефекта, которых не находили ни линтеры, ни свои
проверки. Вставка в пустую секцию съедала отбивку перед следующим
заголовком — пропуск пустых строк теперь идёт только до первой непустой.
Мета, разорванная пустой строкой, теряла поля молча: check видел лишь
следствие («без рода работы») и советовал edit --kind, который дописывал
второе такое же поле. Поле меты в теле стало ошибкой с названной
причиной, и --fix её намеренно не чинит — какое из двух значений верное,
знает человек.

DECISIONS тема 20 (ЕЕЕ–ККК, следствия 82–85), changelog канона v3
пополнен двумя пунктами и двумя шагами переезда, TODO — два шага для
healthlog и jellybit.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-04 19:06:54 +03:00

13 KiB

Raw Blame History

Работы по итогам разбора

0. Предусловие

1. Репозиторий плагинов

1.1 Переименование

1.2 Канон — единственный дом определения

1.3 Правки существующих скиллов

1.4 Новые скиллы

1.5 av-dev-pipeline

1.6 Прочее

1.7 Линтеры скриптов (тема 9)

1.8 Ревью двумя проходами (тема 10)

1.9 Ревью зависимостей между плагинами (тема 11)

1.10 Механическая проверка копий (тема 12)

2. healthlog — первая боевая проверка

3. Калибровка — блокирует шаг 5

4. Обкатка

5. jellybit

6. Канон версии 3 — повысить живые проекты (тема 17)

13 KiB Raw Blame History Unescape Escape

Работы по итогам разбора

0. Предусловие

1. Репозиторий плагинов

1.1 Переименование

1.2 Канон — единственный дом определения

1.3 Правки существующих скиллов

1.4 Новые скиллы

1.5 av-dev-pipeline

1.6 Прочее

1.7 Линтеры скриптов (тема 9)

1.8 Ревью двумя проходами (тема 10)

1.9 Ревью зависимостей между плагинами (тема 11)

1.10 Механическая проверка копий (тема 12)

2. healthlog — первая боевая проверка

3. Калибровка — блокирует шаг 5

4. Обкатка

5. jellybit

6. Канон версии 3 — повысить живые проекты (тема 17)

13 KiB

Raw Blame History