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

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

---

# City-Portal BMAD Update Viewer

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

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

Якщо немає змін → Нічого аналізувати.
</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: Формування звіту

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

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

---

## ✅ 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`
```