From 49fbda9e09ead9f53a21c49743e28622ec058577 Mon Sep 17 00:00:00 2001
From: Fedorov Vladimir <vladimir.fodorow@gmail.com>
Date: Sun, 30 Aug 2026 21:40:50 +0700
Subject: [PATCH] updates

---
 .dsh/AGENTS.md                    |  4 +++
 .dsh/skills/todo-collect/SKILL.md | 54 +++++++++++++++++++++++++++++++
 .gitignore                        |  4 +++
 3 files changed, 62 insertions(+)
 create mode 100644 .dsh/skills/todo-collect/SKILL.md

diff --git a/.dsh/AGENTS.md b/.dsh/AGENTS.md
index f5bafa9..c3d77d6 100644
--- a/.dsh/AGENTS.md
+++ b/.dsh/AGENTS.md
@@ -31,3 +31,7 @@
 - бюджет **3 раунда** на цикл (план/результат), «все замечания одним списком»;
 - план/состояние — во внешнем файле (`.dsh/task-plan.md`), промпт ревью — дельта + `git diff`;
 - саморевью фактическими проверками до отправки сеньёру (поведение функций на реальных данных, сгенерированный код, арифметика).
+
+## Улучшения вне скоупа (скилл todo-collect)
+
+Если в ходе задачи нашлось улучшение/долг, не мешающее текущей работе — **не чини попутно**: запиши его в локальную папку `todo/` по скиллу `todo-collect` (каждая задача — отдельный файл, шаблон в скилле) и продолжай текущую задачу. Папка в `.gitignore` — это локальный журнал, не коммитится.
diff --git a/.dsh/skills/todo-collect/SKILL.md b/.dsh/skills/todo-collect/SKILL.md
new file mode 100644
index 0000000..69bdd96
--- /dev/null
+++ b/.dsh/skills/todo-collect/SKILL.md
@@ -0,0 +1,54 @@
+---
+name: todo-collect
+description: Записывает найденные улучшения «вне скоупа» текущей задачи в локальную папку todo/ — каждую задачу в отдельный файл, без выполнения и без расширения scope. Загружай при работе над любой задачей (реализация, ревью, рефакторинг, исследование), чтобы не терять замечания, не мешающие текущей работе.
+whenToUse: В процессе любой задачи обнаружено улучшение, оптимизация, потенциальный баг или долг, которые не блокируют и не относятся к текущей задаче. Триггеры: замечание в коде, «на будущее» из ревью, осознанное ограничение, отложенное решение.
+---
+
+# Сбор улучшений «вне скоупа» в todo/
+
+## Контекст
+
+В ходе задачи постоянно встречаются места, которые можно улучшить, но чинить их сейчас — значит расширять scope и рисковать текущей работой (правило «не отклоняйся молча»). Такие находки не должны теряться: они записываются в локальную папку `todo/` репозитория (в `.gitignore`, в git не попадает) — **каждая задача в свой отдельный файл**.
+
+## Правила
+
+1. **Записывай, не чини.** Нашёл улучшение, не мешающее текущей задаче — запиши в `todo/` и продолжай текущую работу. Не выполняй записанные задачи в текущей сессии, если пользователь явно об этом не попросил.
+2. **Одна задача — один файл.** Имя файла — kebab-case, отражающее суть: `todo/<chto-i-gde>.md` (например, `todo/mapimage-idempotent-prefix.md`). Если файл с той же сутью уже существует — дополни его, не создавай дубль.
+3. **Записывай сразу.** Не откладывай «на потом»: в конце задачи контекст уже потерян. Короткая запись по шаблону ниже занимает минуту.
+4. **Фиксируй только факты и предложения.** Без воды: что не так, где, как исправить (с оценкой риска), кто/когда нашёл.
+5. **Не перемещай и не удаляй чужие записи.** Менять статус/содержимое своей записи можно; чужие — только по договорённости.
+6. **Папка локальная.** `todo/` в `.gitignore` — не коммить, не синхронизировать. Если задача заслуживает общего трекинга — предложи пользователю перенести её в issue-трекер.
+
+## Шаблон записи
+
+```markdown
+# <Краткое название задачи>
+
+- **Где найдено**: <файл/пакет/место в коде; в какой задаче>
+- **Дата**: <YYYY-MM-DD>
+- **Статус**: todo
+
+## Проблема
+
+<что именно не так, почему это проблема, при каких условиях проявится>
+
+## Предложение
+
+<как исправить, с указанием конкретных файлов/функций; оценка риска и объёма>
+
+## Связи
+
+<опционально: связанные todo-файлы, ссылки на код, замечания ревью>
+```
+
+## Статусы
+
+- `todo` — записано, не начато;
+- `in_progress` — кто-то взялся (укажи имя/сессию);
+- `done` — выполнено (укажи, как и когда; можно удалить файл после подтверждения).
+
+## Критерии готовности записи
+
+- [ ] Проблема описана так, что понятна без контекста исходной задачи.
+- [ ] Предложено конкретное исправление (или явно сказано, что решение открыто).
+- [ ] Файл лежит в `todo/` с kebab-case именем, дублей нет.
diff --git a/.gitignore b/.gitignore
index a87fcb4..cf8729a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -31,6 +31,10 @@ go.sum
 .gocache/
 .gotmp/
 
+# Локальный журнал улучшений «вне скоупа» текущей задачи
+# (каждая запись — отдельный файл, см. скилл todo-collect)
+todo/
+
 .VSCodeCounter/
 
 docker-compose-prod.yml
\ No newline at end of file