Imported from Axelaredz/Test_Rules_SourceCraft (AGENTS.md). Install upstream with npx skills add Axelaredz/Test_Rules_SourceCraft. Copyright stays with the author.

AGENTS.md – сводка правил, команд, навыков и MCP‑интеграций для Godot‑проекта

Commands (Slash‑команды)

Команда	Описание	Использование
`/godot‑scene‑review`	Анализирует текущую сцену, проверяет соответствие стилю киберпанк, изометрии, наличию обводки.	`/godot‑scene‑review [путь_к_сцене]`
`/generate‑outline`	Генерирует шейдер обводки и применяет его к выбранному мешу.	`/generate‑outline [--target <путь>] [--thickness <число>] [--color <цвет>]`
`/mcp‑status`	Показывает статус MCP‑серверов (gdai, context7), проверяет доступность.	`/mcp‑status [--server <имя>]`
`/export‑godot`	Запускает экспорт проекта через Godot CLI (требует наличия export_presets.cfg).	`/export‑godot [--preset <имя>] [--output <путь>] [--clean]`

Примечание: все команды определены в .codeassistant/commands/ и могут быть вызваны в режимах /code и /debug.

Rules (Правила)

Полный набор правил находится в директории .rules/ (17 файлов). Краткое содержание:

Файл	Назначение
`01‑identity.md`	Scope, роли, границы проекта.
`02‑versioning.md`	Версионирование, delta‑ledger, метрики.
`03‑constraints.md`	Ограничения C1–C22 (адаптированные для Godot).
`04‑guardrails.md`	Гарды безопасности G1–G17.
`05‑responses.md`	Контракт ответов и flow одобрения инструментов.
`06‑glossary.md`	Термины (ключ на английском, определение на русском).
`07‑task.md`	Цели и критерии приёмки (киберпанк, изометрия, обводка).
`08‑architecture.md`	Архитектурные решения, матрица режимов → инструменты.
`09‑patterns.md`	OK/FAIL примеры и 2–3 варианта паттернов.
`10‑security.md`	Матрица прав и шаблон `.codeassistantignore`.
`11‑integrations.md`	Документация MCP‑конфига и проектных команд.
`12‑onboarding.md`	Чек‑лист входа в контекст.
`13‑incidents.md`	Плейбук для инцидентов безопасности.
`14‑observability.md`	Логирование, метрики, точки отладки.
`15‑workflows.md`	CI/CD, мульти‑агентные сценарии, делегирование.
`16‑memory.md`	Append‑only лог сессий, политика decay.
`17‑evals.md`	Pass/fail тесты для каждого правила.

Источник истины: .rules/. Файлы в .codeassistant/rules/ (если есть) – краткие отражения.

Skills (Навыки)

Навыки расположены в .codeassistant/skills/. Каждый навык имеет SKILL.md с инструкциями.

Навык	Описание	Триггеры
`create‑billboard‑sprite`	Создаёт Sprite3D с настройками billboard и материалом в стиле киберпанк.	«создай billboard‑спрайт», «добавь 2D‑постер в 3D мир».
`setup‑isometric‑camera`	Настраивает Camera3D с изометрическим углом (45° по горизонтали, 30° по вертикали).	«настрой изометрическую камеру», «сделай камеру изометрической».
`apply‑cyberpunk‑material`	Применяет киберпанк‑материал (StandardMaterial3D с неоновой эмиссией) к MeshInstance3D.	«сделай материал в стиле киберпанк», «примени неоновый материал».

Использование: агент автоматически выбирает навык при совпадении триггера (правило C11).

MCP Integrations

Конфигурация MCP хранится в .codeassistant/mcp.json.

Серверы

gdai‑mcp‑godot (stdio, trust_level: internal)
- Инструменты: get_scene_tree, get_node_property, set_node_property, run_gdscript.
- Назначение: взаимодействие с Godot Editor.
context7 (streamable‑http, trust_level: untrusted)
- Инструменты: query‑docs.
- Назначение: доступ к документации Godot и примерам кода.

Переопределения

Если проект переопределяет глобальный MCP‑конфиг, причина документирована в 11‑integrations.md.

Security (Безопасность)

`.codeassistantignore`

Файл блокирует доступ к опасным или сгенерированным файлам:

.godot/, *.import, export_presets.cfg (кэш движка, возможные секреты).
*.env, *.pem, secrets/ (секреты).
build/, dist/, *.log (артефакты сборки).

Negation‑паттерны (с # WHY:):

!client/shaders/*.gdshader – шейдеры должны быть доступны для редактирования.
!client/scripts/*.gd – скрипты Godot нужны для генерации.
!client/scenes/*.tscn – сцены должны быть редактируемы.
!addons/gdai‑mcp‑plugin‑godot/ – плагин необходим для MCP‑интеграции.

Матрица разрешений

См. 10‑security.md. Деструктивные действия (удаление нод, перезапись шейдеров) требуют явного подтверждения (G6).

Budget (Бюджет контекста)

Текущий расчёт (правило C4):

Базовый: 19 000 токенов
Навыки (3 × 200): 600
MCP‑инструменты (2 сервера × 200): 400
Команды (4 × 150): 600
Игнор‑паттерны (10 × 50): 500
Итого: ≈21 100 токенов (16.5% от 128K) ✅

Лимит: ≤25% (32 000 токенов). При превышении – сжимать memory.md, отключать mode‑specific правила.

Onboarding (Вход в контекст)

Новый агент (или разработчик) должен выполнить чек‑лист из 12‑onboarding.md:

Изучить проект (project.godot, структуру).
Загрузить ключевые правила (identity, constraints, guardrails, task, security).
Проверить MCP‑интеграции (gdai‑mcp, context7).
Ознакомиться с навыками и командами.
Валидировать безопасность (.codeassistantignore, секреты).
Оценить бюджет контекста.

Тестирование

Запустить тесты правил: /trace evals (или прочитать 17‑evals.md). Каждое правило C1–C22 и G1–G17 имеет pass/fail тест.

Создано в соответствии с DEMIURGOS v36 SCAE, правило C7 (раздел Commands первым), матрица языка.

Test_Rules_SourceCraft

About