sync
This commit is contained in:
@@ -1,103 +1,45 @@
|
||||
---
|
||||
title: Гид для агента
|
||||
description: Что AI-агент обязан прочитать перед началом работы, а что — по задаче.
|
||||
---
|
||||
# DEVELOP.md
|
||||
|
||||
# Обязательное чтение перед началом работы
|
||||
Ты senior fullstack JavaScript/TypeScript-разработчик.
|
||||
|
||||
Этот документ определяет **строгий порядок действий агента перед выполнением любых задач**.
|
||||
## Направления разработки
|
||||
|
||||
## Общее правило
|
||||
### Frontend
|
||||
|
||||
Перед началом работы над **любой задачей** агент **обязан ознакомиться с базовой документацией проекта**.
|
||||
Для frontend-задач NextJS Style Guide является обязательным источником решений. Используй только:
|
||||
|
||||
Нарушение этого порядка считается ошибкой.
|
||||
https://nextjs-style-guide.gromlab.ru/llms.txt
|
||||
|
||||
---
|
||||
`llms.txt` — карта документации. Агент сам выбирает нужные разделы под текущую задачу.
|
||||
|
||||
## Порядок обязательного чтения
|
||||
Baseline = архитектура SLM + базовые правила.
|
||||
|
||||
Агент должен читать документацию **строго в следующем порядке**:
|
||||
Перед каждой frontend-задачей или новой сессией строго выполни порядок:
|
||||
|
||||
### 1. Архитектура (КРИТИЧЕСКИ ВАЖНО)
|
||||
1. Открой `llms.txt`.
|
||||
2. Найди и прочитай архитектуру SLM.
|
||||
3. Найди и прочитай базовые правила.
|
||||
4. Только потом смотри релевантный код проекта, если задача требует анализа или изменения кода.
|
||||
5. Вернись к `llms.txt` и выбери дополнительные разделы под конкретную задачу.
|
||||
6. Только после этого реализовывай.
|
||||
|
||||
* [Архитектура: Обзор](./basics/architecture/index.md)
|
||||
* [Архитектура: Слои](./basics/architecture/layers.md)
|
||||
* [Архитектура: Модули](./basics/architecture/modules.md)
|
||||
* [Архитектура: Сегменты](./basics/architecture/segments.md)
|
||||
Если контекст был сжат, сессия продолжена после паузы или нет уверенности, что архитектура SLM и базовые правила есть в текущем контексте, считай baseline утраченным и прочитай его заново.
|
||||
|
||||
**Архитектура — это самое важное в проекте.**
|
||||
Во время frontend-задачи возвращайся к `llms.txt`, если задача затрагивает новый аспект: архитектуру, слой, модуль, компонент, стили, данные, API, роутинг, структуру файлов, публичный API или зависимости.
|
||||
|
||||
Агент обязан:
|
||||
Не заменяй style guide догадками, привычными паттернами или общими практиками.
|
||||
|
||||
* строго понимать архитектурный подход (SLM)
|
||||
* соблюдать архитектуру **на 100% без отклонений**
|
||||
* не предлагать решений, нарушающих архитектурные принципы
|
||||
* не упрощать архитектуру даже ради скорости выполнения задачи
|
||||
Если в style guide не найдено правило или пример для значимого frontend-решения:
|
||||
|
||||
Любое нарушение архитектуры недопустимо.
|
||||
1. Остановись до реализации.
|
||||
2. Сообщи пользователю, что правило не найдено в style guide.
|
||||
3. Кратко опиши, какой вопрос не покрыт.
|
||||
4. Предложи варианты реализации или спроси, как действовать дальше.
|
||||
5. Дождись подтверждения пользователя.
|
||||
6. Только после этого реализовывай.
|
||||
|
||||
---
|
||||
Если style guide конфликтует с фактическим кодом проекта, не ломай проект молча. Сообщи о конфликте и предложи безопасный вариант.
|
||||
|
||||
### 2. Базовые правила
|
||||
### Backend
|
||||
|
||||
После архитектуры необходимо изучить:
|
||||
|
||||
* [Технологии и библиотеки](./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. Задача пользователя
|
||||
|
||||
Если задача противоречит архитектуре — задача должна быть переосмыслена, а не выполнена напрямую.
|
||||
Соблюдай стиль кода существующего приложения.
|
||||
|
||||
Reference in New Issue
Block a user