generated from VLADIMIR/template
4.7 KiB
4.7 KiB
name: todo-collect description: Записывает найденные улучшения «вне скоупа» текущей задачи в локальную папку todo/ — каждую задачу в отдельный файл, без выполнения и без расширения scope. Загружай при работе над любой задачей (реализация, ревью, рефакторинг, исследование), чтобы не терять замечания, не мешающие текущей работе. whenToUse: В процессе любой задачи обнаружено улучшение, оптимизация, потенциальный баг или долг, которые не блокируют и не относятся к текущей задаче. Триггеры: замечание в коде, «на будущее» из ревью, осознанное ограничение, отложенное решение.
Сбор улучшений «вне скоупа» в todo/
Контекст
В ходе задачи постоянно встречаются места, которые можно улучшить, но чинить их сейчас — значит расширять scope и рисковать текущей работой (правило «не отклоняйся молча»). Такие находки не должны теряться: они записываются в локальную папку todo/ репозитория (в .gitignore, в git не попадает) — каждая задача в свой отдельный файл.
Правила
- Записывай, не чини. Нашёл улучшение, не мешающее текущей задаче — запиши в
todo/и продолжай текущую работу. Не выполняй записанные задачи в текущей сессии, если пользователь явно об этом не попросил. - Одна задача — один файл. Имя файла — kebab-case, отражающее суть:
todo/<chto-i-gde>.md(например,todo/mapimage-idempotent-prefix.md). Если файл с той же сутью уже существует — дополни его, не создавай дубль. - Записывай сразу. Не откладывай «на потом»: в конце задачи контекст уже потерян. Короткая запись по шаблону ниже занимает минуту.
- Фиксируй только факты и предложения. Без воды: что не так, где, как исправить (с оценкой риска), кто/когда нашёл.
- Не перемещай и не удаляй чужие записи. Менять статус/содержимое своей записи можно; чужие — только по договорённости.
- Папка локальная.
todo/в.gitignore— не коммить, не синхронизировать. Если задача заслуживает общего трекинга — предложи пользователю перенести её в issue-трекер.
Шаблон записи
# <Краткое название задачи>
- **Где найдено**: <файл/пакет/место в коде; в какой задаче>
- **Дата**: <YYYY-MM-DD>
- **Статус**: todo
## Проблема
<что именно не так, почему это проблема, при каких условиях проявится>
## Предложение
<как исправить, с указанием конкретных файлов/функций; оценка риска и объёма>
## Связи
<опционально: связанные todo-файлы, ссылки на код, замечания ревью>
Статусы
todo— записано, не начато;in_progress— кто-то взялся (укажи имя/сессию);done— выполнено (укажи, как и когда; можно удалить файл после подтверждения).
Критерии готовности записи
- Проблема описана так, что понятна без контекста исходной задачи.
- Предложено конкретное исправление (или явно сказано, что решение открыто).
- Файл лежит в
todo/с kebab-case именем, дублей нет.