auto-sync: 2026-05-14 23:10:01

tasks/dev-agent/AGENTS.md

@@ -17,10 +17,77 @@
 
 ## Файлы состояния
 
-- `tasks/todo.md` — текущий план задачи
+- `tasks/todo.md` — текущий план задачи (обновляй по ходу)
 - `tasks/lessons.md` — уроки и правила (читать в начале каждой сессии)
 - `memory/YYYY-MM-DD.md` — дневник работы
 
+## ⚡ Обязательные отчёты — ВСЕГДА, без исключений
+
+### Правило: каждая задача = файл отчёта
+
+Как только получил задачу — **сразу** создай файл отчёта:
+```
+/home/node/.openclaw/workspace/tasks/<project>/reports/dev-YYYY-MM-DD-LABEL.md
+```
+Где `LABEL` — короткое имя задачи (например `mart-fix`, `schema-migration`).
+
+Если папка `reports/` не существует — создай.
+
+### Структура отчёта
+
+```markdown
+# Dev Report: <название задачи>
+Дата: YYYY-MM-DD
+Статус: IN PROGRESS | DONE | FAILED
+
+## Задача
+<что попросили сделать>
+
+## Сделано
+- [ ] шаг 1
+- [x] шаг 2 — готово
+
+## Изменённые файлы
+- `path/to/file.py` — что изменено
+
+## Результат
+<итог, что работает, что проверено>
+
+## Проблемы и решения
+<что пошло не так и как решили>
+
+## Следующий шаг (если не завершено)
+<что делать при продолжении>
+```
+
+### Checkpoint-ы в процессе
+
+При работе над задачей **обновляй отчёт после каждого крупного шага**:
+- Создал DDL — записал в отчёт
+- Задеплоил файл — записал
+- Прогнал тест — записал результат
+- Нашёл баг — записал в «Проблемы»
+
+Не жди конца задачи. Если сессия оборвётся — следующий Dev прочтёт отчёт и продолжит.
+
+### Итоговый отчёт
+
+В конце задачи:
+1. Обнови статус на `DONE`
+2. Заполни раздел «Результат» — конкретные цифры, SQL-запросы проверки, вывод тестов
+3. Обнови `tasks/todo.md` — пометь задачи как выполненные
+4. Запиши урок в `tasks/lessons.md` если было что-то нетривиальное
+
+### Резервирование прогресса
+
+Для длинных задач (>10 шагов) — каждые ~5 шагов делай git commit или пиши промежуточный snapshot в отчёт:
+```markdown
+## Checkpoint 1 (HH:MM)
+- Сделано: ...
+- Состояние БД: ...
+- Следующий шаг: ...
+```
+
 ## Память
 
 После каждого рабочего дня записывай в `memory/YYYY-MM-DD.md`: