TheDeclineOfWarriors/docs/tasks/_template.md

id, title, priority, area, owner, created, updated, execution_time, depends_on, canonical_docs, related_files

id	title	priority	area	owner	created	updated	execution_time	depends_on	canonical_docs	related_files
TASK-XXXX	Короткий заголовок	Medium	docs	unassigned	YYYY-MM-DD	YYYY-MM-DD	1d6h30m

TASK-XXXX - Короткий заголовок

Status

Статус задачи ведется в docs/tasks/Index.md и является каноническим там.

Допустимые значения статуса:

• proposal
• ready
• in_progress
• blocked
• done

Why

Объясните, почему эта задача важна и какую проблему она решает.

Expected Outcome

Опишите, какое новое состояние должно существовать после завершения задачи.

Current Context

Держите этот раздел коротким. Ссылайтесь на канонические документы вместо копирования больших фоновых блоков.

Source Of Truth

Перечислите документы или артефакты, которые имеют приоритет, если файл задачи неполон или устарел.

• канонические документы текущего состояния в docs/current/...
• операционные runbook-документы в docs/runbooks/...
• проверенный код, тесты и закоммиченные артефакты деплоя
• явные решения человека, принятые после создания этой задачи

Read First

• README.md
• docs/...
• src/...
• tests/...

Scope In

• пункт
• пункт

Scope Out

• пункт
• пункт

Constraints

• сохраняйте контракты, уровень безопасности и задокументированную архитектуру, если только человек явно не изменил их
• предпочитайте наименьшее безопасное изменение, которое оставляет после себя более понятную документацию и подтверждение проверки
• указывайте execution_time в формате Jira, например 1d6h30m, и только с шагом в 30 минут
• используйте приоритеты Lowest, Low, Medium, High, Highest
• не переименовывайте и не перемещайте task-файл при смене статуса; обновляйте запись в docs/tasks/Index.md

If You Find Drift

• не считайте этот файл задачи молча источником высшего приоритета
• если текущие канонические документы и исторические документы расходятся, предпочитайте текущие канонические документы
• если код и документация расходятся, определите, является ли код намеренным текущим поведением или это дрейф документации, затем обновите ближайший канонический документ
• если конфликт затрагивает архитектуру, контракты, уровень безопасности, форму деплоя или поведение данных и миграций, остановитесь и спросите человека, если только более новое явное решение уже не сняло вопрос
• фиксируйте важный дрейф или последующие пробелы в файле задачи перед передачей дальше

Suggested Approach

1. Шаг первый.
2. Шаг второй.
3. Шаг третий.

Acceptance Criteria

• измеримый результат
• измеримый результат

Verification

• проверка согласованности документации при вычитке
• точечные шаги сборки, тестирования или ручной проверки, если ожидаются изменения в коде

Risks / Open Questions

• вопрос или риск

Human Decisions Needed

• перечисляйте только решения, которые действительно требуют человека
• пишите none currently, когда задачу можно выполнять без дополнительных уточнений

Decision Log

• YYYY-MM-DD - фиксируйте значимые решения, принятые при уточнении или выполнении задачи

Handoff Notes

Добавляйте короткие заметки, которые помогут следующему человеку или AI-агенту безопасно продолжить работу.