Ещё один архитектор правил для ИИ-агентов

Проблема, которую ощущают многие, но решают немногие.

Вы запускаете Zed, Kiro, Cline, Claude Code или Qwen. Описываете задачу. Агент создаёт код. И вот он перед вами… Иногда качественный. Иногда — беспорядочная смесь чужих стандартов, случайных шаблонов и игнорирование структуры вашего проекта.

Вы поправляете. Объясняете снова. Поправляете. Через час понимаете: вы тратите больше времени на управление агентом, чем на саму задачу.

Знакомо?

Почему агенты «тупят»

Дело не в модели. Claude, GPT, Gemini, Qwen — все они достаточно “умные”.
Проблема в другом: У агента нет контекста вашего проекта.

Он не знает ваш стек. Не знает ваши конвенции. Не знает, что вы используете Zustand, а не Redux. Что тесты лежат рядом с компонентами, а не в отдельной папке. Что API всегда возвращает { data, error, meta }. Что нельзя трогать папку legacy/ без согласования.

Каждый раз, открывая новый чат, вы начинаете с нуля. Или пишете длинный системный промпт, который всё равно забывается на середине сессии.

Что делает DEMIURGOS

DEMIURGOS — это ИИ-агент, который создаёт правила для других ИИ-агентов.

Вы рассказываете ему о своём проекте. Он задаёт точные вопросы. А затем генерирует набор файлов, которые ваш coding-агент читает автоматически при каждом запуске.

Результат: агент знает ваш проект с первого сообщения. Без повторных объяснений. Без «нет, я же говорил, у нас TypeScript strict mode». Без постоянных исправлений формата.

Как это работает: 3 слоя

┌─────────────────────────────────────┐
│  Ядро (.rules/)                     │  ← Мозг. Источник правды о проекте.
├─────────────────────────────────────┤
│  NATIVE ADAPTERS                    │  ← Проекции для каждого агента.
│  AGENTS.md │ .cursor/ │ CLAUDE.md   │
│  .github/copilot-instructions.md    │
├─────────────────────────────────────┤
│  EXTENSIONS                         │  ← Только если реально нужны.
│  subagents │ hooks │ MCP            │
└─────────────────────────────────────┘

Слой 1 — Ядро. Один набор правил. Единственный источник правды. Описывает: кто агент, что ему можно, чего нельзя, как выглядит хороший код в вашем стеке, какие паттерны использовать, какие — нет.

Слой 2 — Native Adapters. Тонкие проекции ядра для конкретных агентов. Cursor хочет .mdc файлы с YAML frontmatter? Получит. Claude Code читает CLAUDE.md? Сгенерирован. Copilot ждёт .github/copilot-instructions.md? Готово. При этом ни один факт не дублируется — адаптеры ссылаются на core.

Слой 3 — Extensions. Сложные штуки: мульти-агентные системы, event-driven хуки, MCP-интеграции. Создаются только когда доказана необходимость, а не «на будущее».

22+ инструмента. Один набор правил.

Вы создаёте правила один раз, и они работают везде:

┌─────────────────────────────────┬────────────────────────────────────────┐
│ Где                             │ Как читается                           │
├─────────────────────────────────┼────────────────────────────────────────┤
│ Cursor                          │ .cursor/rules/*.mdc
auto-attach по   │
│                                 │ glob                                   │
├─────────────────────────────────┼────────────────────────────────────────┤
│ Windsurf                        │ .windsurf/rules/*.md — Always On +     │
│                                 │ Model Decision                         │
├─────────────────────────────────┼────────────────────────────────────────┤
│ Claude Code                     │ CLAUDE.md + slash commands             │
├─────────────────────────────────┼────────────────────────────────────────┤
│ GitHub Copilot                  │ .github/copilot-instructions.md +      │
│                                 │ agents                                 │
├─────────────────────────────────┼────────────────────────────────────────┤
│ Kiro                            │ .kiro/steering/*.md — always/auto/     │
│                                 │ manual                                 │
├─────────────────────────────────┼────────────────────────────────────────┤
│ JetBrains / Junie               │ guidelines.md + ACP протокол           │
├─────────────────────────────────┼────────────────────────────────────────┤
│ Codex, Amp, Goose, Aider,       │ AGENTS.md — универсальный формат       │
│ Devin, Zed, Warp, Cline, Qwen...│                                        │
└─────────────────────────────────┴────────────────────────────────────────┘

Один разработчик использует Cursor. Другой — Claude Code. Тимлид — Copilot в VS Code.
Все работают по одним и тем же правилам.

Переехали с Cursor на Windsurf? Core остался. Пересобрали один адаптер. 5 минут.

Что внутри правил: пример для React + TypeScript проекта

Вот что DEMIURGOS создаст (упрощённо):

_index.md — мозг агента:

Ты Senior React Developer. Стек: React 19, TypeScript 5.6 strict, Zustand, TanStack Query, Tailwind 4. Пиши только функциональные компоненты. Ответ = полный файл с путём. Никогда не хардкодь API-ключи.

patterns.md — как писать код (с вариантами):

Вот 2 способа обработки загрузки данных. Вариант A — с TanStack Query (предпочтительный). Вариант B — с useEffect + Zustand (если запрос не кэшируется). Антипаттерн: fetch в useEffect без cleanup.

constraints.md — границы:

✅ Всегда: strict TypeScript, error boundaries, aria-атрибуты.
⚠️ Спроси сначала: новые зависимости, миграции БД, git push.
🔴 Никогда: any, inline styles, console.log в продакшне.

eval.md — самопроверка перед ответом:

🔴 Безопасность: секреты не зашиты в код? Синтаксически валиден? TypeScript без any?
🟡 Следует паттернам? Error handling? В scope задачи?

Агент читает это до того, как начинает работать. Не после. Не «если попросят». Автоматически.

5 причин использовать DEMIURGOS

1. Агент перестаёт «забывать»
   Правила хранятся в файлах проекта. Они в git. Они загружаются автоматически. Новый чат? Агент уже знает всё. Новый разработчик в команде? git pull — и его агент работает так же, как ваш.

2. Правила минимальны и точны
   DEMIURGOS использует расширение территории по трём осям:

   Размер знаний × количество агентов × уровень расширений.
   – Маленький проект получит 2-3 файла.
   – Масштабный репозиторий — 14+.

   Никогда больше, чем нужно.

Перед созданием каждого файла срабатывает оценка сложности:

Это решает реальную проблему?
Без этого агент станет работать хуже?
Можно решить одной строкой в существующем файле?
Если хоть один ответ «нет» — файл не создаётся.

Мы заложили в DEMIURGOS принципы, которые напрямую определяют качество:

• U-shaped attention — критичное в начало и конец файлов, справочное — в середину.
  Потому что LLM теряет внимание в середине длинного контекста.

• KV-cache awareness — статичная информация вверху, динамичная внизу.
  Это ускоряет ответы и снижает стоимость API.

• Structured variation — паттерны даются в 2-3 вариантах, а не как единственный «золотой стандарт». Агент не становится хрупким.

• DRY — каждый факт живёт в одном месте. Если правило обновилось — оно обновилось везде.

Встроенная проверка качества

Перед тем как отдать вам файлы, DEMIURGOS прогоняет 3-5 типовых сценариев:

• «Добавь новый API endpoint» — агент найдёт нужное правило? Формат ответа понятен?

• «Зарефакторь модуль» — permissions не заблокируют? Стайлгайд применится?

• «Почини баг в авторизации» — safety-правила сработают?

Если что-то не проходит — правила корректируются до того, как вы их получите.

Живой документ, а не артефакт

Правила — не «поставил и забыл». DEMIURGOS включает расписание обновлений:

┌─────────────────────────┬────────────────────────────────┐
│ Когда                   │ Что делать                     │
├─────────────────────────┼────────────────────────────────┤
│ Одна и та же ошибка     │ Добавь правило                 │
│ дважды                  │                                │
├─────────────────────────┼────────────────────────────────┤
│ Правило мешает          │ Удали или смягчи               │
├─────────────────────────┼────────────────────────────────┤
│ Агент игнорирует        │ Перемести выше, добавь пример  │
├─────────────────────────┼────────────────────────────────┤
│ Раз в месяц             │ Полный аудит                   │
└─────────────────────────┴────────────────────────────────┘

Для кого это всё

┌─────────────────────┬────────────────────────────────────────────────┐
│ Вы                  │ Что получите                                   │
├─────────────────────┼────────────────────────────────────────────────┤
│ Соло-разработчик    │ Агент, который помнит ваш стек и стиль между   │
│                     │ сессиями                                       │
├─────────────────────┼────────────────────────────────────────────────┤
│ Команда 2-5 человек │ Единые правила для всех, независимо от IDE     │
├─────────────────────┼────────────────────────────────────────────────┤
│ Команда 5+          │ Ядро + мульти-агентная система с ролями        │
├─────────────────────┼────────────────────────────────────────────────┤
│ Тимлид / техлид     │ Архитектурные решения, зашитые в поведение     │
│                     │ агента                                         │
├─────────────────────┼────────────────────────────────────────────────┤
│ Компания            │ Стандарты безопасности и качества, защита на   │
│                     │ уровне ИИ                                      │
└─────────────────────┴────────────────────────────────────────────────┘

Как начать

1. Скачайте DEMIURGOS в корень вашего проекта.

2. Начните диалог, фразой: запусти роль DEMIURGOS_NN.md

3. Ответьте на 5-15 вопросов (зависит от размера проекта).

4. Получите готовые файлы ролей и правил именно под ваш проект.

5. Ваш котик-агент стал умнее. Ура)

   Время: 15-30 минут на настройку. Экономия: часы каждую неделю.

Подытожим

Вам больше не нужно постоянно объяснять контекст. Достаточно описать его один раз. Агент автоматически будет следовать вашим правилам.

Это уже не просто файл AGENTS.md, а система правил и ролей, которая живёт в вашем репозитории и делает ИИ-агента по настоящему вашим напарником.