Files
crank/_bmad-output/implementation-artifacts/spec-bmad-loop-sprint-compatibility.md
T

11 KiB
Raw Blame History

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
_bmad-output/project-context.md

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 grammar N-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, 24 done, 64 backlog, 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 через installed bmad_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