--- name: todo-collect description: Записывает найденные улучшения «вне скоупа» текущей задачи в локальную папку todo/ — каждую задачу в отдельный файл, без выполнения и без расширения scope. Загружай при работе над любой задачей (реализация, ревью, рефакторинг, исследование), чтобы не терять замечания, не мешающие текущей работе. whenToUse: В процессе любой задачи обнаружено улучшение, оптимизация, потенциальный баг или долг, которые не блокируют и не относятся к текущей задаче. Триггеры: замечание в коде, «на будущее» из ревью, осознанное ограничение, отложенное решение. --- # Сбор улучшений «вне скоупа» в todo/ ## Контекст В ходе задачи постоянно встречаются места, которые можно улучшить, но чинить их сейчас — значит расширять scope и рисковать текущей работой (правило «не отклоняйся молча»). Такие находки не должны теряться: они записываются в локальную папку `todo/` репозитория (в `.gitignore`, в git не попадает) — **каждая задача в свой отдельный файл**. ## Правила 1. **Записывай, не чини.** Нашёл улучшение, не мешающее текущей задаче — запиши в `todo/` и продолжай текущую работу. Не выполняй записанные задачи в текущей сессии, если пользователь явно об этом не попросил. 2. **Одна задача — один файл.** Имя файла — kebab-case, отражающее суть: `todo/.md` (например, `todo/mapimage-idempotent-prefix.md`). Если файл с той же сутью уже существует — дополни его, не создавай дубль. 3. **Записывай сразу.** Не откладывай «на потом»: в конце задачи контекст уже потерян. Короткая запись по шаблону ниже занимает минуту. 4. **Фиксируй только факты и предложения.** Без воды: что не так, где, как исправить (с оценкой риска), кто/когда нашёл. 5. **Не перемещай и не удаляй чужие записи.** Менять статус/содержимое своей записи можно; чужие — только по договорённости. 6. **Папка локальная.** `todo/` в `.gitignore` — не коммить, не синхронизировать. Если задача заслуживает общего трекинга — предложи пользователю перенести её в issue-трекер. ## Шаблон записи ```markdown # <Краткое название задачи> - **Где найдено**: <файл/пакет/место в коде; в какой задаче> - **Дата**: - **Статус**: todo ## Проблема <что именно не так, почему это проблема, при каких условиях проявится> ## Предложение <как исправить, с указанием конкретных файлов/функций; оценка риска и объёма> ## Связи <опционально: связанные todo-файлы, ссылки на код, замечания ревью> ``` ## Статусы - `todo` — записано, не начато; - `in_progress` — кто-то взялся (укажи имя/сессию); - `done` — выполнено (укажи, как и когда; можно удалить файл после подтверждения). ## Критерии готовности записи - [ ] Проблема описана так, что понятна без контекста исходной задачи. - [ ] Предложено конкретное исправление (или явно сказано, что решение открыто). - [ ] Файл лежит в `todo/` с kebab-case именем, дублей нет.