104 lines
4.2 KiB
Markdown
104 lines
4.2 KiB
Markdown
|
---
|
|||
|
|
title: Гид для агента
|
|||
|
|
description: Что AI-агент обязан прочитать перед началом работы, а что — по задаче.
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Обязательное чтение перед началом работы
|
|||
|
|
|
|||
|
|
Этот документ определяет **строгий порядок действий агента перед выполнением любых задач**.
|
|||
|
|
|
|||
|
|
## Общее правило
|
|||
|
|
|
|||
|
|
Перед началом работы над **любой задачей** агент **обязан ознакомиться с базовой документацией проекта**.
|
|||
|
|
|
|||
|
|
Нарушение этого порядка считается ошибкой.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Порядок обязательного чтения
|
|||
|
|
|
|||
|
|
Агент должен читать документацию **строго в следующем порядке**:
|
|||
|
|
|
|||
|
|
### 1. Архитектура (КРИТИЧЕСКИ ВАЖНО)
|
|||
|
|
|
|||
|
|
* [Архитектура: Обзор](./basics/architecture/index.md)
|
|||
|
|
* [Архитектура: Слои](./basics/architecture/reference/layers.md)
|
|||
|
|
* [Архитектура: Модули](./basics/architecture/reference/modules.md)
|
|||
|
|
* [Архитектура: Сегменты](./basics/architecture/reference/segments.md)
|
|||
|
|
|
|||
|
|
**Архитектура — это самое важное в проекте.**
|
|||
|
|
|
|||
|
|
Агент обязан:
|
|||
|
|
|
|||
|
|
* строго понимать архитектурный подход (SLM)
|
|||
|
|
* соблюдать архитектуру **на 100% без отклонений**
|
|||
|
|
* не предлагать решений, нарушающих архитектурные принципы
|
|||
|
|
* не упрощать архитектуру даже ради скорости выполнения задачи
|
|||
|
|
|
|||
|
|
Любое нарушение архитектуры недопустимо.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 2. Базовые правила
|
|||
|
|
|
|||
|
|
После архитектуры необходимо изучить:
|
|||
|
|
|
|||
|
|
* [Технологии и библиотеки](./basics/tech-stack.md)
|
|||
|
|
* [Именование](./basics/naming.md)
|
|||
|
|
* [Стиль кода](./basics/code-style.md)
|
|||
|
|
* [Документирование](./basics/documentation.md)
|
|||
|
|
* [Типизация](./basics/typing.md)
|
|||
|
|
|
|||
|
|
Агент обязан применять эти правила во всех решениях.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Использование карты документации
|
|||
|
|
|
|||
|
|
Для поиска дополнительных сведений агент должен использовать:
|
|||
|
|
|
|||
|
|
* [MAP.md](./MAP.md)
|
|||
|
|
|
|||
|
|
MAP.md содержит ссылки на все прикладные и вспомогательные разделы.
|
|||
|
|
|
|||
|
|
Агент может:
|
|||
|
|
|
|||
|
|
* переходить к нужным разделам через MAP.md
|
|||
|
|
* уточнять детали реализации
|
|||
|
|
* искать примеры и частные случаи
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Запрещено
|
|||
|
|
|
|||
|
|
Агенту запрещено:
|
|||
|
|
|
|||
|
|
* начинать выполнение задачи без изучения архитектуры
|
|||
|
|
* игнорировать базовые правила
|
|||
|
|
* принимать решения, противоречащие архитектуре
|
|||
|
|
* придумывать собственные подходы, если они не описаны в документации
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Ожидаемое поведение агента
|
|||
|
|
|
|||
|
|
Перед выполнением задачи агент должен:
|
|||
|
|
|
|||
|
|
1. Изучить архитектуру
|
|||
|
|
2. Изучить базовые правила
|
|||
|
|
3. При необходимости открыть MAP.md и найти релевантные разделы
|
|||
|
|
4. Только после этого приступать к решению задачи
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Приоритеты
|
|||
|
|
|
|||
|
|
При принятии решений агент должен руководствоваться следующим приоритетом:
|
|||
|
|
|
|||
|
|
1. **Архитектура**
|
|||
|
|
2. Базовые правила
|
|||
|
|
3. Документация из MAP.md
|
|||
|
|
4. Задача пользователя
|
|||
|
|
|
|||
|
|
Если задача противоречит архитектуре — задача должна быть переосмыслена, а не выполнена напрямую.
|