pomazanbohdan City-Portal BMAD Update Viewer
Перед аналізом:
git status -- _bmad/виконано?- Є зміни для аналізу?
Якщо немає змін → Нічого аналізувати.
Аналізує зміни в _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: Формування звіту
Структура звіту (українською):
- Агенти — зміни меню, persona
- Workflows — нові, змінені, видалені (з деталями)
- Параметри — нові, перейменовані, змінені шляхи
- Документація — видалена, спрощена
- Дії для користувача — що потрібно оновити
✅ 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`