[Add] Base TaskBoard & TaskManager
This commit is contained in:
@@ -0,0 +1,45 @@
|
||||
# Task Index
|
||||
|
||||
## Purpose
|
||||
|
||||
Эта папка хранит один файл на каждую отложенную или асинхронную единицу работы и единый реестр статусов, чтобы контекст реализации не терялся между чатами.
|
||||
|
||||
Файлы задач должны описывать работу достаточно ясно, чтобы будущий человек или AI-агент мог продолжить ее без восстановления исходного замысла по истории переписки.
|
||||
|
||||
## Rules
|
||||
|
||||
- используйте `docs/tasks/_template.md` для каждой новой задачи
|
||||
- храните одну задачу в одном файле
|
||||
- храните все task-файлы плоско в `docs/tasks`, без подпапок по статусам
|
||||
- не переименовывайте и не перемещайте файл задачи при смене статуса
|
||||
- статус задачи считается каноническим по записи в этом индексе
|
||||
- предпочитайте ссылки на канонические документы вместо копирования больших фоновых разделов
|
||||
- обновляйте статус задачи в этом индексе по мере продвижения работы
|
||||
- если завершенная задача меняет поведение системы или операционные процессы, отдельно обновляйте каноническую документацию
|
||||
- указывайте `execution_time` в формате Jira, например `1d6h30m`
|
||||
- значение `execution_time` должно быть кратно 30 минутам
|
||||
- используйте приоритеты `Lowest`, `Low`, `Medium`, `High`, `Highest`
|
||||
- держите реестр отсортированным по `ID`, а не группируйте задачи по статусным разделам
|
||||
|
||||
## Supporting Docs
|
||||
|
||||
- шаблон задачи: `docs/tasks/_template.md`
|
||||
|
||||
## Statuses
|
||||
|
||||
- `proposal` - идея существует, но объем или подход еще не готовы к исполнению
|
||||
- `ready` - задачу можно брать в работу сейчас
|
||||
- `in_progress` - по задаче сейчас идет активная работа
|
||||
- `blocked` - задача ждет решения, зависимости или внешней предпосылки
|
||||
- `done` - работа завершена; оставьте короткую заметку по итогу и позже при необходимости переместите или переименуйте файл
|
||||
|
||||
## Task Registry
|
||||
|
||||
| ID | Status | Priority | Area | Execution Time | File | Summary |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| TASK-0001 | done | Medium | docs | 1d | `docs/tasks/TASK-0001-define-docs-structure-and-migration-plan.md` | Определена целевая структура документации, карта миграции и последовательность работ для переноса docs. |
|
||||
| TASK-0002 | done | Medium | docs | 1d6h | `docs/tasks/TASK-0002-execute-docs-structure-migration.md` | Выполнен перенос дерева docs в разделы current, runbooks, history, process и tasks, а также обновлены пути входа в документацию. |
|
||||
| TASK-0003 | in_progress | High | ci_cd | 2d | `docs/tasks/TASK-0003-stabilize-ci-cd-and-validate-pipeline.md` | Требуется итеративно стабилизировать текущий CI/CD путь на GitHub Actions и довести его до подтвержденно рабочего состояния. |
|
||||
| TASK-0004 | ready | Medium | product | 1d | `docs/tasks/TASK-0004-define-directories-feature-and-implementation-decision.md` | Нужно согласовать и зафиксировать модель фичи directories, чтобы реализация не пошла в неверном направлении. |
|
||||
| TASK-0005 | blocked | Medium | product | 2d | `docs/tasks/TASK-0005-implement-directories-and-folder-navigation.md` | Реализацию directories нельзя начинать, пока `TASK-0004` не зафиксирует согласованную модель папок и границы выполнения. |
|
||||
| TASK-0006 | ready | Low | docs | 1d | `docs/tasks/TASK-0006-reposition-readme-as-project-brief.md` | Нужно переписать `README`, чтобы он начинался с идентичности проекта, стека и верхнеуровневого онбординга. |
|
||||
@@ -0,0 +1,114 @@
|
||||
---
|
||||
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-агенту безопасно продолжить работу.
|
||||
Reference in New Issue
Block a user