Добавлены AGENTS.md с правилами на русском, обновлен README

This commit is contained in:
2026-04-12 22:27:25 +03:00
parent 362fde4d1b
commit 4be7359bff
2 changed files with 221 additions and 19 deletions

105
AGENTS.md
View File

@@ -1,28 +1,95 @@
# AGENTS.md
## Execution Model (MUST)
- Read this file first; treat as system-level constraints.
- Reusable general rules (MUST read and apply): [AGENT.common.md](AGENT.common.md)
- Reusable structured interaction rules: [AGENT.interaction.md](AGENT.interaction.md)
- Priority:
1. User instructions
2. AGENTS.md
3. Applicable referenced reusable rule files
4. Existing code/style
5. Best practices
- Prefer minimal, non-breaking changes.
- Do not introduce unnecessary abstractions.
## Описание проекта: LazyBear MCP
### Назначение
.NET 10 сервер Model Context Protocol (MCP) для интеграции торговых AI-инструментов.
### Структура проекта
```
LazyBearWorks/
├── LazyBear.MCP/
├── Program.cs # Главный файл с хостингом MCP сервера
│ └── Services/
│ └── TradingTools.cs # Реализация инструментов MCP
├── AGENTS.md # Этот файл, правила для агентов
└── README.md # Документация для пользователей
```
### Основные концепты
**Масштабирование (Hosting):**
- ASP.NET Core веб-приложение (.NET 10.0)
- HTTP transport для удалённой MCP коммуникации
- Авто-обнаружение `[McpServerToolType]` и `[McpServerResourceType]`
**Технологический стек:**
- **Runtime:** .NET 10.0
- **Framework:** ASP.NET Core
- **SDK:** ModelContextProtocol.AspNetCore 1.2.0
- **AI:** Microsoft.Extensions.AI
**Особенности MCP:**
- **Инструменты (Tools):** Статические классы с атрибутами `[McpServerTool]`
- **Ресурсы (Resources):** Шаблоны ресурсов с атрибутами `[McpServerResource]`
- **Промпты (Prompts):** Параметризованные промпты (в разработке)
### Запуск
**Запустить сервер:**
```bash
dotnet run --project LazyBear.MCP
```
**Собрать проект:**
```bash
dotnet build
```
### Пакеты
- `ModelContextProtocol` - основной SDK
- `ModelContextProtocol.AspNetCore` - интеграция с ASP.NET Core
- `Microsoft.Extensions.AI` - абстракции AI
---
## Guardrails (MUST)
## Правила для машин (MACHINE-FIRST)
Before commit:
- no secrets or sensitive data
- build passes locally
- tests pass
### Обязательные правила (MUST)
**Перед модификацией:**
1. Прочитать существующий код
2. Сохранять текущий стиль и паттерны
3. Минимизировать изменения
4. Не добавлять секреты в код
**Перед коммитом:**
1. Сборка `dotnet build` должна проходить локально
2. Изменения не должны ломать MCP протокол
3. Код в Git только после проверки сборки
4. Комментарии, документация и коммиты — только на русском
### Build & Deploy
- Локальная сборка обязана проходить
- Без ломающих изменений в MCP
- Коммиты с проверкой сборки
---
## Rules Maintenance (MUST)
- Keep updates minimal: merge redundant points, preserve intent.
## Модель выполнения (MUST)
**Приоритеты инструкции:**
1. Инструкции пользователя
2. AGENTS.md (этот файл)
3. Упомянутые общие правила
4. Существующий стиль кода
5. Лучшие практики
**Переиспользуемые правила:**
- [AGENT.common.md](AGENT.common.md) - общие правила
- [AGENT.interaction.md](AGENT.interaction.md) - правила взаимодействия
### Поддержание правил (MUST)
- Минимальные обновления
- Объединение дубликатов
- Сохранение смысла