wiki/templates/DEV_TASK_TEMPLATE.md

DEV TASK: [Название фичи/задачи]

Статус: Ready for dev
Проект: [slug проекта]
Фаза: [номер]
BRD: [ссылка на BRD если есть]

---

Цель

Одно предложение: что должно работать после выполнения этой задачи.

Архитектура

2-3 предложения: подход, ключевые решения, почему именно так.

Стек / Зависимости

• [Язык/фреймворк]
• [Библиотеки]
• [Внешние сервисы]

---

Инфраструктура

Параметр	Значение
Сервер	user@host
Рабочая директория	/path/to/project/
Деплой	[команды / скрипт]
URL	[где проверять результат]

---

Файловая карта

Какие файлы создаются/меняются и за что отвечают.

Действие	Файл	Ответственность
Создать	path/to/new_file.py	[что делает]
Изменить	path/to/existing.js:50-80	[что меняется]
Тест	tests/test_feature.py	[что проверяет]

---

Задачи

Task 1: [Компонент / Шаг]

Файлы:

• Создать: exact/path/file.py
• Изменить: exact/path/existing.js

Шаги:

• 1.1 Написать [что именно]

# Точный код или псевдокод с достаточной детализацией
def example():
    pass

• 1.2 Проверить

# Точная команда проверки
curl -s http://localhost:5558/api/endpoint | jq .status
# Ожидаемый результат: "ok"

• 1.3 Задеплоить

# Точные команды деплоя
docker cp /path/file.py container:/app/file.py
docker restart container

Критерий готовности: [Что должно быть true чтобы задача считалась выполненной]

---

Task 2: [Следующий компонент]

Файлы:

• Создать: ...

Шаги:

• 2.1 ...
• 2.2 ...

Критерий готовности: ...

---

Проверка (Acceptance)

Финальные проверки после всех задач. Что Стрим проверит перед тем как закрыть задачу.

#	Проверка	Команда / Действие	Ожидаемый результат
1	[что проверяем]	curl ...	HTTP 200, JSON с полем X
2	[визуальная]	Открыть URL	Видно Y без ошибок
3	[edge case]	[действие]	[результат]

---

Ограничения и контекст

Что Dev-агент ДОЛЖЕН знать, чтобы не наступить на грабли.

• ⚠️ [Граблина 1 — например: docker cp ПОСЛЕ рестарта, не до]
• ⚠️ [Граблина 2 — например: SSH через ssh2 модуль, не бинарник]
• 🚫 [Чего НЕ делать — например: не трогать nginx конфиг]

---

Деплой-чеклист

• Код написан и работает локально
• Файлы загружены на сервер
• Контейнер перезапущен (если нужно)
• docker cp выполнен (если статика)
• Проверка по URL — работает
• Нет ошибок в логах (docker logs container --tail 50)

---

Создано: YYYY-MM-DD | Автор ТЗ: Стрим | Исполнитель: Dev-агент