4.1 KiB
title, description
| title | description |
|---|---|
| Гид для агента | Что AI-агент обязан прочитать перед началом работы, а что — по задаче. |
Обязательное чтение перед началом работы
Этот документ определяет строгий порядок действий агента перед выполнением любых задач.
Общее правило
Перед началом работы над любой задачей агент обязан ознакомиться с базовой документацией проекта.
Нарушение этого порядка считается ошибкой.
Порядок обязательного чтения
Агент должен читать документацию строго в следующем порядке:
1. Архитектура (КРИТИЧЕСКИ ВАЖНО)
Архитектура — это самое важное в проекте.
Агент обязан:
- строго понимать архитектурный подход (SLM)
- соблюдать архитектуру на 100% без отклонений
- не предлагать решений, нарушающих архитектурные принципы
- не упрощать архитектуру даже ради скорости выполнения задачи
Любое нарушение архитектуры недопустимо.
2. Базовые правила
После архитектуры необходимо изучить:
Агент обязан применять эти правила во всех решениях.
Использование карты документации
Для поиска дополнительных сведений агент должен использовать:
MAP.md содержит ссылки на все прикладные и вспомогательные разделы.
Агент может:
- переходить к нужным разделам через MAP.md
- уточнять детали реализации
- искать примеры и частные случаи
Запрещено
Агенту запрещено:
- начинать выполнение задачи без изучения архитектуры
- игнорировать базовые правила
- принимать решения, противоречащие архитектуре
- придумывать собственные подходы, если они не описаны в документации
Ожидаемое поведение агента
Перед выполнением задачи агент должен:
- Изучить архитектуру
- Изучить базовые правила
- При необходимости открыть MAP.md и найти релевантные разделы
- Только после этого приступать к решению задачи
Приоритеты
При принятии решений агент должен руководствоваться следующим приоритетом:
- Архитектура
- Базовые правила
- Документация из MAP.md
- Задача пользователя
Если задача противоречит архитектуре — задача должна быть переосмыслена, а не выполнена напрямую.