---
name: backlog-to-rules
description: Внедрение накопленных улучшений из improvements-backlog в инструкции AI агента
tags: [improvement, rules, learning]
version: "2.0"
---

# Backlog to Rules: Внедрение улучшений

> **Цель:** Превратить накопленный опыт ошибок в конкретные правила для предотвращения повторений
> **Входные данные:** `.cursor/data/improvements-backlog.md`
> **Выходные данные:** Обновлённые `.cursor/rules/*.mdc` и skills

---

## Когда запускать

| Условие | Приоритет |
|---------|-----------|
| Накопилось 5+ улучшений в backlog | 🔴 Обязательно |
| Прошла неделя с последнего внедрения | 🟡 Рекомендуется |
| Есть 2+ High priority улучшения | 🔴 Обязательно |
| Перед важным релизом | 🟡 Рекомендуется |
| Одна ошибка повторилась 3+ раз | 🔴 Немедленно |

---

## Процесс (7 фаз)

### Phase 1: ANALYZE

1. Открыть `.cursor/data/improvements-backlog.md`
2. Группировать улучшения по целевым файлам
3. Собрать статистику (всего, high/medium/low priority)
4. Выявить паттерны ошибок (объединить похожие)

### Phase 2: RESEARCH

Для каждого файла из группировки:
1. Прочитать текущую структуру файла
2. Определить куда добавить каждое улучшение (существующая/новая секция)
3. Проверить конфликты с существующими правилами

### Phase 3: PLAN

1. Составить список изменений по файлам
2. Определить критерии успеха
3. Для сложных случаев — полный план (см. `references/templates.md`)

### Phase 4: IMPLEMENT

Правила внедрения:
- Добавлять новые секции — НЕ заменять существующие
- Каждое правило с конкретным примером кода/команды
- Каждое правило с `> **WHY:**` (реальный случай ошибки)
- Сохранять формат файла (tables, code blocks)
- После каждого файла — прочитать целиком, проверить структуру

Шаблон секции — см. `references/templates.md`

### Phase 5: VERIFY

1. Все существующие секции сохранены
2. Новые секции дополняют, не заменяют
3. Формат соответствует стилю файла
4. Связи с другими модулями не нарушены
5. Cross-check: каждый файл открыт и проверен

### Phase 6: UPDATE BACKLOG

1. Обновить статусы в backlog: 📝 Backlog → ✅ Done
2. Перенести в секцию "✅ ВНЕДРЕНО" в кратком формате
3. Обновить статистику в шапке

### Phase 7: SUMMARY

Отчёт: сколько внедрено, какие файлы обновлены, какие паттерны предотвращены, уверенность.

---

## Quick Version (1-2 улучшения)

```
1. Открой backlog → найди улучшение
2. Открой целевой файл инструкций
3. Добавь секцию в конец соответствующего раздела
4. Включи WHY с реальным случаем
5. Обнови статус в backlog на ✅ Done
```

---

## Quality Framework

При создании/улучшении инструкций — ключевые элементы:

| Элемент | Что включить |
|---------|--------------|
| **Input** | Что триггерит правило |
| **Output** | Что должно быть сделано |
| **Success Metrics** | Как измерить успех |
| **Guardrails** | Что запрещено, границы |
| **WHY** | Реальный случай ошибки |

Метрики качества — `standard-agent-quality.mdc`

---

## Связанные модули

- `session-review` skill — создаёт записи в backlog
- `error-learning.mdc` — записывает ошибки для анализа
- `.cursor/data/improvements-backlog.md` — хранилище улучшений
- `standard-agent-quality.mdc` — метрики и границы

---

**Версия:** 2.0