115 lines
5.0 KiB
Markdown
115 lines
5.0 KiB
Markdown
---
|
|
id: TASK-XXXX
|
|
title: Короткий заголовок
|
|
priority: Medium
|
|
area: docs
|
|
owner: unassigned
|
|
created: YYYY-MM-DD
|
|
updated: YYYY-MM-DD
|
|
execution_time: 1d6h30m
|
|
depends_on: []
|
|
canonical_docs: []
|
|
related_files: []
|
|
---
|
|
|
|
# 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-агенту безопасно продолжить работу.
|