dpline-task-manager

Как мы работаем

Разделение труда

Кто	Что делает	Что не делает
Ты	Код продукта (`apps/`, тесты, конфиги рантайма), клики в GitHub UI (Project, PR, merge), разбор конфликтов руками	Не обязан писать `plan/`, rules, промпты и «память» для ИИ
Ассистент	`plan/**`, ADR-черновики по твоей развилке, sessions, backlog-зеркало, startprompt, `.cursor/rules` — всё, что нужно ИИ помнить контекст	Не пишет за тебя прикладной код, пока ты явно не попросишь точечную помощь / пример

Роль ассистента по коду: старший товарищ — направление, критерии готовности, риски, альтернативы, разбор ошибок. Теория точечно под блокер (~25% / 75% практики).

GitHub Project — источник правды по статусу

Project: DPLine Flow

Слой	Где правда
Статус / приоритет исполнения	GitHub Project (колонки IceBox → Ready → In Progress → Review → Done)
Формулировка задачи	GitHub Issue
Контекст фазы / продукта	`plan/roadmap.md`, `plan/main.md`
Опыт сессии (бухгалтерия памяти)	`plan/sessions/`
Краткое зеркало для ИИ	`plan/backlog.md` (обновляет ассистент после чтения Project)

Ритуал сессии (жёстко для агента)

Старт: прочитать GitHub Project + актуальные Issues → обновить локальные plan/*.md при расхождении → только потом код/помощь по коду.
Работа: одна задача = одна ветка от dev (см. ниже).
Конец: запись в plan/sessions/ + статус на Project + push обязателен. Сессия без push не считается закрытой.

Ветки

Ветка	Смысл
`main`	Прод: стабильный продукт (default на GitHub — так и оставляем)
`dev`	Рабочая сборка; сюда мержим завершённые задачи
`app-<номер>-<label>`	Продукт, напр. `app-13-docs`, `app-11-health`
`pr-<номер>-<label>`	Практика, напр. `pr-12-gitverse`

Формат строго {app\|pr}-{номер}-{label} (kebab). Старые имена вроде app-13fr / pr16gitflow — deprecated.

Подзадачи при необходимости ветвятся от ветки задачи, не от main. На каждом уровне: PR → конфликты → merge → в итоге в dev.

Связь с issue: в PR указывать Closes #N / Refs #N. Merge в dev закрывает issue через Actions (не через default-branch magic).

Теория: guides/git-flow.md. Автоматизация: guides/automation.md.

Команды Cursor (диспетчер)

Команда	Эффект
`/gh-create-task`	Issue + Project + `plan/backlog.md`
`/gh-start-task N`	Status → In Progress + локальная ветка от `dev`

Ты: код → commit → push → сам открываешь PR → правишь по Bugbot → merge.
Ассистент: tasks/Project/md/session.

Формат сессии

Цель одной фразой + номер issue / карточка Project.
Что сделал / где застрял (лог, файл, поведение).
Ассистент пишет/дополняет plan/sessions/YYYY-MM-DD.md (ты можешь поправить факты по времени и ощущениям).

Ревью

На PR: Cursor Bugbot (см. .cursor/BUGBOT.md + guides/automation.md).
Локально перед push: /review / /review-bugbot по желанию.
Ассистент в чате — по запросу: границы, ошибки, безопасность, гонки.

Документы (ADR)

Крупное решение (фреймворк, auth, деплой, пакетный менеджер) — короткий ADR в plan/decisions/. Черновик может набросать ассистент; выбор варианта и «приняли» — за тобой.

Теория: guides/adr.md. Шаблон файла: decisions/README.md.