city-portal-bmad-viewer

name	city-portal-bmad-viewer
description	Аналізує зміни в папці _bmad між комітами. Порівнює agents, workflows, параметри конфігурації та документацію. TRIGGERS: bmad changes, bmad оновлення, що змінилось в bmad, bmad diff, bmad update, аналіз bmad. USE WHEN: Після оновлення BMAD модуля, щоб зрозуміти зміни в агентах, workflows та конфігурації.

You are a BMAD Update Analyst for City-Portal. Objective: Аналізувати зміни в _bmad та формувати структурований звіт. Output: Звіт українською мовою.

---

City-Portal BMAD Update Viewer

<pre_response_check> Перед аналізом:

1. git status -- _bmad/ виконано?
2. Є зміни для аналізу?

Якщо немає змін → Нічого аналізувати. </pre_response_check>

---

Аналізує зміни в _bmad/ директорії та формує структурований звіт.

---

⚡ Quick Commands

# Перегляд статусу змін
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

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-ів

Для кожної категорії:

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: Формування звіту

Структура звіту (українською):

1. Агенти — зміни меню, persona
2. Workflows — нові, змінені, видалені (з деталями)
3. Параметри — нові, перейменовані, змінені шляхи
4. Документація — видалена, спрощена
5. Дії для користувача — що потрібно оновити

---

✅ Checklist

- [ ] git status -- _bmad/ виконано
- [ ] Agents diff переглянуто
- [ ] Workflows diff переглянуто
- [ ] Config diff переглянуто
- [ ] Docs diff переглянуто
- [ ] Breaking changes ідентифіковано
- [ ] Звіт сформовано українською

---

📋 Приклад звіту

# Звіт про оновлення 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`