BLEND ARS

Как заставить ИИ-агента работать по вашим правилам

Alexander Reshetnyak·24 Mar at 9:36 pm

Разбираем DEMIURGOS

Как заставить ИИ-агента работать по вашим правилам, image #1

Представьте ситуацию.

Вы открываете Cursor, Claude Code или Cline, просите написать компонент — и получаете код на JavaScript вместо TypeScript.

С default-экспортом вместо именованного. С относительными путями вместо алиасов.

Вы поправляете, объясняете, через час агент снова забывает. Знакомо?

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

DEMIURGOS решает именно эту проблему.

Что это вообще такое

DEMIURGOS — это системная роль, которая превращает Claude, ChatGPT или любую другую модель в архитектора правил для вашего ИИ-агента. Вы описываете свой проект, а он создаёт набор файлов-инструкций, которые ваш кодинг-агент будет читать при каждом запуске.

Результат — папка .rules/ в корне проекта плюс файл AGENTS.md. Это ваш «устав» для агента: что за проект, какой стек технологий, что можно делать, что нельзя, как писать код, какие команды запускать.

Звучит просто, но дьявол в деталях. Если написать правила слишком коротко — агент их проигнорирует. Слишком длинно — забьёте контекстное окно и агент начнёт терять информацию из середины. DEMIURGOS знает эти нюансы и балансирует автоматически выбирая наиболее эффективный вариант.

Зачем это нужно, если я просто пишу код с ИИ

Три причины.

  • Первая — консистентность. Без правил каждый ответ агента — лотерея. С правилами агент знает ваш стек, ваши соглашения, ваши запреты. Он не предложит npm, если у вас pnpm. Не создаст файл в неправильной папке. Не удалит миграцию базы данных.
  • Вторая — экономия времени. Вы перестаёте повторять одно и то же в каждом чате. «Используй TypeScript», «не трогай .env», «тесты рядом с модулем» — всё это написано один раз и работает всегда.
  • Третья — переносимость. Правила в .rules/ — это обычные markdown-файлы. Они работают с Cursor, Claude Code, Cline, Kiro, Zed, OpenCode и ещё десятком инструментов. Переехали из одной IDE в другую — правила поехали с вами.

Как это работает

DEMIURGOS работает как консультант. Вы приходите с проектом, он задаёт вопросы, составляет план, вы подтверждаете, он генерирует файлы.

Весь процесс — всего пять шагов.

Фаза 1 — сбор информации. Что за продукт? Какой стек? Какая стадия? Какие инструменты? Вопросы идут по одному, после каждого — краткий вывод.

Фаза 2 — план. Показывает какие файлы создаст, какой размер, какие права доступа у агента. Вы смотрите, поправляете если нужно, говорите «ОК».

Фаза 3 — генерация. Создаёт все файлы правил, навыков и ролей проекта.

Фаза 4 — проверка. Сам прогоняет правила через тесты: нет ли конфликтов, не заблокировано ли что-то нужное, достаточно ли конкретные формулировки.

Фаза 5 — выдача. Итоговое дерево файлов, инструкции по установке, рекомендации по обновлению.

Как пользоваться в облачном чате (Claude, ChatGPT, Gemini)

Это самый простой способ начать. Не нужно ничего устанавливать.

Шаг 1 Откройте https://arena.ai (или https://chat.qwen.ai , https://chat.deepseek.com
или любой другой веб-чат).

Шаг 2
Создайте новый диалог. В первое сообщение вставьте весь текст роли DEMIURGOS - Это большой блок текста, и это нормально. Модель прочитает его как системную инструкцию.

Шаг 3
В следующем сообщении опишите свой проект. Вот несколько примеров для вдохновения:

- Делаю лендинг на Astro + SolidJS + UnoCSS.
Работаю один, проект с нуля. IDE: Zed.

- Пишу 2D-платформер на Godot 4 + GDScript. Инди-проект, один разработчик.
Использую Claude Code.

- Интернет-магазин на Next.js 15 + TypeScript + Prisma + PostgreSQL.
Команда 3 человека. Стадия: В разработке. Работаем в Cline.

- Телеграм-бот на Python + aiogram 3.
Один разработчик. Kiro.

- Мультиплеерная браузерная игра на Phaser 3 + Node.js + Socket.io.
Команда 2. Стадия: прототип. OpenCode.

Шаг 4
DEMIURGOS начнёт задавать уточняющие вопросы. Отвечайте по одному. Если чего-то не знаете — так и скажите, он предложит варианты.

Шаг 5
После сбора информации вы увидите план. Проверьте и напишите «ОК».

Шаг 6
Получите готовые файлы. Создайте папку .rules/ в корне проекта и скопируйте каждый файл туда. AGENTS.md — в корень проекта.

Как пользоваться в IDE

Здесь всё интереснее, потому что правила начинают работать автоматически.

🔹 Claude Code — терминальный агент от Anthropic

Допустим, вы делаете 2D-игру на Godot 4 и управляете проектом через Claude Code.

Claude Code читает файл CLAUDE.md из корня проекта. DEMIURGOS создаст его как симлинк на AGENTS.md — один файл, два имени. Также Claude Code читает папку .rules/ напрямую.

После генерации ваш проект выглядит так:

my-godot-game/
  .rules/
    _index.md
    _meta.md
    core/
      architecture.md
      constraints.md
    context/
      task.md
    generation/
      patterns.md
  AGENTS.md
  CLAUDE.md -> AGENTS.md  # симлинк

Теперь когда вы пишете в терминале claude «добавь систему инвентаря», агент уже знает: проект на GDScript, ноды именуются в PascalCase, сигналы — в snake_case, ресурсы лежат в res://assets/, а сцены — в res://scenes/.

Он не предложит паттерны из Unity и не начнёт писать на C#.

Если у вас размерность M или больше, DEMIURGOS также создаст слэш-команды в .claude/commands/. Например, /debug для диагностики правил прямо в терминале.

Бонус: Claude Code поддерживает Agent Skills. Например, skill для экспорта билда под разные платформы. Агент видит короткое описание и загружает полные инструкции только когда вы просите собрать билд.

🔹 Cline — агент внутри расширения VS Code

Вы строите интернет-магазин на Next.js + Stripe.
Cline читает AGENTS.md и папку .rules/ из коробки.

После генерации:

my-shop/
  .rules/
    _index.md
    _meta.md
    core/
      architecture.md
      constraints.md
    context/
      task.md
    generation/
      output.md
      patterns.md
    quality/
      eval.md
  AGENTS.md

Открываете VS Code, запускаете Cline, просите «добавь страницу оформления заказа» — и агент уже знает: App Router, Server Components по умолчанию, стили через UnoCSS, оплата через Stripe, тестовые ключи в .env.local. Он не будет ставить styled-components и не полезет в продакшн-ключи.

Всё это описано в .rules/core/constraints.md и .rules/_index.md — Cline читает их автоматически при каждом запросе.

🔹 Kiro — IDE от Amazon с хуками на события

Вы делаете SPA на Vue 3 + Nuxt 3 + Supabase.
Kiro читает свои правила из папки .kiro/steering/.

DEMIURGOS создаст адаптер в формате Kiro — markdown с YAML frontmatter:

my-nuxt-app/
  .rules/                       # Source of Truth
    _index.md
    core/
      constraints.md
    ...
  .kiro/
    steering/
      core.md                   # inclusion: always
      patterns.md               # inclusion: auto
  AGENTS.md

В core.md — ваш стек, права, стиль. В patterns.md — паттерны Nuxt: composables вместо mixins, useFetch вместо axios, серверные роуты в server/api/. Файл core.md загружается всегда, patterns.md — когда Kiro считает это релевантным.

Отдельная фишка Kiro — хуки (.kiro/hooks/). Это событийная автоматизация: например, при создании нового компонента автоматически запускается проверка, что он следует вашим конвенциям. DEMIURGOS может создать такие хуки если у вас размерность L+.

🔹 Zed — быстрый редактор на RUST

Вы пишете лендинг на Astro + SolidJS + UnoCSS. Zed читает AGENTS.md из корня проекта.

my-landing/
  .rules/
    _index.md
    _meta.md
    core/
      constraints.md
    context/
      task.md
  AGENTS.md

Для маленького проекта (размерность S) это всё что нужно. Три файла правил + AGENTS.md. Агент в Zed знает: Astro 4, острова на React, стили через Tailwind, деплой на Vercel, изображения через astro:assets. Не предложит webpack, не создаст pages/ вместо src/pages/.

🔹 OpenCode — терминальный агент для тех, кто любит консоль

Вы строите мультиплеерную браузерную игру: Phaser 3 на клиенте, Node.js + Socket.io на сервере, моно-репозиторий на Turborepo.

OpenCode читает AGENTS.md и поддерживает собственные конфиги агентов:

my-game/
  .rules/                          # Source of Truth
    _index.md
    core/
      architecture.md
      constraints.md
    context/
      task.md
    generation/
      patterns.md
  .opencode/
    agents/
      build.md                     # полный доступ
      plan.md                      # только чтение
  AGENTS.md                        # корневой, общие команды
  packages/
    client/
      AGENTS.md                    # клиент: Phaser 3, сцены, ассеты
    server/
      AGENTS.md                    # сервер: Socket.io, комнаты, ECS

Обратите внимание на монорепо-структуру. Корневой AGENTS.md содержит общие команды (turbo build, turbo test) и таблицу маршрутизации. Вложенные AGENTS.md — специфику каждого пакета. Агент OpenCode видит ближайший файл и использует его в приоритете.

Что внутри сгенерированных файлов

DEMIURGOS подбирает количество файлов по размеру проекта. Вот полная структура для размерности XL (enterprise) с отметками, что создаётся на каждом уровне:

.rules/
│
├── _index.md ··················· S M L XL  идентификация, права, иерархия
├── _meta.md ···················· S M L XL  версия, размер, метрики, журнал
│
├── core/
│   ├── constraints.md ·········· S M L XL  стиль кода, ограничения
│   ├── architecture.md ·········   M L XL  структура проекта, слои, решения
│   ├── styleguide.md ··········      L XL  расширенное руководство по стилю
│   ├── safety.md ··············      L XL  секреты, ключи, .env-политика
│   └── permissions.md ·········      L XL  подробные права (отдельно от _index)
│
├── context/
│   ├── task.md ················· S M L XL  текущая задача
│   ├── memory.md ··············      L XL  решения, ошибки, workarounds
│   ├── progress.md ············      L XL  прогресс, блокеры, handoff
│   ├── roles.md ···············      L XL  роли агентов (при 2+ агентах)
│   └── glossary.md ············    ? ? ?   глоссарий (опционально, по запросу)
│
├── generation/
│   ├── output.md ··············   M L XL  формат ответа
│   ├── patterns.md ············   M L XL  паттерны + антипаттерны
│   └── workflows.md ··········      L XL  процессы: read → plan → code → verify
│
└── quality/
    ├── eval.md ················   M L XL  критерии оценки, чеклисты
    ├── fallback.md ············     L XL  запасные стратегии
    ├── references.md ··········     L XL  справочные материалы
    └── debug.md ···············  ? ? ? ?  протокол /debug (опционально)

Вне .rules/:
AGENTS.md ······················ S M L XL  центральный файл (≤ 150 строк)
+ адаптер IDE ·················· S M L XL  один или несколько

Сноски:
S M L XL = создаётся для этой размерности
?        = опционально, по запросу или при ≥ 5 rules-файлов

Несколько ориентиров:

Размерность S  →  2-3 файла ядра + AGENTS.md + 1 адаптер
Лендинг на Astro. Телеграм-бот. Скрипт автоматизации.

Размерность M  →  7-9 файлов ядра + AGENTS.md + адаптеры
Интернет-магазин на Next.js. 2D-игра на Godot. SPA на Vue + Nuxt.

Размерность L  →  11-14 файлов ядра + AGENTS.md + адаптеры + skills
Продакшн-платформа. Мультиплеерная игра. Маркетплейс.

Размерность XL →  14+ файлов ядра + всё остальное
Enterprise. Монорепо с десятками пакетов.
Важный принцип: DEMIURGOS всегда стремится к минимуму. Он не создаст файл «на будущее». Перед каждым файлом задаёт себе три вопроса: решает ли это реальную проблему, станет ли без этого хуже, можно ли обойтись одной строкой в существующем файле. Если хотя бы один ответ отрицательный — файл не создаётся.

Фишки, которые стоит знать

📐 Контекстный бюджет. DEMIURGOS рассчитывает, чтобы все правила занимали не больше 30% контекстного окна вашей модели. Если модель с окном 32K токенов — бюджет правил не больше 10K. Это гарантирует, что у агента останется место для вашего кода и диалога.

🔄 Откат. Все правила живут в git. Если после обновления правил агент стал работать хуже — один git checkout и вы вернулись к рабочей версии. Команда отката добавляется прямо в AGENTS.md.

⚡ Quick Mode. Если вам нужно просто добавить одно правило, не обязательно проходить все пять фаз. Скажите что хотите изменить — DEMIURGOS покажет diff и проверит на конфликты.

📊 Трекинг эффективности. В файле _meta.md есть таблица, куда вы записываете: агент справился или ошибся, какое правило сработало или нет. Когда процент ошибок превышает 30% — пора обновлять правила.

🔀 Миграция. Если у вас уже есть .cursorrules или copilot-instructions.md — DEMIURGOS импортирует их и реструктурирует в .rules/. Не придётся начинать с нуля.

🧩 Agent Skills. Модульные инструкции, которые подгружаются по запросу. Агент видит краткое описание (около 100 токенов) и загружает полную инструкцию только когда задача релевантная. Например, skill для деплоя, для миграции БД, для настройки CI. Экономит контекст и не отвлекает агента лишним.

Живой пример: от нуля до рабочих правил

Допустим, вы делаете браузерную RPG на Phaser 3 + TypeScript, сервер на Fastify + Drizzle ORM, работаете в Claude Code один. Вот как выглядит диалог:

Вы: [вставляете роль DEMIURGOS]
    Делаю браузерную RPG. Phaser 3 + TypeScript клиент,
    Fastify + Drizzle ORM + PostgreSQL сервер. Один разработчик,
    пишу с нуля. Claude Code.

DEMIURGOS: ✓ Продукт: браузерная RPG
✓ Цель: создать с нуля
✓ Стек: Phaser 3, TypeScript, Fastify, Drizzle ORM, PostgreSQL
✓ Стадия: с нуля
Mono или poly-repo?

Вы: монорепо, два пакета — client и server

DEMIURGOS: ✓ Репо: монорепо, 2 пакета (client, server)
Знания=M × Инструменты=1 × Расширения=0
[показывает план: 8 файлов ядра + AGENTS.md корневой
+ 2 вложенных AGENTS.md + CLAUDE.md симлинк]
Всё верно? → OK

Вы: ОК

DEMIURGOS: [генерирует все файлы, проводит проверку]
5/5 pass (типовые) + 2/2 pass (adversarial) → ✅

Теперь сказав claude «добавь систему боя» выдаёт код на TypeScript с правильной структурой сцен Phaser, использует Drizzle для сохранения прогресса, не трогает .env, и не ставит пакеты без спроса.

Частые вопросы новичков

«Это работает только с Claude?»

Нет. Роль DEMIURGOS можно использовать с любой моделью: Claude, Qwen, DeepSeek, GPT, Gemini, Llama. А сгенерированные правила работают с любым кодинг-агентом.

«Я пишу на Python / GDScript / Rust / PHP — это подходит?»

Да. DEMIURGOS работает с любым набором технологий. Все примеры в правилах будут из вашего стека — это одно из абсолютных ограничений роли.

«Что если я работаю один над маленьким проектом?»

Тогда вы получите размерность S — минимальный набор из 2-3 файлов. Это буквально: кто агент, что можно и нельзя, текущая задача. Пять минут настройки, потом месяцы пользы.

«Можно ли обновлять правила потом?»

Обязательно. Правила — живой документ. Агент ошибся дважды одинаково — добавь правило. Правило мешает — смягчи или удали. Агент игнорирует правило — переформулируй или перенеси выше по файлу. DEMIURGOS поддерживает режим обновления: показываете текущие правила, он проводит аудит и предлагает точечные изменения.

«Зачем AGENTS.md, если есть .rules/?»

AGENTS.md — это краткая выжимка для агента: команды, стиль, границы. Его читают почти все инструменты из коробки. А .rules/ — подробный источник истины. AGENTS.md ссылается на .rules/ для деталей.
Это как README для людей и AGENTS.md для агентов.

«Я уже настроил .cursorrules / copilot-instructions — придётся начинать заново?»

Нет. Скажите DEMIURGOS что у вас есть старые конфиги — он импортирует и реструктурирует их в .rules/. Фича «Миграция» специально для этого.

С чего начать прямо сейчас

  1. Скопируйте текст роли DEMIURGOS или сохраните как файл.
  1. Откройте любой ИИ-чат, отправьте первым сообщением в новом чате.
    Или если работаете в IDE, сохраните в корень проекта и скажите активировать роль DEMIURGOS.md
  1. Расскажите о своём проекте.
  1. Ответьте на 5-9 вопросов.
  1. Подтвердите план.
  1. Получите систему правил для вашего проекта.
    (всё, файл DEMIURGOS можно убрать из проекта)
  2. Начните новую сессию и скажите агенту изучить AGENTS.md

Весь процесс занимает 5 минут. После этого каждый диалог с агентом становится намного продуктивнее, потому что он уже знает ваш проект, ваши правила и ваши стандарты 😈

106 views·2 shares
106 views