AI Agent Rules — Точка входа

Каркас правил и модели поведения для ИИ-агента в IDE (Kiro / Cursor). Вынеси в отдельный репозиторий, добавь специфику проекта — и система готова к работе.

---

Структура

├── README.md                        ← этот файл
├── rules.md                   ← главный файл правил (system prompt агента)
│
├── agent/                           ← навигация и поведение агента
│   ├── START.md                     ← с чего начинает агент, политика чтения
│   ├── INVARIANTS.md                ← критичные правила, которые нельзя нарушать
│   ├── PUBLIC_API.md                ← как работать с публичным контрактом
│   └── TESTING.md                   ← как проверять изменения
│
├── sources-of-truth/                ← источники истины (читаются по запросу)
│   ├── ARCHITECTURE.md              ← границы сервисов, потоки данных
│   ├── TECH_SPEC.md                 ← стек и технические принципы
│   └── BUSINESS_SPEC.md             ← бизнес-логика и роли
│
├── agents/                          ← личности агентов (читаются хуками)
│   ├── frontend.md                  ← Frontend Senior
│   ├── backend.md                   ← Backend Senior
│   ├── qa.md                        ← QA Engineer
│   └── product.md                   ← Product Manager (запускается вручную)
│
├── hooks/
│   └── HOOKS_GUIDE.md               ← инструкция + 8 готовых хуков для копирования
│
└── phases/                          ← фазовая документация
    ├── README.md
    ├── phase-1/
    │   ├── WHAT_TO_DO.md
    │   ├── DONE.md
    │   └── TESTS.md
    └── phase-2/
        ├── WHAT_TO_DO.md
        ├── DONE.md
        └── TESTS.md

---

Как использовать

1. Базовый режим (один агент)

• Скопируй rules.md в корень проекта как .rules
• Заполни sources-of-truth/*.md под свой проект
• Агент читает правила и работает по ним

2. Мультиагентный режим (4 агента через хуки)

• Заполни agents/*.md — личность и правила каждого агента
• Скопируй нужные хуки из hooks/HOOKS_GUIDE.md в .kiro/hooks/
• Kiro использует свою модель для всех агентов — без доп. расходов
• Product-агент запускается вручную через userTriggered хук

3. Фазовая разработка

• Создай phases/phase-X/ для каждой фазы
• Агент читает WHAT_TO_DO.md перед началом
• Заполняет DONE.md и TESTS.md по завершении

---

Порядок чтения для агента

1. rules.md — главные правила (читается всегда)
2. agent/START.md — политика чтения и навигация
3. agent/INVARIANTS.md — что нельзя нарушать
4. phases/phase-X/WHAT_TO_DO.md — текущая задача

Источники истины (sources-of-truth/) — только по запросу.

---

Как работают агенты

Каждый хук читает нужный файл из agents/ и инструктирует Kiro действовать как этот агент. Модель одна (та, что выбрана в Kiro), но поведение, зона ответственности и формат ответа — разные.

Агент	Когда запускается	Триггер
Frontend	При сохранении .tsx/.jsx	fileEdited
Backend	При сохранении backend-файлов	fileEdited
QA	После записи файла агентом	postToolUse
QA	После завершения задачи	postTaskExecution
Product	Вручную по кнопке	userTriggered