# csharp

Правило csharp задаёт стандарты разработки на C# 14 и .NET 10: структуру солюшена, оформление csproj, порядок членов класса и XML-документацию.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1627 у репозитория
- Автор: microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/csharp/csharp.instructions.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/microsoft-csharp

## Что делает

Правило внедряет соглашения для проектов на платформе .NET 10. Оно определяет базовую структуру репозитория: файл `.sln` и `Dockerfile` в корне, исходники в папке `src/`, а тестовые сборки с суффиксом `*.Tests`. Для небольших проектов до 16 файлов рекомендуется плоская структура. Когда проект разрастается, код группируется по слоям предметной области: `Domain`, `Application`, `Infrastructure`, `Services`, `Repositories` и `Controllers`.

В конфигурации `csproj` выставляется целевой фреймворк `net10.0` вместе с включёнными `ImplicitUsings` и `Nullable`. Параметр `LangVersion` явно опускается, потому что компилятор выбирает C# 14 автоматически. Инструкция запрещает указывать `LangVersion=latest`.

Код форматируется по чётким правилам: первичному конструктору отдаётся приоритет, если нет сложной валидации. Члены класса выстраиваются в строгом порядке: константы, поля, конструкторы, свойства и методы. Публичные и защищённые методы обязательно снабжаются полными XML-комментариями. Без сборщика .NET 10 проекты рискуют получить синтаксические ошибки из-за выражений коллекций и свежих конструкций языка.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/csharp.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/csharp.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/csharp.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/csharp.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/csharp.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/csharp/csharp.instructions.md

## Когда брать
- настроить типовую структуру папок и тестовых проектов для .NET 10
- выстроить предсказуемый порядок полей, методов и модификаторов в классах
- оформить XML-документацию для публичных методов и параметров
- сконфигурировать csproj без лишних переопределений версии компилятора

## Примеры запросов агенту
- Создай класс сервиса пользователей с первичным конструктором и полной XML-документацией.
- Добавь проект юнит-тестов xUnit в солюшен через dotnet CLI.
- Оформи файл Directory.Build.props с общими настройками сборки для всех проектов.

## Похожие
- [csharp-developer](https://affpapa.org/nevibecode/skills/csharp-developer.md) — скилл · 5200 установок
- [modern-csharp](https://affpapa.org/nevibecode/skills/modern-csharp.md) — скилл · 4100 установок
- [csharp-refactoring](https://affpapa.org/nevibecode/skills/csharp-refactoring.md) — скилл · 3000 установок
- [modern-csharp-coding-standards](https://affpapa.org/nevibecode/skills/modern-csharp-coding-standards.md) — скилл · 2300 установок
- [csharp-expert](https://affpapa.org/nevibecode/skills/csharp-expert.md) — скилл · 2200 установок
- [csharp-concurrency-patterns](https://affpapa.org/nevibecode/skills/csharp-concurrency-patterns.md) — скилл · 1600 установок

## Другие версии с тем же именем
- [csharp · github](https://affpapa.org/nevibecode/rules/csharp.md) — ★ 41430 у репозитория

Из того же набора: [microsoft/hve-core](https://affpapa.org/nevibecode/by/microsoft/hve-core.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
