gromov/image-platform
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8094535747e5301c0b7bc76ad7367a01d7f31e78
image-platform/ai/nextjs-style-guide/DEVELOP.md
S.Gromov 2c88cc3eca chore: добавить frontend правила и шаблоны SLM 
- добавлены frontend инструкции AGENTS и локальный style guide
- актуализированы SLM templates под Vite React и слой infra
- добавлены шаблоны component, infra и factory-based business
- нормализованы примеры документации под alias infra
2026-05-05 14:05:43 +03:00

4.1 KiB
Raw Blame History

title, description
title description
Гид для агента Что AI-агент обязан прочитать перед началом работы, а что — по задаче.

Обязательное чтение перед началом работы

Этот документ определяет строгий порядок действий агента перед выполнением любых задач.

Общее правило

Перед началом работы над любой задачей агент обязан ознакомиться с базовой документацией проекта.

Нарушение этого порядка считается ошибкой.

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

Агент должен читать документацию строго в следующем порядке:

1. Архитектура (КРИТИЧЕСКИ ВАЖНО)

Архитектура — это самое важное в проекте.

Агент обязан:

  • строго понимать архитектурный подход (SLM)
  • соблюдать архитектуру на 100% без отклонений
  • не предлагать решений, нарушающих архитектурные принципы
  • не упрощать архитектуру даже ради скорости выполнения задачи

Любое нарушение архитектуры недопустимо.

2. Базовые правила

После архитектуры необходимо изучить:

Агент обязан применять эти правила во всех решениях.

Использование карты документации

Для поиска дополнительных сведений агент должен использовать:

MAP.md содержит ссылки на все прикладные и вспомогательные разделы.

Агент может:

  • переходить к нужным разделам через MAP.md
  • уточнять детали реализации
  • искать примеры и частные случаи

Запрещено

Агенту запрещено:

  • начинать выполнение задачи без изучения архитектуры
  • игнорировать базовые правила
  • принимать решения, противоречащие архитектуре
  • придумывать собственные подходы, если они не описаны в документации

Ожидаемое поведение агента

Перед выполнением задачи агент должен:

  1. Изучить архитектуру
  2. Изучить базовые правила
  3. При необходимости открыть MAP.md и найти релевантные разделы
  4. Только после этого приступать к решению задачи

Приоритеты

При принятии решений агент должен руководствоваться следующим приоритетом:

  1. Архитектура
  2. Базовые правила
  3. Документация из MAP.md
  4. Задача пользователя

Если задача противоречит архитектуре — задача должна быть переосмыслена, а не выполнена напрямую.