11 KiB
title, type, created, status, baseline_commit, review_loop_iteration, context
| title | type | created | status | baseline_commit | review_loop_iteration | context | |
|---|---|---|---|---|---|---|---|
| Восстановить корректную работу bmad-loop со спринтом Crank | bugfix | 2026-09-05 | done | 083974c27f |
0 |
|
Intent
Problem: Loop 0.11.1 игнорирует завершённые вложенные IDs 2.1b2a/b2b. Последний запуск 20260905-140512-5583 остановился на 2.4 с unclear intent: изолированный worktree не получил planning-artifacts и project-context. Простое исправление статусов не устраняет причину остановки.
Approach: Привести активные IDs к поддерживаемой грамматике, сохранив исторические aliases и завершённость. Настроить передачу проектного контекста через штатный worktree_seed. Проверить реальное provisioning и выбор следующей задачи без платной dev-сессии.
Boundaries & Constraints
Always: Сохранить 88 stories, 24 done и 64 backlog, порядок выполнения и связи с результатами. Отобразить 2.1b2a → 2.1e, 2.1b2b → 2.1f; сохранить прежние номера как legacy aliases. Stories 2.2/2.3 и Epic 1 не возвращаются в работу. Requirements 2.4 доступны из worktree, AGENTS.md и настройки renderer сохраняются. Все предыдущие run records и незакоммиченные результаты остаются нетронутыми.
Ask First: Изменение модели, token/time limits, permission flags, отключение проверок, обновление установленного loop, изменение системных зависимостей или принудительный откат существующего run.
Never: Подменять unknown keys фильтрацией, править site-packages, удалять историю, запускать разработку, push или deploy в ходе проверки. Нельзя утверждать успешную разработку 2.4 по результату dry-run.
I/O & Edge-Case Matrix
| Scenario | Input / State | Expected Output / Behavior | Error Handling |
|---|---|---|---|
| Completed splits | Два вложенных legacy ID | Две отдельные done stories под 2.1e/2.1f, aliases сохранены | Никакого уменьшения общего числа stories |
| Queue | Epic 2 после 2.3 | Ровно 2.4–2.9 в прежнем порядке | Завершённые stories не actionable |
| Fresh worktree | Gitignored planning и implementation artifacts | Требования, контекст, specs и правила доступны в изолированном дереве | Отсутствие файла проваливает проверку |
| Existing paused run | Run 5583, unclear intent | История и worktree сохраняются; дана явная процедура нового старта либо безопасного resolve | Сам run не возобновляется |
| Isolation | Provisioning тестового дерева | Main code и history не меняются, служебные файлы не попадают в staged diff | Не изменять общий git exclude для обхода проблемы |
Alias Mapping (2026-09-05)
2.1b2a→2.1e— legacy alias сохранён в metadata и redirect.2.1b2b→2.1f— legacy alias сохранён в metadata и redirect.
Code Map (Baseline Description)
.bmad-loop/policy.toml,[scm]— сейчас worktree_seed содержит только AGENTS.md; штатный seed принимает пути файлов и каталогов._bmad-output/implementation-artifacts/sprint-status.yaml— источник очереди, статусы уже согласованы, два ключа не распознаются._bmad-output/implementation-artifacts/spec-2-1b2{a,b}-*.md— завершённые specs: обновить активные имена и metadata, сохранить historical aliases и frozen intent._bmad-output/planning-artifacts/epics.md:1403,_bmad-output/implementation-artifacts/epic-2-context.md— синхронизировать decomposition и зависимости, не менять scope acceptance.- Установленный
bmad_loop/sprintstatus.py— read-only grammarN-M[a-z]?, очередь идёт в порядке файла. - Установленный
bmad_loop/worktree_flow.py:provision_worktree— read-only штатное копирование seed с git isolation; renderer и upstream skills копируются самим loop, повторная установка не нужна.
Tasks & Acceptance
Execution:
- Tracking, два split-spec и активные planning/context references — согласовать поддерживаемые IDs и aliases; не переписывать исторические logs/proposals.
.bmad-loop/policy.toml— добавить planning-artifacts, implementation-artifacts и project-context в штатные seeds, не ослабляя isolation и verification.- Проверки в отдельном временном worktree — вызвать штатное provisioning, доказать наличие требований Story 2.4, правил и контекста; проверить отсутствие нежелательных git changes.
- Повторить sprint validator, loop preflight и dry-run; зафиксировать безопасную процедуру запуска после исправления.
Acceptance Criteria:
- Given repaired tracking, when оба парсера читают спринт, then видны 88 stories без unknown keys, 24 done и 64 backlog.
- Given isolated worktree, when агент ищет intent 2.4, then исходный раздел epics с acceptance criteria и project-context доступны локально.
- Given Epic 2, when loop строит dry-run, then выбираются только шесть оставшихся stories начиная с 2-4-http-contract.
Spec Change Log
Verification
Фактические проверки 2026-09-05:
uv run .agents/skills/bmad-sprint-planning/scripts/sprint_plan.py validate --status-file _bmad-output/implementation-artifacts/sprint-status.yaml—valid: true.- Installed
bmad_loop.sprintstatus.load— 88 stories, 24done, 64backlog,unknown_keys=[]; очередь Epic 2 — ровно2-4-http-contract…2-9-openapi-guided-onboardingв порядке файла. bmad-loop validate --project /home/bsodfather/code/crank— PASS: policy, 88-story sprint, clean worktree, Codex adapter и upstream skills.bmad-loop run --project /home/bsodfather/code/crank --epic 2 --dry-run— PASS: шесть stories 2.4–2.9 без dev-сессии.- Disposable
git worktreeчерез installedbmad_loop.worktree_flow.provision_worktree— без skipped/undelivered seeds; доступныAGENTS.md, project context,epics.mdс requirements Story 2.4, implementation artifacts, exact renderer config и_bmad/scripts/render_skill.py; renderer успешно выполнен во временном дереве. Staged diff пуст,git status --porcelainпуст; тестовое дерево удалено. git diff --check— PASS. Исходные snapshots ignored operational artifacts не сохранены, поэтому неизменность этих файлов не доказуема git diff.
Процедура нового старта: после успешного bmad-loop validate --project /home/bsodfather/code/crank выполнить bmad-loop run --project /home/bsodfather/code/crank --epic 2 --max-stories 1. Не возобновлять paused run 20260905-140512-5583: copy-when-absent не обновляет уже существующий worktree.
Review Result
Три review layers выполнены последовательно одним reviewer из-за лимита доступных agent threads. Исправлены legacy path redirects, активная deferred-ссылка, процедура нового старта и точность verification evidence. Root независимо повторил CLI validate/status/dry-run и provisioning с реальным Codex profile, hooks, skills и исполнением renderer; shared git exclude и HEAD не менялись. Новых dev-сессий не было, paused run 5583 и его worktree сохранены.
Повторяемая snapshot-specific проверка: /home/bsodfather/.local/share/uv/tools/bmad-loop/bin/python .bmad-loop/check-sprint-compatibility.py. Ожидаемые 24 done/64 backlog относятся к текущему ремонту и изменятся при продолжении разработки. Проверка создаёт только собственный временный detached worktree и удаляет его после завершения.
Изменения локальные, в gitignored operational artifacts; коммит и push не создавались. Возможность долгого успешного выполнения Story 2.4 не доказывается preflight-проверками. Полная регенерация legacy sprint keys из русских заголовков остаётся отдельной операцией согласования; loop читает исправленный sprint-status напрямую.
Suggested Review Order
- Передача требований и правил в новый изолированный worktree. policy.toml:147
- Поддерживаемые ключи сохраняют обе завершённые подзадачи и очередь. sprint-status.yaml:69
- План разделяет filesystem и database recovery без потери исходных критериев. epics.md:1403
- Snapshot regression проверяет настоящий Codex profile и renderer в отдельном worktree. check-sprint-compatibility.py:1