City-Portal BMAD Update Viewer
<pre_response_check> Перед аналізом:
- •
git status -- _bmad/виконано? - •Є зміни для аналізу?
Якщо немає змін → Нічого аналізувати. </pre_response_check>
Аналізує зміни в _bmad/ директорії та формує структурований звіт.
⚡ Quick Commands
bash
# Перегляд статусу змін git status --short -- _bmad/ | grep -v ".bak" # Детальний diff конкретного файлу git diff HEAD -- _bmad/bmm/workflows/<workflow>/workflow.yaml # Версія BMAD cat _bmad/_bmad/config.yaml | grep -E "Version|version"
🔄 Алгоритм аналізу
Step 1: Визначення scope
bash
git status --short -- _bmad/
Категоризація:
- •
M— модифіковані - •
D— видалені - •
??— нові (untracked) - •Ігнорувати
*.bak
Step 2: Перегляд по категоріях
| Категорія | Шлях | Що шукати |
|---|---|---|
| Agents | _bmad/*/agents/*.md | menu, persona, critical_actions |
| Workflows | _bmad/*/workflows/**/*.{yaml,md} | steps, variables, input_file_patterns |
| Config | _bmad/**/config.yaml | нові змінні, шляхи |
| Docs | _bmad/*/docs/*.md | видалені посилання, структура |
Step 3: Аналіз diff-ів
Для кожної категорії:
bash
git diff HEAD -- <path> | head -100
Витягнути:
- •Додані рядки (
+) - •Видалені рядки (
-) - •Змінені patterns
Step 4: Ідентифікація breaking changes
| Тип | Приклад |
|---|---|
| Видалені файли | D _bmad/bmm/docs/enterprise.md |
| Змінений синтаксис | *DS → DS |
| Перейменовані параметри | output_file → default_output_file |
| Змінені шляхи | {output_folder} → {planning_artifacts} |
Step 5: Формування звіту
Структура звіту (українською):
- •Агенти — зміни меню, persona
- •Workflows — нові, змінені, видалені (з деталями)
- •Параметри — нові, перейменовані, змінені шляхи
- •Документація — видалена, спрощена
- •Дії для користувача — що потрібно оновити
✅ Checklist
markdown
- [ ] git status -- _bmad/ виконано - [ ] Agents diff переглянуто - [ ] Workflows diff переглянуто - [ ] Config diff переглянуто - [ ] Docs diff переглянуто - [ ] Breaking changes ідентифіковано - [ ] Звіт сформовано українською
📋 Приклад звіту
markdown
# Звіт про оновлення BMAD vX.X.X ## 1. Агенти | Агент | Зміни | |-------|-------| | dev | видалено `*` з команд | ## 2. Workflows ### Новий: create-tech-spec - Призначення: ... - Архітектура: step-file ### Оновлений: code-review - Додано: planning_artifacts - Змінено: sprint_status шлях ## 3. Параметри | Нові | Перейменовані | |------|---------------| | planning_artifacts | output_file → default_output_file | ## 4. Документація | Видалено | |----------| | enterprise-agentic-development.md | ## 5. Дії - Оновити команди: `*DS` → `DS`